Povezivanje WhatsAppa s Bitrix24 CRM-om na broju Coexistence

Kako n8n komunicira s Bitrix24?

Putem dolaznog webhooka, koji u Bitrix24 nije primatelj nego vjerodajnica. Stvarate ga u razvojnim resursima Bitrix24, birate ovlasti koje smije koristiti i dobivate URL koji sadrži adresu vašeg portala, id korisnika koji ga je stvorio i tajni kôd. Dodavanjem naziva metode na taj URL poziva se REST API kao taj korisnik, s njegovim dopuštenjima.

Zato je u n8n svaki korak prema Bitrix24 čvor HTTP Request koji šalje POST na taj URL uz metodu poput crm.lead.add.json. Nema OAuth tijeka koji treba proći ni aplikacije koju treba objaviti. Webhooku dodijelite samo ovlast za CRM i stvorite ga od korisnika čija dopuštenja pokrivaju leadove i kontakte koje tijek rada mora vidjeti, jer Bitrix24 provjerava pristup kao taj korisnik.

Koje metode Bitrix24 poziva tijek rada?

Tri, redom, nakon što čvor Webhook u n8n primi poruku od Mete.

crm.duplicate.findbycomm s tipom PHONE i brojem pošiljatelja vraća id-ove svih leadova, kontakata i tvrtki koji ga imaju. To je ispravno pretraživanje jer istodobno traži kroz sva tri tipa i namijenjeno je podudaranju po komunikacijskim podacima, a ne po tekstualnom polju.

Kad ne vrati ništa, crm.lead.add stvara lead s 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 na vremenskoj crti zapisa uz pozive i e-poštu, tamo gdje prodavač 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 stope utječe na tijek rada?

Bitrix24 mjeri REST pozive modelom „leaky bucket”. Svaki zahtjev povećava brojač, brojač se svake sekunde prazni fiksnom brzinom, a kad prijeđe prag, sljedeći zahtjev dobiva 503 s 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 ni stalan dotok nikad ne dolazi blizu praga. Nalet dolazi: pedeset kupaca koji u roku od minute odgovore na isti predložak to je do 150 poziva. Postavite čvorove HTTP Request da ponove pokušaj nakon pogreške uz kratko čekanje i pokrećite izvršavanja tijeka rada jedno po jedno, kako bi se nalet slijevao u Bitrix24, a ne odbijao od njega.

Stižu li odgovori otipkani na telefonu u Bitrix24?

Mogu. Na broju Coexistence aplikacija WhatsApp Business i dalje radi, a kad netko odgovori iz nje, Meta šalje odjek odlazne poruke na isto odredište webhooka, u polju smb_message_echoes.

Druga grana tijeka rada obrađuje te odjeke jednako kao dolazne poruke, s komentarom označenim kao odlazni. Zapis tada prikazuje cijeli razgovor, s kupčevim retcima i odgovorima tvrtke redom.

Odgovore koje tijek rada sam šalje putem Cloud API već ima u rukama kad odlaze, pa ih zabilježite u tom trenutku umjesto da čekate povratni webhook.

Uobičajene pogreške

• Lijepljenje URL-a dolaznog webhooka u kôd na strani klijenta ili u zajednički dokument. Tajna u njemu daje sve ovlasti koje su webhooku dodijeljene.
• Stvaranje webhooka od korisnika koji ne vidi sve leadove. Pretraživanja tada propuštaju zapise, a tijek rada stvara duplikate.
• Slanje naleta poziva bez ponovnih pokušaja. Bitrix24 odgovara s 503 QUERY_LIMIT_EXCEEDED i te poruke nikad ne stignu na vremensku crtu.

Često postavljana pitanja

Nastavite čitati