Gebruik een Coexistence-nummer als WhatsApp Cloud-inbox in Chatwoot

Hoe koppel je een Coexistence-nummer aan Chatwoot?

Op twee plekken, in deze volgorde.

Voeg in Chatwoot een inbox toe, kies WhatsApp en kies de provider WhatsApp Cloud met de handmatige setup. Vul het nummer, het telefoonnummer-id, het WhatsApp Business Account-id en het toegangstoken in. Die waarden staan in het EasyCoexistence-dashboard bij de verbinding, of get_api_credentials geeft ze terug aan een assistent. Chatwoot toont daarna een webhook-URL en een verificatietoken voor de webhook van de inbox.

Stel in EasyCoexistence de webhook-bestemming van het nummer in op die URL en vul hetzelfde verificatietoken in. Meta stuurt het verificatieverzoek naar Chatwoot, Chatwoot beantwoordt het, en vanaf dan komt elk bericht naar het nummer in de inbox binnen. Er draait niets tussenin, dus er is geen workflow om draaiende te houden.

Verschijnen antwoorden vanaf de telefoon in Chatwoot?

Ja. Op een Coexistence-nummer meldt Meta een antwoord dat in de WhatsApp Business-app is getypt als een smb_message_echoes-event. De webhook-job van Chatwoot herkent dat veld en slaat het bericht op als uitgaand in het juiste gesprek. In de broncode staat dit geval er direct in beschreven: bedrijven die vanuit zowel Chatwoot als de app antwoorden, met berichten die naar Chatwoot worden gesynchroniseerd.

Daardoor werkt de verdeling in de praktijk. De eigenaar kan vaste klanten blijven beantwoorden vanaf de telefoon, het team kan aan een bureau de gedeelde inbox bewerken, en iedereen ziet wat de ander stuurde zonder dat iemand screenshots doorstuurt.

Berichten die vanuit Chatwoot worden verstuurd gaan via de Cloud API over hetzelfde nummer, dus ze verschijnen ook op de telefoon.

Waarom hoort de Chatwoot-inbox geen app secret te hebben?

Omdat de leveringen zijn ondertekend met een geheim dat jij niet hebt. Meta ondertekent elke webhook met het app secret van de app die het abonnement bezit, en dat is de EasyCoexistence-app. Dat geheim wordt nooit gedeeld.

In de huidige broncode van Chatwoot wordt de header X-Hub-Signature-256 bij een handmatig geconfigureerd WhatsApp Cloud-kanaal alleen gecontroleerd als er een app secret op is opgeslagen, of als het kanaal via de eigen Embedded Signup van Chatwoot is gemaakt. Een handmatige inbox zonder app secret accepteert de leveringen. Een inbox met een willekeurig ingevuld app secret wijst ze allemaal af als niet geautoriseerd.

Het verificatietoken is hier de bescherming die geldt. Kies een lange willekeurige waarde, want daarmee kan Chatwoot het verificatieverzoek van Meta onderscheiden van dat van een ander.

Wat kan Chatwoot op dit nummer niet?

Webhooks op een tweede plek tegelijk ontvangen. Meta stuurt de webhooks van een nummer naar één bestemming, dus zolang Chatwoot die heeft, ontvangt een n8n-workflow dezelfde events niet. Heb je beide nodig, wijs de bestemming dan naar een eigen kleine relay die elke levering doorstuurt naar Chatwoot en naar de workflow.

De Coexistence-limieten gelden zoals overal: de API verstuurt tot 20 berichten per seconde, vrije tekst gaat alleen uit binnen 24 uur na het laatste bericht van de klant, en templates dekken alles daarna.

De WhatsApp Business-app moet nog steeds minstens elke 14 dagen worden geopend, waar EasyCoexistence op let.

Veelgemaakte fouten

• Een app secret invullen in de Chatwoot-inbox. Leveringen zijn ondertekend met het geheim van de EasyCoexistence-app, dus Chatwoot wijst ze allemaal af als niet geautoriseerd.
• In EasyCoexistence een ander verificatietoken gebruiken dan dat Chatwoot toont. De verificatie van Meta mislukt en de inbox ontvangt nooit een bericht.
• De Embedded Signup van Chatwoot kiezen in plaats van de handmatige flow. Dat koppelt het nummer via de eigen Meta-app van Chatwoot, een aparte verbinding.

Veelgestelde vragen

Lees verder