Integrazione WhatsApp tramite Bird

Questo articolo spiega come configurare Bird per WhatsApp e integrarlo con il Contact Center.

Configurazione dell’account Bird e del canale WhatsApp

Per configurare un account Bird:

1. Creare un account Bird.
2. Inserire l’email aziendale ed eseguire l’accesso.
3. Aprire le impostazioni (Settings).
4. Aprire la scheda Organization (organizzazione) e creare una nuova organizzazione, se non ne esiste già una.
5. Aprire la scheda Workspace e selezionare Create new workspace (crea nuovo workspace).

Configurare quindi un canale WhatsApp.

Per configurare un canale WhatsApp:

1. Aprire Channel Management (gestione dei canali).

2. Aprire WhatsApp Management.

   

3. Compare una pagina con le istruzioni per l’installazione di WhatsApp. Leggere le istruzioni, quindi selezionare Install WhatsApp e seguire le indicazioni.

   

Configurazione delle impostazioni di sicurezza richieste in Bird

Prima di integrare il Contact Center con Bird, occorre creare una policy di accesso, associarla a un ruolo e creare una chiave di accesso associata anch’essa a un ruolo. Le sezioni seguenti descrivono ogni passaggio:

• creazione di una policy di accesso;
• creazione di un ruolo di accesso;
• creazione di una chiave di accesso.

Creazione di una policy di accesso

Una policy di accesso (access policy) è un insieme di regole che controlla l’accesso a una o più risorse.

Per l’integrazione con Bird, garantire l’accesso alle risorse seguenti:

Effect	Action	Resource
Allow	create	/workspaces/*/channels/*/messages
	create	/workspaces/*/verify
	create	/organizations/{OrganizationID}/workspaces/*/webhook-subscriptions
Allow	view	/workspaces/*/channels/*
	view	/organizations/{OrganizationID}/workspaces/*/webhook-subscriptions
Allow	delete	/organizations/{OrganizationID}/workspaces/*/webhook-subscriptions/*

OrganizationID è l’identificativo della propria organizzazione ed è necessario per creare la policy di accesso.

Per trovare l’OrganizationID:

1. Accedere al proprio account Bird.

2. Aprire le impostazioni dell’organizzazione. Nella pagina Settings, individuare OrganizationID nella colonna Resource’s Definition.

   

Nota

Salvare l’OrganizationID in un posto dove sia facile ritrovarlo in seguito.

Una volta ottenuto l’OrganizationID, creare la policy di accesso.

Per creare una policy di accesso:

1. Accedere al proprio account Bird (se non è già stato fatto).

2. Aprire Access Policies.

3. Nella pagina Access Policies, selezionare Create Custom Policy (crea policy personalizzata).

   

4. Nella pagina Create Custom Policy, inserire un nome (Policy name) e una descrizione (Policy description) per la policy.

   

5. Aggiungere le definizioni della policy in base alla tabella delle risorse riportata sopra. Ad esempio:

   

   Nota

   • Per le risorse con lo stesso effetto e la stessa azione (ad esempio le prime tre righe della tabella), selezionare Add Resource per aggiungere un’altra casella Resource.

     

   • Per aggiungere una nuova definizione (ad esempio passando dalla terza alla quarta riga), selezionare Add Definition.

     

6. Creare le definizioni per ciascuna risorsa richiesta. Al termine, selezionare Save. Bird convalida la policy e segnala eventuali errori.

Creazione di un ruolo di accesso

Un ruolo di accesso (access role) raggruppa una o più policy di accesso. I ruoli possono essere assegnati alle chiavi di accesso. I ruoli si gestiscono in Security > Access Roles.

Per creare un ruolo di accesso:

1. Accedere al proprio account Bird.

2. Aprire la pagina Access Roles e selezionare Create Role (crea ruolo).

   

3. Inserire un nome (Role name) e una descrizione (Description) per il ruolo.

   

4. Associare la policy di accesso creata in precedenza (vedere Creazione di una policy di accesso): in Other permissions, individuare la policy e selezionarne la casella. Nell’esempio seguente è selezionata la policy ApiPolicy.

   

5. Selezionare Create role per terminare.

Creazione di una chiave di accesso

Bird usa le chiavi di accesso (access key) per autenticare le richieste HTTP. Le chiavi sono associate ai ruoli per limitare ciò a cui possono accedere. Assegnare solo i ruoli minimi necessari: i permessi elencati in Creazione di una policy di accesso coprono il minimo indispensabile.

Per creare una chiave di accesso:

1. Accedere al proprio account Bird.

2. Aprire la pagina Access Keys e selezionare Add new access key (aggiungi nuova chiave di accesso).

   

3. Nella pagina Add new access key, inserire un nome (Key name) e una descrizione (Key description) per la chiave. Selezionare Add new role e scegliere il ruolo creato in Creazione di un ruolo di accesso.

   

4. Selezionare Save. L’applicazione mostra il token della nuova chiave di accesso.

Importante

Il token della chiave di accesso viene mostrato una sola volta. Copiarlo e conservarlo in modo sicuro per poterlo recuperare in seguito.

Configurazione dell’integrazione Bird nel portale di amministrazione del Contact Center

Dopo aver configurato l’account Bird e il numero WhatsApp e aver impostato le opzioni di sicurezza richieste, configurare l’integrazione Bird nel portale di amministrazione del Contact Center.

Informazioni da recuperare in Bird

• Phone Number e Channel ID (numero di telefono e identificativo del canale): aprire la pagina All channels nel proprio account Bird.

  

• OrganizationID: seguire le istruzioni all’inizio della sezione Creazione di una policy di accesso per ottenerlo.

  

• Workspace ID (identificativo del workspace):

  1. Accedere al proprio account Bird.

  2. Aprire Workspaces e selezionare Create new workspace.

     

     La pagina Workspaces si espande e mostra il nome del nuovo workspace e la data di creazione.

     

  3. Selezionare il nome del workspace per aprirlo. Nella pagina Workspace, copiare il Workspace ID e conservarlo per un uso successivo.

     

• Access Key Token: recuperare il token salvato al termine della procedura Creazione di una chiave di accesso.

Configurazione dell’integrazione nel portale di amministrazione del Contact Center

1. Accedere al portale di amministrazione del Contact Center.

2. Aprire Integrations > SMS and Messaging > Bird. Si apre la pagina dell’integrazione Bird.

   

3. Inserire le informazioni richieste seguendo le indicazioni precedenti.

4. Alert when Access Key or permissions are invalid (avviso se la chiave di accesso o i permessi non sono validi): attivare questa opzione per ricevere un’email se la chiave di accesso (Access Key) o i relativi permessi non sono validi. Nel campo Email, inserire l’indirizzo a cui inviare le notifiche.

Importante

A causa di limitazioni del sistema, al momento del salvataggio l’interfaccia non verifica la validità della chiave di accesso (Access Key) né dei relativi permessi. Se si inserisce una chiave errata, le impostazioni vengono salvate, ma l’integrazione non funziona e i messaggi WhatsApp non vengono ricevuti. Attivando questa casella si riceve un avviso quando la chiave di accesso o i permessi non sono validi.