Connettori di canale
La gestione dei connettori richiede il permesso di amministrazione.
Prerequisiti
- Permesso di amministrazione (sezione Campagne outbound: panoramica).
- Per WhatsApp, l'integrazione del canale già configurata se si desidera ereditarne i parametri (vedi Canale WhatsApp).
Che cos'è un connettore
Un connettore lega, per il tenant, un canale delle campagne outbound a un provider concreto di invio.
Un connettore non può essere modificato dopo la creazione: sono disponibili solo le azioni di creazione, visualizzazione ed eliminazione. Per cambiare provider, credenziali o altri parametri è necessario creare un nuovo connettore.
Connettore WhatsApp
Il connettore WhatsApp può usare:
- il gateway gestito, con URL del gateway, ID del numero di telefono e WABA ID, oppure il pulsante "Eredita da integrazione" per riutilizzare i parametri già impostati nell'integrazione WhatsApp del canale di chat dal vivo (vedi Canale WhatsApp);
- un endpoint tenant-agent personalizzato.
Connettore SMS
Il connettore SMS può usare il gateway Aruba gestito, impostando:
- il mittente (alias), alfanumerico e di massimo 11 caratteri, che deve essere registrato/autorizzato sull'account Aruba;
- opzionalmente, credenziali Aruba proprie del cliente, per usare un account separato da quello globale condiviso.
In alternativa è possibile configurare un connettore Custom / API.
Connettore Email
Per Email è disponibile solo il connettore Custom / API: l'invio nativo tramite l'account SendGrid dell'istanza non richiede un connettore per tenant.
Connettore Custom API
Il connettore Custom/API permette di collegare un endpoint HTTP generico del cliente, impostando URL, tipo di autenticazione (nessuna, header, basic o bearer) e il template della richiesta da inviare al provider.
Configurazione lato server
Oltre al connettore di tenant, ogni canale richiede una configurazione a livello di applicazione (parametri di deploy), gestita dal fornitore. In assenza di questa configurazione il canale funziona in modalità di prova, senza invio reale dei messaggi.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Non è possibile modificare un connettore esistente | I connettori sono immutabili per progetto | Creare un nuovo connettore con i parametri corretti ed eliminare quello precedente |
| Un SMS risulta inviato ma non recapitato | In invio massivo l'esito restituito dal gateway è per lotto, non per singolo numero | Verificare l'esito complessivo del lotto; il connettore usato per ogni invio resta comunque tracciato |
| Le campagne vengono inviate in modalità di prova | Configurazione lato server (credenziali del provider) non impostata | Contattare il fornitore per completare la configurazione applicativa |