Ikonekta ang WhatsApp sa Bitrix24 CRM gamit ang Coexistence na numero

Paano nakikipag-ugnayan ang n8n sa Bitrix24?

Sa pamamagitan ng inbound webhook, na sa Bitrix24 ay hindi tagatanggap kundi isang credential. Gagawin po ninyo ito sa developer resources ng Bitrix24, pipiliin ang mga scope na maaari nitong gamitin, at makakakuha ng URL na may address ng inyong portal, id ng user na gumawa nito at isang secret code. Kapag nagdagdag ng pangalan ng method sa URL na iyon, tatawagin ang REST API bilang user na iyon, taglay ang mga pahintulot ng user na iyon.

Kaya sa n8n, bawat hakbang sa Bitrix24 ay isang HTTP Request node na nagpo-post sa URL na iyon kasama ang isang method gaya ng crm.lead.add.json. Walang OAuth flow na kailangang tapusin at walang app na kailangang i-publish. Ibigay sa webhook ang CRM scope lamang, at gawin ito mula sa user na ang mga pahintulot ay sumasaklaw sa mga lead at contact na dapat makita ng workflow, dahil sinusuri ng Bitrix24 ang access bilang user na iyon.

Anong mga method ng Bitrix24 ang tinatawag ng workflow?

Tatlo, ayon sa pagkakasunod, matapos matanggap ng n8n Webhook node ang mensahe mula sa Meta.

Ang crm.duplicate.findbycomm na may type na PHONE at numero ng nagpadala ay nagbabalik ng mga id ng anumang lead, contact at company na may hawak nito. Ito ang tamang paghahanap dahil sabay nitong sinusuri ang tatlo at idinisenyo ito para sa pagtutugma ng mga komunikasyon, hindi ng isang text field.

Kapag walang naibalik, gagawa ang crm.lead.add ng lead na ang pangalan sa WhatsApp profile ang ginagawang title at ang numero ang nasa phone field nito. Pagkatapos, isusulat ng crm.timeline.comment.add ang teksto ng mensahe bilang comment sa record, gamit ang ENTITY_TYPE, ENTITY_ID at COMMENT. Lalabas ang comment sa timeline ng record kasama ng mga tawag at email, kung saan karaniwang tumitingin ang salesperson.

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

Paano naaapektuhan ng rate limit ang workflow?

Sinusukat ng Bitrix24 ang mga REST call gamit ang leaky bucket. Bawat request ay nagdaragdag sa counter, bumababa ang counter sa takdang bilis kada segundo, at kapag lumampas ito sa threshold, makakatanggap ang susunod na request ng 503 na may QUERY_LIMIT_EXCEEDED. Sa mga Enterprise plan, bumababa ang counter ng 5 kada segundo na may threshold na 250; sa lahat ng iba pang plan, bumababa ito ng 2 na may threshold na 50.

Bawat papasok na mensahe ay gumagamit ng dalawa hanggang tatlong call, kaya hindi ito umaabot sa limitasyon kapag mabagal ang daloy. Ang biglaang dagsa ang problema: limampung customer na sumagot sa iisang template sa loob ng isang minuto ay hanggang 150 call. Itakda po ninyo ang mga HTTP Request node na mag-retry kapag nag-fail na may maikling paghihintay, at patakbuhin ang mga execution ng workflow nang isa-isa, upang dahan-dahang makapasok sa Bitrix24 ang dagsa sa halip na tanggihan.

Naaabot ba ng Bitrix24 ang mga sagot na tinype sa telepono?

Oo, maaari. Sa Coexistence na numero, patuloy na gumagana ang WhatsApp Business app, at kapag may sumagot mula rito, magpapadala ang Meta ng echo ng palabas na mensahe sa parehong webhook destination, sa ilalim ng field na smb_message_echoes.

Pinoproseso ng pangalawang branch sa workflow ang mga echo na iyon sa parehong paraan ng mga papasok na mensahe, at minamarkahan ang comment bilang palabas. Makikita na sa record ang buong usapan, na magkakasunod ang mga linya ng customer at ang mga sagot ng tindahan.

Ang mga sagot na ipinapadala mismo ng workflow sa pamamagitan ng Cloud API ay hawak na ng workflow bago pa ito lumabas, kaya i-log ang mga ito sa sandaling iyon sa halip na maghintay ng webhook na babalik.

Mga karaniwang pagkakamali

• Pag-paste ng inbound webhook URL sa client-side code o sa shared na dokumento. Ang secret dito ay nagbibigay ng bawat scope na ibinigay sa webhook.
• Paggawa ng webhook mula sa user na hindi nakakakita ng lahat ng lead. Mamimiss ng mga paghahanap ang mga record at gagawa ang workflow ng mga duplicate.
• Pagpapadala ng dagsa ng mga call nang walang retry. Sasagot ang Bitrix24 ng 503 QUERY_LIMIT_EXCEEDED at hindi na makakarating sa timeline ang mga mensaheng iyon.

Mga madalas itanong

Magpatuloy sa pagbabasa