Ενσωμάτωση εισερχόμενου Webhook

Δημιουργήθηκε στις15 Μαρτίου, 2021

Το TimelinesAI σάς επιτρέπει να αυτοματοποιήσετε την αποστολή μηνυμάτων WhatsApp ως απάντηση σε γεγονότα ή ενέργειες σε εργαλεία που ήδη χρησιμοποιείτε: CRM, υποστήριξη, συστήματα πρόσληψης κ.λπ.

"Αποστολή μηνύματος" Γεγονός

Είναι δυνατόν να δώσετε εντολή στο TimelinesAI να στείλει ένα μήνυμα (με ή χωρίς συνημμένο αρχείο) σε μια συγκεκριμένη επαφή (μπορεί να είναι μια ομάδα). Εάν στο χώρο εργασίας σας είναι συνδεδεμένοι πολλαπλοί λογαριασμοί WhatsApp, είναι επίσης δυνατό να καθορίσετε έναν συγκεκριμένο λογαριασμό WhatsApp που θα χρησιμοποιηθεί για την αποστολή του μηνύματος.

Για να ρυθμίσετε την ενσωμάτωση, ο ιδιοκτήτης ενός χώρου εργασίας θα πρέπει να μεταβεί στην οθόνη "Integrations / Inbound Webhooks" και να δημιουργήσει νέα διεύθυνση URL. Το εξωτερικό σύστημα θα πρέπει να αποστέλλει μήνυμα σε συγκεκριμένη μορφή (βλ. λεπτομέρειες παρακάτω) στην εν λόγω διεύθυνση URL.

Περιορισμοί

Το μέγιστο μέγεθος συνημμένου αρχείου είναι 2 MB.
Δεν υπάρχει άμεση επικύρωση της μορφής του τηλεφωνικού αριθμού του παραλήπτη ή της σύνδεσής του με το WhatsApp. Πλοηγηθείτε στο UI Χρονοδιαγράμματα για να επαληθεύσετε την κατάσταση αποστολής/ανάγνωσης των μηνυμάτων.

Αποστολή αρχείων μέσω εισερχόμενων Webhooks

Αποστολή ενός αρχείου: Άμεση λήψη έναντι υπηρεσιών φιλοξενίας αρχείων

Είναι επιτακτική ανάγκη να στέλνετε αρχεία χρησιμοποιώντας απευθείας συνδέσμους λήψης. Αυτό επιτρέπει στον παραλήπτη να λάβει πραγματικά το αρχείο.

Ενώ θα πρέπει να χρησιμοποιηθεί μια υπηρεσία φιλοξενίας αρχείων ώστε να μπορεί να παρέχει έναν άμεσο σύνδεσμο λήψης. Ένας τέτοιος σύνδεσμος είναι καλύτερο να δοκιμάζεται μέσω incognito/ιδιωτικής περιήγησης- με την επικόλληση του συνδέσμου στη γραμμή αναζήτησης. Εάν η λήψη του αρχείου ξεκινήσει αμέσως, ο σύνδεσμος είναι αποδεκτός. Εάν, αντίθετα, εμφανίζεται οποιοδήποτε είδος ιστοσελίδας, τότε ο σύνδεσμος δεν μπορεί να χρησιμοποιηθεί για την αποστολή αρχείων.

Η περίπτωση με τους συνδέσμους της υπηρεσίας φιλοξενίας αρχείων είναι ότι τα αρχεία δεν μπορούν να μεταφορτωθούν. Αυτό που κατεβαίνει και αποστέλλεται αντ' αυτού, είναι μια ιστοσελίδα κοινής χρήσης, η οποία μπορεί να οδηγήσει σε ένα "κατεστραμμένο" αρχείο.

Αυτό, με τη σειρά του, θα επηρεάσει το μήνυμά σας, καθώς οι παραλήπτες δεν μπορούν να έχουν πρόσβαση στα μέσα που τους στέλνετε, καθιστώντας τα αρχεία άχρηστα. Συνεπώς, είναι ζωτικής σημασίας να διασφαλίσετε ότι στέλνετε απευθείας συνδέσμους λήψης, καθώς αυτό θα τους επιτρέψει να έχουν πρόσβαση στο αρχείο χωρίς προβλήματα.

