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

Πώς συνδέετε έναν αριθμό Coexistence με το Activepieces;

Δημιουργήστε τη σύνδεση WhatsApp Business στο Activepieces με δύο τιμές: το access token και το WhatsApp Business Account id. Το dashboard του EasyCoexistence εμφανίζει και τα δύο για τη σύνδεση, ενώ το get_api_credentials τα επιστρέφει σε έναν βοηθό. Οι οδηγίες του piece μιλούν για δημιουργία Meta app και system user, γιατί υποθέτουν ότι δεν έχετε κανένα από τα δύο. Εδώ ο αριθμός είναι ήδη συνδεδεμένος, οπότε προχωρήστε απευθείας στην επικόλληση των τιμών.

Στη συνέχεια φτιάξτε ένα flow που ξεκινά με το trigger New Incoming Message, ορίστε σε αυτό ένα verify token της επιλογής σας και δημοσιεύστε το flow. Αντιγράψτε το URL του webhook του trigger στον προορισμό webhook του αριθμού στο EasyCoexistence, με το ίδιο verify token. Η Meta στέλνει το αίτημα επαλήθευσης, το trigger απαντά και κάθε μήνυμα προς τον αριθμό ξεκινά μια εκτέλεση.

Γιατί το app secret πρέπει να μείνει κενό;

Επειδή το secret που υπογράφει αυτές τις παραδόσεις δεν είναι δικό σας για να το επικολλήσετε. Η Meta υπογράφει κάθε webhook με το app secret της εφαρμογής που κατέχει τη συνδρομή, και σε έναν αριθμό συνδεδεμένο μέσω του EasyCoexistence αυτή είναι η εφαρμογή EasyCoexistence, της οποίας το secret δεν κοινοποιείται ποτέ.

Το piece θεωρεί το πεδίο προαιρετικό. Όταν μένει κενό, τα triggers του δέχονται τις παραδόσεις όπως έρχονται. Αν συμπληρωθεί με το secret οποιασδήποτε άλλης εφαρμογής, κάθε παράδοση αποτυγχάνει στον έλεγχο X-Hub-Signature-256 και αγνοείται σιωπηλά, κάτι που μοιάζει ακριβώς με μηνύματα που δεν φτάνουν ποτέ.

Το verify token είναι αυτό που κρατά τους άσχετους έξω από τη διαδικασία επαλήθευσης. Επιλέξτε μια μακριά τυχαία τιμή και κρατήστε ιδιωτικό το URL του trigger, γιατί είναι η διεύθυνση που ξεκινά το flow σας.

Τι μπορεί να κάνει ένα flow όταν φτάσει ένα μήνυμα;

Το trigger δίνει στο flow ένα «επίπεδο» μήνυμα: αποστολέας, όνομα προφίλ, id μηνύματος, τύπος, κείμενο, τυχόν id πολυμέσου, απαντήσεις από κουμπιά και λίστες, και το id του αριθμού τηλεφώνου που το έλαβε. Από εκεί και πέρα είναι ένα συνηθισμένο flow του Activepieces με τα υπόλοιπα pieces, όπως ένα CRM, ένα φύλλο ή ένα βήμα AI.

Οι απαντήσεις χρησιμοποιούν το ίδιο piece. Το Send Message στέλνει ελεύθερο κείμενο και παραδίδεται μόνο μέσα σε 24 ώρες από το τελευταίο μήνυμα του πελάτη. Το Send Template Message στέλνει ένα εγκεκριμένο template, το μόνο που παραδίδεται μετά από αυτό το παράθυρο. Τα διαδραστικά κουμπιά, οι λίστες, τα πολυμέσα, η τοποθεσία και οι αντιδράσεις είναι ξεχωριστές ενέργειες.

Οι οδηγίες του ίδιου του Activepieces σημειώνουν ότι η Meta δέχεται ένα callback URL ανά εφαρμογή. Με προορισμούς ανά αριθμό, το όριο είναι ένα URL ανά αριθμό, οπότε ένα flow που πρέπει να χειρίζεται πολλούς τύπους συμβάντων θα πρέπει να διακλαδώνεται μέσα στο ίδιο flow.

Φτάνουν στο flow οι απαντήσεις που πληκτρολογούνται στο τηλέφωνο;

Φτάνουν στο webhook, αλλά όχι σε αυτό το trigger. Σε έναν αριθμό Coexistence η Meta στέλνει ένα echo κάθε απάντησης που πληκτρολογείται στην εφαρμογή WhatsApp Business στον ίδιο προορισμό, με το πεδίο smb_message_echoes. Το trigger New Incoming Message του piece διαβάζει μόνο το πεδίο messages και απορρίπτει όλα τα υπόλοιπα.

Αν χρειάζεστε στο flow τις απαντήσεις από το τηλέφωνο, ξεκινήστε το με το γενικό piece Webhook του Activepieces, που δέχεται οποιαδήποτε μέθοδο HTTP, και απαντήστε στο GET της επαλήθευσης με ένα βήμα Return Response στο συγχρονο URL του. Στη συνέχεια αναλύετε μόνοι σας το ακατέργαστο payload, με και τα δύο πεδία.

Για τα περισσότερα flows το trigger του piece είναι η απλούστερη επιλογή: αντιδρά στους πελάτες, ενώ οι απαντήσεις της ομάδας παραμένουν ορατές στην εφαρμογή του τηλεφώνου.

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

• Επικόλληση app secret στη σύνδεση WhatsApp. Οι παραδόσεις υπογράφονται με το secret της εφαρμογής EasyCoexistence, οπότε αγνοούνται όλες.
• Ορισμός του προορισμού πριν από τη δημοσίευση του flow. Η Meta επαληθεύει αμέσως και ένα μη δημοσιευμένο flow δεν μπορεί να απαντήσει.
• Η προσδοκία ότι το trigger New Incoming Message θα δει τις απαντήσεις που πληκτρολογούνται στο τηλέφωνο. Διαβάζει μόνο το πεδίο messages, όχι το smb_message_echoes.

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

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