Capture WhatsApp via companion
Capturez chaque conversation depuis le WhatsApp Business du commercial directement dans la chronologie Conversations, à l'aide d'un pont companion que vous hébergez vous-même. Optionnel, désactivé par défaut, et nécessite d'accepter un avis de Conditions d'utilisation.
Ce connecteur fait entrer les messages WhatsApp Business du commercial dans la chronologie Conversations, capturés par un pont companion hébergé par votre organisation. Les messages arrivent au même endroit que vos autres conversations, de sorte que le résumé IA, les insights et le suivi des relances fonctionnent déjà dessus.
Avant de commencer : avis sur les Conditions d'utilisation
Comment ça marche
- Vous exécutez un pont companion (un service WhatsApp Web open source) dans votre environnement.
- Le companion s'associe à WhatsApp Business par code QR et écoute les messages entrants et sortants.
- Pour chaque message, le companion envoie un POST signé vers l'URL d'ingestion de votre organisation.
- Le message est stocké, relié au contact ou au lead par numéro de téléphone (ou crée un nouveau lead lorsque le numéro est inconnu), et apparaît dans la chronologie Conversations.
Comment se connecter
- Allez dans Paramètres, Intégrations et ouvrez la carte « WhatsApp : capture via companion ».
- Définissez un secret d'appairage fort et cochez la case de consentement (Je comprends le risque lié aux Conditions d'utilisation). Cliquez sur Enregistrer.
- Copiez l'URL d'ingestion affichée et configurez le companion avec cette URL et le même secret d'appairage.
- Sur la carte, cliquez sur Activer. Sans le consentement coché et enregistré, la capture n'est pas acceptée.
Tant que le connecteur est désactivé ou que le consentement n'est pas enregistré, l'URL d'ingestion rejette toute publication. Ainsi, vous ne capturez jamais rien sans avoir accepté l'avis.
Format du POST (contrat du companion)
Le companion envoie un message ou un lot, en signant le corps avec le secret d'appairage (HMAC-SHA256) dans l'en-tête X-Sellio-Signature, au format 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"
}
]
}Le messageId garantit que le même message, s'il est renvoyé, ne devient pas un doublon. direction vaut « in » (reçu) ou « out » (envoyé par le commercial). timestamp accepte les secondes ou les millisecondes et sert à ordonner la chronologie.