Μπορείτε επίσης να εκτελέσετε αυτή τη δοκιμή στέλνοντας ένα μήνυμα webhook σε έναν από τους αριθμούς δοκιμής σας. Θα είστε σε θέση να καθορίσετε πώς θα συμπεριφερθεί το αρχείο με βάση όσα έχουμε εξετάσει εδώ. εάν λάβετε ένα μήνυμα σφάλματος όπως "Το αρχείο είναι κατεστραμμένο", "Μη συμβατό αρχείο" ή "Αποτυγχάνει να φορτώσει το έγγραφο X", αφού κάνετε κλικ στο συνημμένο, τότε πρόκειται για έναν σύνδεσμο υπηρεσίας φιλοξενίας αρχείων και πρέπει να αντικατασταθεί με έναν σύνδεσμο άμεσης λήψης.

Χρήση πιστώσεων

Η αποστολή ενός μηνύματος καταναλώνει 1 πίστωση από την ποσόστωση αποστολής μηνυμάτων.
Η αποστολή ενός μηνύματος με μη κενό κείμενο και συνημμένο καταναλώνει 2 μονάδες από την ποσόστωση αποστολής μηνυμάτων.
Εάν δεν είναι δυνατή η αποστολή ενός μηνύματος (άκυρος ή μη συνδεδεμένος αριθμός WhatsApp, σφάλμα διακομιστή WhatsApp), η ποσόστωση αποστολής μηνυμάτων θα αποκατασταθεί (συνήθως εντός μερικών ωρών).

Ρυθμός αποστολής μηνυμάτων

Τα μηνύματα θα αποστέλλονται με τυχαία καθυστέρηση περίπου 2 δευτερολέπτων μεταξύ κάθε δύο μηνυμάτων (για να αποφευχθούν οι μηχανισμοί ανίχνευσης spam του WhatsApp).
Εάν ενεργοποιήσετε τα webhooks με συχνότητα μικρότερη των 2 δευτερολέπτων, τα μηνύματα μπαίνουν σε ουρά και αποστέλλονται με καθυστέρηση. Κάθε μήνυμα στην ουρά καταναλώνει μια πίστωση αποστολής μηνυμάτων, επομένως ο αριθμός των μηνυμάτων στην ουρά δεν μπορεί να υπερβαίνει τη διαθέσιμη ποσόστωση.

Διαμόρφωση και ενέργειες Webhook

"Webhook ενεργοποιημένο" - επιτρέπει την απενεργοποίηση του webhook χωρίς να το καταργήσετε εντελώς
"Δημιουργία νέας διεύθυνσης URL" - θα δημιουργήσει μια νέα μοναδική διεύθυνση URL, η οποία θα δέχεται ειδοποιήσεις. Η προηγούμενη διεύθυνση URL δεν θα είναι πλέον διαθέσιμη.
"Τελευταίες προσπάθειες αποστολής" - κατάσταση των τελευταίων προσπαθειών ενεργοποίησης webhook
"Download log" - ένα λεπτομερές αρχείο καταγραφής των 100 τελευταίων προσπαθειών ενεργοποίησης, χρήσιμο για την αντιμετώπιση προβλημάτων μορφοποίησης.

Μορφή αίτησης Webhook

Το Webhook δέχεται δεδομένα σε μορφή JSON, μέσω αίτησης POST.

"action" (υποχρεωτική) - επί του παρόντος, υποστηρίζεται μόνο μία πιθανή τιμή "send".
"text" (υποχρεωτικό)- ένα απλό μήνυμα κωδικοποιημένο με UTF-8 προς αποστολή (δεν υποστηρίζεται markdown, εκτός από το διαχωριστικό γραμμής "\n"), μπορεί να παραμείνει κενό, αν έχει καθοριστεί αρχείο.
"file_url" (προαιρετικό) - μια δημόσια προσβάσιμη διεύθυνση URL ενός αρχείου που θα μεταφορτωθεί και θα αποσταλεί ως συνημμένο.
"file_name" (προαιρετικό) - ένα όνομα για το συνημμένο αρχείο (πρέπει να παρέχεται, εάν έχει καθοριστεί η διεύθυνση URL).

