Conectați WhatsApp la Bitrix24 CRM pe un număr Coexistence

Cum comunică n8n cu Bitrix24?

Printr-un webhook de intrare, care în Bitrix24 nu este un receptor, ci o credențială. Îl creați în resursele pentru dezvoltatori din Bitrix24, alegeți domeniile de acces (scopes) pe care le poate folosi și primiți un URL care conține adresa portalului dumneavoastră, id-ul utilizatorului care l-a creat și un cod secret. Dacă adăugați la acest URL numele unei metode, apelați API-ul REST ca acel utilizator, cu permisiunile lui.

Astfel, în n8n fiecare pas Bitrix24 este un nod HTTP Request care trimite către acel URL plus o metodă precum crm.lead.add.json. Nu există flux OAuth de parcurs și nicio aplicație de publicat. Acordați webhook-ului doar domeniul CRM și creați-l dintr-un cont de utilizator ale cărui permisiuni acoperă lead-urile și contactele pe care workflow-ul trebuie să le vadă, deoarece Bitrix24 verifică accesul în numele acelui utilizator.

Ce metode Bitrix24 apelează workflow-ul?

Trei, în ordine, după ce nodul Webhook din n8n primește mesajul de la Meta.

crm.duplicate.findbycomm cu tipul PHONE și numărul expeditorului returnează id-urile lead-urilor, contactelor și companiilor care îl dețin. Este căutarea potrivită, pentru că le parcurge pe toate trei deodată și este făcută pentru potrivirea după date de comunicare, nu după un câmp de text.

Când nu returnează nimic, crm.lead.add creează un lead cu numele din profilul WhatsApp ca titlu și cu numărul în câmpul de telefon. Apoi crm.timeline.comment.add scrie textul mesajului ca And comentariu pe înregistrare, folosind ENTITY_TYPE, ENTITY_ID și COMMENT. Comentariul apare în cronologia înregistrării, lângă apeluri și e-mailuri, exact unde se uită deja un agent de vânzări.

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?" } }

Cum influențează limita de rată workflow-ul?

Bitrix24 măsoară apelurile REST cu un „leaky bucket”. Fiecare cerere adaugă la un contor, contorul scade într-un ritm fix în fiecare secundă, iar după ce depășește un prag, următoarea cerere primește 503 cu QUERY_LIMIT_EXCEEDED. Pe planurile Enterprise contorul scade cu 5 pe secundă, la un prag de 250; pe toate celelalte planuri scade cu 2, la un prag de 50.

Fiecare mesaj primit costă două sau trei apeluri, deci un flux constant nu se apropie niciodată de limită. O rafală, în schimb, da: 50 de clienți care răspund în același minut la același template înseamnă până la 150 de apeluri. Setați nodurile HTTP Request să reîncerce la eșec, cu o pauză scurtă, și rulați execuțiile workflow-ului una câte una, astfel încât rafala să se scurgă treptat în Bitrix24, nu să fie respinsă.

Ajung în Bitrix24 și răspunsurile scrise de pe telefon?

Pot ajunge. Pe un număr Coexistence aplicația WhatsApp Business continuă să funcționeze, iar când cineva răspunde din ea, Meta trimite un ecou al mesajului trimis către aceeași destinație de webhook, în câmpul smb_message_echoes.

O a doua ramură a workflow-ului tratează aceste ecouri la fel ca mesajele primite, cu comentariul marcat ca trimis. Înregistrarea arată atunci conversația completă, cu replicile clientului și răspunsurile magazinului în ordine.

Răspunsurile pe care workflow-ul le trimite singur prin Cloud API se află deja în mâinile lui în momentul trimiterii, așa că înregistrați-le chiar atunci, în loc să așteptați întoarcerea unui webhook.

Greșeli frecvente

• Lipirea URL-ului webhook-ului de intrare în cod din partea clientului sau într-un document partajat. Secretul din el oferă toate domeniile de acces acordate webhook-ului.
• Crearea webhook-ului dintr-un cont de utilizator care nu vede toate lead-urile. Căutările ratează atunci înregistrări, iar workflow-ul creează dubluri.
• Trimiterea unei rafale de apeluri fără reîncercări. Bitrix24 răspunde 503 QUERY_LIMIT_EXCEEDED, iar acele mesaje nu ajung niciodată în cronologie.

Întrebări frecvente

Continuați să citiți