Povežite WhatsApp sa Bitrix24 CRM-om na Coexistence broju

Kako n8n razgovara sa Bitrix24-om?

Preko inbound webhooka, koji u Bitrix24-u nije prijemnik nego kredencijal. Napravite ga u Bitrix24 resursima za developere, izaberete scope-ove koje sme da koristi i dobijete URL sa adresom vašeg portala, id-jem korisnika koji ga je napravio i tajnim kodom. Kada tom URL-u dodate ime metode, REST API se poziva kao taj korisnik, sa njegovim dozvolama.

Zato je u n8n-u svaki Bitrix24 korak HTTP Request čvor koji šalje na taj URL plus metodu, na primer crm.lead.add.json. Nema OAuth toka koji treba završiti niti aplikacije koju treba objaviti. Webhooku dajte samo CRM scope i napravite ga pod korisnikom čije dozvole pokrivaju leadove i kontakte koje workflow mora da vidi, jer Bitrix24 proverava pristup kao taj korisnik.

Koje Bitrix24 metode workflow poziva?

Tri, redom, pošto n8n Webhook čvor primi poruku od Meta.

crm.duplicate.findbycomm sa tipom PHONE i brojem pošiljaoca vraća id-jeve svih leadova, kontakata i kompanija koji ga imaju. To je pravi upit jer pretražuje sve tri vrste odjednom i pravljen je za poklapanje po komunikacionim podacima, a ne po tekstualnom polju.

Kada ništa ne vrati, crm.lead.add pravi lead sa imenom WhatsApp profila kao naslovom i brojem u polju za telefon. Zatim crm.timeline.comment.add upisuje tekst poruke kao komentar na zapis, uz ENTITY_TYPE, ENTITY_ID i COMMENT. Komentar se pojavljuje u timeline-u zapisa pored poziva i mejlova, tamo gde prodavac već gleda.

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

Kako ograničenje učestalosti oblikuje workflow?

Bitrix24 meri REST pozive modelom „leaky bucket“. Svaki zahtev povećava brojač, brojač se prazni fiksnom brzinom svake sekunde, a kada pređe prag, sledeći zahtev dobija 503 sa QUERY_LIMIT_EXCEEDED. Na Enterprise planovima brojač se prazni za 5 u sekundi uz prag od 250, a na svim ostalim planovima za 2 uz prag od 50.

Svaka dolazna poruka košta dva ili tri poziva, pa ravnomeran tok nikada ne dolazi blizu praga. Naglo povećanje dolazi: pedeset kupaca koji u roku od minuta odgovore na isti šablon to je do 150 poziva. Podesite HTTP Request čvorove da ponove pokušaj nakon greške uz kratko čekanje i pokrećite izvršavanja workflowa jedno po jedno, tako da se nagli talas sliva u Bitrix24 umesto da se odbija o njega.

Da li odgovori otkucani na telefonu stižu u Bitrix24?

Mogu. Na Coexistence broju aplikacija WhatsApp Business nastavlja da radi, a kada neko odgovori iz nje, Meta šalje odjek odlazne poruke na isto odredište webhooka, u polju smb_message_echoes.

Druga grana workflowa obrađuje te odjeke isto kao dolazne poruke, a komentar se označava kao odlazni. Zapis tada prikazuje ceo razgovor, sa redom izjava kupca i odgovora prodavnice.

Odgovore koje workflow sam šalje preko Cloud API-ja workflow već ima u rukama kad odlaze, pa ih upišite u tom trenutku umesto da čekate da se webhook vrati.

Česte greške

• Lepljenje URL-a inbound webhooka u kod na strani klijenta ili u zajednički dokument. Tajna u njemu daje sve scope-ove koje webhook ima.
• Pravljenje webhooka pod korisnikom koji ne vidi sve leadove. Pretrage tada promašuju zapise, a workflow pravi duplikate.
• Slanje naglog talasa poziva bez ponovnih pokušaja. Bitrix24 odgovara sa 503 QUERY_LIMIT_EXCEEDED i te poruke nikada ne stignu u timeline.

Često postavljana pitanja

Nastavite sa čitanjem