Ο παραλήπτης μπορεί να καθοριστεί παρέχοντας μία από τις ακόλουθες παραμέτρους:

"chat_id" - ένα αναγνωριστικό της συνομιλίας όπως εμφανίζεται στο TimelinesAI (μπορεί να βρεθεί στη διεύθυνση URL της σελίδας συνομιλίας ή στο ωφέλιμο φορτίο του εξερχόμενου webhook). Αυτό υποστηρίζει την αποστολή μηνυμάτων σε μια ομάδα.
"jid" - ένα WhatsApp JID που προσδιορίζει την επαφή ή την ομάδα
"phone" - ένας αριθμός τηλεφώνου, διαμορφωμένος σύμφωνα με το διεθνές πρότυπο τηλεφωνικών αριθμών, δηλαδή:
[+][κωδικός χώρας][κωδικός περιοχής][τοπικός αριθμός τηλεφώνου] (για παράδειγμα: +14151231234)
"chat_name" - ένα ακριβές όνομα της συνομιλίας όπως εμφανίζεται στο TimelinesAI

Εάν στο χώρο εργασίας είναι συνδεδεμένοι πολλαπλοί λογαριασμοί WhatsApp, χρησιμοποιήστε την ακόλουθη πρόσθετη παράμετρο για να καθορίσετε το λογαριασμό WhatsApp που θα χρησιμοποιηθεί:

"whatsapp account phone" (προαιρετικό) - προσδιορίζει (ως αριθμό τηλεφώνου, σε διεθνή μορφή) το λογαριασμό WhatsApp για την αποστολή. Εάν παραλειφθεί, για την αποστολή θα χρησιμοποιηθεί ο πιο πρόσφατα συνδεδεμένος ενεργός λογαριασμός WhatsApp στο χώρο εργασίας. Σημείωση: εάν καθοριστεί η παράμετρος "chat_id", το "whatsapp account phone" δεν θα λαμβάνεται υπόψη, επειδή κάθε συνομιλία είναι ήδη συνδεδεμένη με έναν συγκεκριμένο λογαριασμό WhatsApp.

Απάντηση Webhook

Σε περίπτωση επιτυχίας (η αίτηση επικυρώθηκε και έγινε δεκτή για αποστολή), το Webhook θα απαντήσει με κατάσταση HTTP 200 και JSON, που θα περιέχει το message_id του μηνύματος που δημιουργήθηκε:

{
    "status": "success",
    "data": {
        "message_id": "wa_backend:3EB09FCC85FE99662E46"
    }
}

Σε περίπτωση σφάλματος, το Webhook θα απαντήσει με κατάσταση HTTP 40X και JSON με λεπτομέρειες του σφάλματος, για παράδειγμα:

{
"status": 40X,
"data": {},
"message": "Webhook not found"
}

Παραδείγματα

Παράδειγμα 1 - αποστολή μηνύματος μέσω συγκεκριμένου λογαριασμού WA σε συγκεκριμένο αριθμό τηλεφώνου:

{
"action": "send",
"whatsapp account phone" : "+15105566777", 
"phone": "+14151231234", 
"text": "lorem ipsum"
}

Παράδειγμα 2 - αποστολή μηνύματος με κείμενο και συνημμένο σε μια συνομιλία (ή ομάδα) που καθορίζεται από το id:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://150588669.v2.pressablecdn.com/logo.png",
"file_name" : "logo.png"
}

Συγγραφέας
Πρόσφατες αναρτήσεις

admin

Τελευταίες δημοσιεύσεις από admin (δείτε όλες)

Πώς μπορούμε να βοηθήσουμε;