Σύνδεση του WhatsApp με το Bitrix24 CRM σε αριθμό Coexistence

Πώς επικοινωνεί το n8n με το Bitrix24;

Μέσω ενός inbound webhook, το οποίο στο Bitrix24 δεν είναι δέκτης αλλά διαπιστευτήριο. Το δημιουργείτε στους πόρους προγραμματιστή του Bitrix24, επιλέγετε τα scopes που μπορεί να χρησιμοποιεί και λαμβάνετε ένα URL που περιέχει τη διεύθυνση του portal σας, το id του χρήστη που το δημιούργησε και έναν μυστικό κωδικό. Αν προσθέσετε το όνομα μιας μεθόδου στο URL, καλείτε το REST API ως αυτός ο χρήστης, με τα δικαιώματά του.

Έτσι, στο n8n κάθε βήμα προς το Bitrix24 είναι ένας κόμβος HTTP Request που στέλνει POST σε αυτό το URL μαζί με μια μέθοδο όπως το crm.lead.add.json. Δεν υπάρχει ροή OAuth προς ολοκλήρωση και δεν χρειάζεται να δημοσιεύσετε εφαρμογή. Δώστε στο webhook μόνο το scope του CRM και δημιουργήστε το από χρήστη του οποίου τα δικαιώματα καλύπτουν τα leads και τις επαφές που πρέπει να βλέπει το workflow, αφού το Bitrix24 ελέγχει την πρόσβαση ως αυτός ο χρήστης.

Ποιες μεθόδους του Bitrix24 καλεί το workflow;

Τρεις, με τη σειρά, αφού ο κόμβος Webhook του n8n λάβει το μήνυμα από τη Meta.

Το crm.duplicate.findbycomm με type PHONE και τον αριθμό του αποστολέα επιστρέφει τα id όσων leads, επαφών και εταιρειών τον διαθέτουν. Είναι η σωστή αναζήτηση, γιατί ψάχνει και στα τρία ταυτόχρονα και έχει σχεδιαστεί για ταίριασμα επικοινωνιακών στοιχείων και όχι ενός πεδίου κειμένου.

Όταν δεν επιστρέφει τίποτα, το crm.lead.add δημιουργεί ένα lead με τίτλο το όνομα προφίλ στο WhatsApp και τον αριθμό στο πεδίο τηλεφώνου. Έπειτα το crm.timeline.comment.add γράφει το κείμενο του μηνύματος ως σχόλιο στην εγγραφή, με τα ENTITY_TYPE, ENTITY_ID και COMMENT. Το σχόλιο εμφανίζεται στο timeline της εγγραφής δίπλα στις κλήσεις και τα emails, εκεί όπου κοιτάζει ήδη ο πωλητής.

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

Πώς επηρεάζει το όριο ρυθμού το workflow;

Το Bitrix24 μετρά τις κλήσεις REST με «τρύπιο κουβά». Κάθε αίτημα προσθέτει στον μετρητή, ο μετρητής αδειάζει με σταθερό ρυθμό ανά δευτερόλεπτο, και μόλις ξεπεράσει ένα όριο, το επόμενο αίτημα λαμβάνει 503 με QUERY_LIMIT_EXCEEDED. Στα πακέτα Enterprise ο μετρητής αδειάζει κατά 5 το δευτερόλεπτο με όριο 250· σε όλα τα άλλα πακέτα αδειάζει κατά 2 με όριο 50.

Κάθε εισερχόμενο μήνυμα κοστίζει δύο ή τρεις κλήσεις, οπότε μια σταθερή ροή δεν πλησιάζει ποτέ το όριο. Μια έξαρση όμως το πλησιάζει: πενήντα πελάτες που απαντούν στο ίδιο template μέσα σε ένα λεπτό σημαίνουν έως και 150 κλήσεις. Ρυθμίστε τους κόμβους HTTP Request να επαναλαμβάνουν σε περίπτωση αποτυχίας με μικρή αναμονή και εκτελέστε τις εκτελέσεις του workflow μία τη φορά, ώστε η έξαρση να αποστραγγίζεται στο Bitrix24 αντί να απορρίπτεται.

Φτάνουν στο Bitrix24 οι απαντήσεις που πληκτρολογούνται στο κινητό;

Μπορούν να φτάσουν. Σε έναν αριθμό Coexistence η εφαρμογή WhatsApp Business συνεχίζει να λειτουργεί, και όταν κάποιος απαντά από αυτήν, η Meta στέλνει ένα αντίγραφο του εξερχόμενου μηνύματος στον ίδιο προορισμό webhook, στο πεδίο smb_message_echoes.

Μια δεύτερη διακλάδωση στο workflow χειρίζεται αυτά τα αντίγραφα όπως και τα εισερχόμενα μηνύματα, με το σχόλιο σημειωμένο ως εξερχόμενο. Η εγγραφή τότε δείχνει ολόκληρη τη συζήτηση, με τις γραμμές του πελάτη και τις απαντήσεις της επιχείρησης στη σωστή σειρά.

Οι απαντήσεις που στέλνει το ίδιο το workflow μέσω του Cloud API βρίσκονται ήδη στα χέρια του workflow τη στιγμή που φεύγουν, οπότε καταγράψτε τις εκείνη τη στιγμή αντί να περιμένετε να επιστρέψει ένα webhook.

Συνηθισμένα λάθη

• Επικόλληση του inbound webhook URL σε κώδικα που εκτελείται στον client ή σε κοινόχρηστο έγγραφο. Το μυστικό που περιέχει δίνει όλα τα scopes που έχουν δοθεί στο webhook.
• Δημιουργία του webhook από χρήστη που δεν βλέπει όλα τα leads. Οι αναζητήσεις τότε χάνουν εγγραφές και το workflow δημιουργεί διπλότυπα.
• Αποστολή έξαρσης κλήσεων χωρίς επαναλήψεις. Το Bitrix24 απαντά 503 QUERY_LIMIT_EXCEEDED και τα μηνύματα αυτά δεν φτάνουν ποτέ στο timeline.

Συχνές ερωτήσεις

Συνεχίστε την ανάγνωση