WhatsApp-Erfassung über Companion
Erfassen Sie jede Konversation aus dem WhatsApp Business des Mitarbeiters direkt in der Konversations-Timeline über eine Companion-Brücke, die Sie selbst hosten. Optional, standardmäßig deaktiviert, und erfordert die Zustimmung zu einem Hinweis auf die Nutzungsbedingungen.
Dieser Konnektor bringt die WhatsApp-Business-Nachrichten des Mitarbeiters in die Konversations-Timeline, erfasst durch eine Companion-Brücke, die Ihre Organisation hostet. Die Nachrichten landen am selben Ort wie Ihre anderen Konversationen, sodass die KI-Zusammenfassung, Insights und Follow-up-Überwachung bereits darauf aufbauen.
Bevor Sie beginnen: Hinweis auf die Nutzungsbedingungen
So funktioniert es
- Sie betreiben eine Companion-Brücke (einen Open-Source-WhatsApp-Web-Dienst) in Ihrer Umgebung.
- Der Companion koppelt WhatsApp Business per QR-Code und lauscht auf eingehende und ausgehende Nachrichten.
- Für jede Nachricht sendet der Companion einen signierten POST an die Erfassungs-URL Ihrer Organisation.
- Die Nachricht wird gespeichert, per Telefonnummer mit dem Kontakt oder Lead verknüpft (oder legt einen neuen Lead an, wenn die Nummer unbekannt ist) und erscheint in der Konversations-Timeline.
So verbinden Sie es
- Gehen Sie zu Einstellungen, Integrationen und öffnen Sie die Karte "WhatsApp: Erfassung über Companion".
- Legen Sie ein starkes Kopplungsgeheimnis fest und aktivieren Sie das Einwilligungskästchen (Ich verstehe das Risiko der Nutzungsbedingungen). Klicken Sie auf Speichern.
- Kopieren Sie die angezeigte Erfassungs-URL und konfigurieren Sie den Companion mit dieser URL und demselben Kopplungsgeheimnis.
- Klicken Sie auf der Karte auf Aktivieren. Ohne aktivierte und gespeicherte Einwilligung wird die Erfassung nicht akzeptiert.
Solange der Konnektor deaktiviert ist oder die Einwilligung nicht gespeichert ist, weist die Erfassungs-URL jeden Post ab. So erfassen Sie nie etwas, ohne den Hinweis akzeptiert zu haben.
POST-Format (Companion-Vertrag)
Der Companion sendet eine Nachricht oder einen Stapel und signiert den Body mit dem Kopplungsgeheimnis (HMAC-SHA256) im Header X-Sellio-Signature, formatiert als 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"
}
]
}Die messageId stellt sicher, dass dieselbe Nachricht, falls erneut gesendet, kein Duplikat wird. direction ist "in" (empfangen) oder "out" (vom Mitarbeiter gesendet). timestamp akzeptiert Sekunden oder Millisekunden und wird zum Ordnen der Timeline verwendet.