WhatsApp yhdistetty Bitrix24 CRM:ään Coexistence-numerolla

Miten n8n keskustelee Bitrix24:n kanssa?

Saapuvan webhookin kautta. Bitrix24:ssä se ei ole vastaanottaja vaan tunnistautumistapa. Luot sen Bitrix24:n kehittäjäresursseissa, valitset sille sallitut oikeudet ja saat URL-osoitteen, joka sisältää portaalisi osoitteen, sen luoneen käyttäjän tunnuksen ja salaisen koodin. Kun lisäät osoitteen perään metodin nimen, REST API -rajapintaa kutsutaan tuon käyttäjän oikeuksilla.

N8n:ssä jokainen Bitrix24-vaihe on siis HTTP Request -node, joka lähettää pyynnön tähän osoitteeseen ja metodiin, kuten crm.lead.add.json. OAuth-kulkua ei tarvitse käydä läpi eikä sovellusta julkaista. Anna webhookille vain CRM-oikeus ja luo se käyttäjältä, jonka oikeudet kattavat työnkulun tarvitsemat liidit ja kontaktit, sillä Bitrix24 tarkistaa pääsyn kyseisen käyttäjän oikeuksilla.

Mitä Bitrix24:n metodeja työnkulku kutsuu?

Kolmea, tässä järjestyksessä, kun n8n:n Webhook-node on vastaanottanut Metan lähettämän viestin.

crm.duplicate.findbycomm tyypillä PHONE ja lähettäjän puhelinnumerolla palauttaa niiden liidien, kontaktien ja yritysten tunnukset, joilla numero on. Tämä on oikea haku, koska se etsii kaikista kolmesta kerralla ja on tehty yhteystietojen vertailuun eikä tekstikentän hakuun.

Jos haku ei palauta mitään, crm.lead.add luo liidin, jonka otsikkona on WhatsApp-profiilin nimi ja jonka puhelinkentässä on numero. Sitten crm.timeline.comment.add kirjoittaa viestin tekstin kommentiksi tietueeseen ja ottaa parametreiksi ENTITY_TYPE, ENTITY_ID ja COMMENT. Kommentti näkyy tietueen aikajanalla puheluiden ja sähköpostien vieressä, mistä myyjä sitä jo katsoo.

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

Miten pyyntöraja vaikuttaa työnkulkuun?

Bitrix24 mittaa REST-kutsuja vuotavalla ämpärillä. Jokainen pyyntö kasvattaa laskuria, laskuri tyhjenee kiinteää vauhtia sekunnissa, ja kun se ylittää kynnyksen, seuraava pyyntö saa vastauksen 503 ja virheen QUERY_LIMIT_EXCEEDED. Enterprise-paketeissa laskuri tyhjenee 5 sekunnissa ja kynnys on 250, kaikissa muissa paketeissa tyhjeneminen on 2 ja kynnys 50.

Jokainen saapuva viesti maksaa kaksi tai kolme kutsua, joten tasainen virta ei lähelläkään rajaa. Ruuhkahuippu ylittää sen: viisikymmentä asiakasta vastaa samaan viestipohjaan minuutin sisällä, mikä on jopa 150 kutsua. Aseta HTTP Request -nodet yrittämään uudelleen virheen jälkeen lyhyellä odotuksella ja aja työnkulun suoritukset yksi kerrallaan, jolloin huippu valuu Bitrix24:ään sen sijaan, että kimpoaisi siitä takaisin.

Päätyvätkö puhelimella kirjoitetut vastaukset Bitrix24:ään?

Voivat päätyä. Coexistence-numerolla WhatsApp Business -sovellus toimii edelleen, ja kun joku vastaa siitä, Meta lähettää lähtevän viestin kaiun samaan webhook-osoitteeseen kentällä smb_message_echoes.

Työnkulun toinen haara käsittelee nämä kaiut samalla tavalla kuin saapuvat viestit, ja kommentti merkitään lähteväksi. Tietueessa näkyy silloin koko keskustelu, asiakkaan rivit ja myyjän vastaukset oikeassa järjestyksessä.

Vastaukset, jotka työnkulku lähettää itse Cloud API -rajapinnan kautta, ovat työnkulun tiedossa jo lähtiessään, joten kirjaa ne siinä vaiheessa sen sijaan, että odottaisit webhookin palaavan.

Yleiset virheet

• Saapuvan webhookin URL-osoitteen liittäminen selainpuolen koodiin tai jaettuun dokumenttiin. Sen salainen koodi antaa kaikki webhookille annetut oikeudet.
• Webhookin luominen käyttäjältä, joka ei näe kaikkia liidejä. Haut ohittavat silloin tietueita ja työnkulku luo kaksoiskappaleita.
• Kutsujen lähettäminen ruuhkana ilman uudelleenyrityksiä. Bitrix24 vastaa 503 QUERY_LIMIT_EXCEEDED, eivätkä nuo viestit päädy aikajanalle.

Usein kysytyt kysymykset

Lue lisää