Acquisizione WhatsApp tramite companion
Cattura ogni conversazione dal WhatsApp Business del rappresentante direttamente nella cronologia Conversazioni, usando un bridge companion che ospiti tu stesso. Opzionale, disattivato per impostazione predefinita, e richiede l'accettazione di un avviso sui Termini di Servizio.
Questo connettore porta i messaggi WhatsApp Business del rappresentante nella cronologia Conversazioni, catturati da un bridge companion ospitato dalla tua organizzazione. I messaggi arrivano nello stesso posto delle tue altre conversazioni, quindi il riepilogo IA, gli insight e il monitoraggio dei follow-up funzionano già su di essi.
Prima di iniziare: avviso sui Termini di Servizio
Come funziona
- Esegui un bridge companion (un servizio WhatsApp Web open source) nel tuo ambiente.
- Il companion si accoppia con WhatsApp Business tramite codice QR e ascolta i messaggi in entrata e in uscita.
- Per ogni messaggio, il companion invia un POST firmato all'URL di ingestione della tua organizzazione.
- Il messaggio viene memorizzato, collegato al contatto o al lead in base al numero di telefono (oppure crea un nuovo lead quando il numero è sconosciuto), e compare nella cronologia Conversazioni.
Come connettersi
- Vai su Impostazioni, Integrazioni e apri la scheda "WhatsApp: acquisizione via companion".
- Imposta un segreto di accoppiamento robusto e seleziona la casella di consenso (Comprendo il rischio dei Termini di Servizio). Clicca su Salva.
- Copia l'URL di ingestione mostrato e configura il companion con quell'URL e lo stesso segreto di accoppiamento.
- Torna alla scheda e clicca su Attiva. Senza il consenso selezionato e salvato, l'acquisizione non viene accettata.
Finché il connettore è disattivato o il consenso non è stato salvato, l'URL di ingestione rifiuta ogni invio. In questo modo non catturi mai nulla senza aver accettato l'avviso.
Formato del POST (contratto del companion)
Il companion invia un messaggio o un batch, firmando il corpo con il segreto di accoppiamento (HMAC-SHA256) nell'header X-Sellio-Signature, formattato come sha256=<hex>.
POST /api/inbound/whatsapp-capture/YOUR_TOKEN
X-Sellio-Signature: sha256=<hmac-sha256 of the body with the secret>
Content-Type: application/json
{
"messages": [
{
"messageId": "unique-message-id",
"from": "15551230000",
"to": "15559990000",
"direction": "in",
"body": "message text",
"timestamp": 1700000000,
"name": "Contact name"
}
]
}Il messageId garantisce che lo stesso messaggio, se rinviato, non diventi un duplicato. direction è "in" (ricevuto) o "out" (inviato dal rappresentante). timestamp accetta secondi o millisecondi e viene usato per ordinare la cronologia.