WhatsApp koppelen aan Bitrix24 CRM op een Coexistence-nummer

Hoe praat n8n met Bitrix24?

Via een inkomende webhook, die in Bitrix24 geen ontvanger is maar een toegangssleutel. Je maakt hem aan bij de ontwikkelaarsbronnen van Bitrix24, kiest de scopes die hij mag gebruiken en krijgt een URL met het adres van je portaal, de id van de gebruiker die hem aanmaakte en een geheime code. Als je een methodenaam aan die URL toevoegt, roep je de REST API aan als die gebruiker, met de rechten van die gebruiker.

In n8n is dus elke Bitrix24-stap een HTTP-node die post naar die URL plus een methode zoals crm.lead.add.json. Er is geen OAuth-flow om te doorlopen en geen app om te publiceren. Geef de webhook alleen de CRM-scope en maak hem aan vanuit een gebruiker wiens rechten de leads en contacten dekken die de workflow moet zien, want Bitrix24 controleert de toegang als die gebruiker.

Welke Bitrix24-methoden roept de workflow aan?

Drie, in deze volgorde, nadat de n8n Webhook-node het bericht van Meta heeft ontvangen.

crm.duplicate.findbycomm met type PHONE en het nummer van de afzender geeft de id's terug van alle leads, contacten en bedrijven die het hebben. Dit is de juiste opzoeking, omdat hij alle drie tegelijk doorzoekt en gemaakt is voor het matchen op communicatiegegevens in plaats van op een tekstveld.

Als er niets terugkomt, maakt crm.lead.add een lead aan met de WhatsApp-profielnaam als titel en het nummer in het telefoonveld. Daarna schrijft crm.timeline.comment.add de berichttekst als opmerking bij het record, met ENTITY_TYPE, ENTITY_ID en COMMENT. De opmerking verschijnt in de tijdlijn van het record naast telefoongesprekken en e-mails, waar een verkoper al kijkt.

POST https://yourcompany.bitrix24.com/rest/1/<secret>/crm.duplicate.findbycomm.json
{ "type": "PHONE", "values": ["14155550188"] }

POST .../crm.lead.add.json
{ "fields": { "TITLE": "WhatsApp: Maria", "PHONE": [{ "VALUE": "14155550188", "VALUE_TYPE": "MOBILE" }] } }

POST .../crm.timeline.comment.add.json
{ "fields": { "ENTITY_TYPE": "lead", "ENTITY_ID": 4211, "COMMENT": "do you have anything friday?" } }

Hoe bepaalt de limiet het ontwerp van de workflow?

Bitrix24 meet REST-aanroepen met een leaky bucket. Elk verzoek telt op bij een teller, de teller loopt elke seconde met een vaste snelheid leeg, en zodra hij een drempel passeert krijgt het volgende verzoek een 503 met QUERY_LIMIT_EXCEEDED. Op Enterprise-abonnementen loopt de teller met 5 per seconde leeg bij een drempel van 250; op alle andere abonnementen met 2 bij een drempel van 50.

Elk binnenkomend bericht kost twee of drie aanroepen, dus een gestage stroom komt nooit in de buurt. Een piek wel: vijftig klanten die binnen een minuut op hetzelfde template antwoorden, zijn tot 150 aanroepen. Stel de HTTP-nodes in om bij een mislukking opnieuw te proberen met een korte wachttijd, en laat de uitvoeringen van de workflow één voor één draaien, zodat een piek in Bitrix24 leegloopt in plaats van eraf te stuiteren.

Komen antwoorden die op de telefoon zijn getypt in Bitrix24 terecht?

Dat kan. Op een Coexistence-nummer blijft de WhatsApp Business-app werken, en wanneer iemand daarmee antwoordt, stuurt Meta een echo van het uitgaande bericht naar dezelfde webhook-bestemming, onder het veld smb_message_echoes.

Een tweede tak in de workflow verwerkt die echo's op dezelfde manier als binnenkomende berichten, met de opmerking gemarkeerd als uitgaand. Het record toont dan het hele gesprek, met de regels van de klant en de antwoorden van de winkel op volgorde.

Antwoorden die de workflow zelf via de Cloud API verstuurt, heeft de workflow al in handen op het moment dat ze uitgaan. Log ze dus op dat moment in plaats van te wachten tot er een webhook terugkomt.

Veelgemaakte fouten

• De URL van de inkomende webhook plakken in code aan de clientzijde of in een gedeeld document. Het geheim erin geeft toegang tot elke scope die de webhook heeft gekregen.
• De webhook aanmaken vanuit een gebruiker die niet alle leads kan zien. Opzoekingen missen dan records en de workflow maakt duplicaten aan.
• Een piek aan aanroepen sturen zonder nieuwe pogingen. Bitrix24 antwoordt 503 QUERY_LIMIT_EXCEEDED en die berichten komen nooit in de tijdlijn.

Veelgestelde vragen

Lees verder