Μετάβαση στο περιεχόμενο
Προγραμματιστές
Κανάλια & ενσωματώσεις

Webhooks

Ενημέρωσε τα άλλα εργαλεία σου τη στιγμή που συμβαίνει κάτι στο Entagl.

Επισκόπηση

Ένα webhook είναι ένα σύντομο μήνυμα που στέλνει το Entagl σε ένα άλλο εργαλείο όταν συμβαίνει κάτι στο workspace σου: μια νέα κράτηση, μια κλεισμένη συνομιλία, μια πληρωμένη παραγγελία. Επιλέγεις τα events και επικολλάς τη διεύθυνση ιστού (URL) που σου έδωσε το άλλο εργαλείο. Από εκεί και πέρα, το Entagl στέλνει εκεί τις λεπτομέρειες μέσα σε δευτερόλεπτα, ώστε το CRM, το spreadsheet ή το Make scenario σου να μπορεί να αντιδράσει χωρίς να αντιγράφει κανείς δεδομένα χειροκίνητα. Θα το βρεις στο Κανάλια → Webhooks.

Για developers: αναφορά API
Κάθε endpoint, πεδίο και webhook event, με δείγματα κώδικα.

Δυνατότητες

Επίλεξε τα events που σε ενδιαφέρουν

Τα events είναι οργανωμένα σε ομάδες: Επαφές, Συνομιλίες, Μηνύματα, Παραδόσεις στην ομάδα σου, AI agent, Κρατήσεις, Υπενθυμίσεις, Παραγγελίες, Προϊόντα, Κλήσεις, Campaigns, Forms, Λογαριασμός και channels, και Ρυθμίσεις workspace. Άνοιξε μια ομάδα και τσέκαρε μεμονωμένα events ή πάτησε Επιλογή όλων για να πάρεις ολόκληρη την ομάδα. Δεν είσαι σίγουρος πού ανήκει κάτι; Πληκτρολόγησε στο πεδίο αναζήτησης, για παράδειγμα «booking» ή «tag». Πάτησε οποιοδήποτε event για να δεις ένα παράδειγμα του ακριβώς τι θα στείλει το Entagl. Ορισμένα events σού επιτρέπουν επίσης να επιλέξεις από πού προέρχονται, ώστε να λαμβάνεις μόνο τις κρατήσεις που έκανε το AI σου και να παραλείπεις όσες καταχώρισε η ομάδα σου στο ημερολόγιο.

Incoming and Outgoing message: διάβασε πρώτα την προειδοποίηση

Τα Εισερχόμενο μήνυμα και Εξερχόμενο μήνυμα ενεργοποιούνται για κάθε μεμονωμένο μήνυμα. Σε έναν πολυάσχολο λογαριασμό αυτό μπορεί να είναι χιλιάδες την ημέρα. Γι’ αυτό το Επιλογή όλων τα παραλείπει: πρέπει να τα τσεκάρεις ένα ένα, δίπλα σε μια προειδοποίηση. Ενεργοποίησέ τα μόνο αν το εργαλείο στην άλλη πλευρά μπορεί να αντέξει τόσο όγκο. Αν θέλεις απλώς να ξέρεις πότε ξεκινά ή τελειώνει μια συνομιλία, τα Η συνομιλία άνοιξε και Η συνομιλία έκλεισε είναι πολύ πιο ήσυχα.

Τα δεδομένα πελατών μένουν εκτός, εκτός αν τα επιτρέψεις

Δύο διακόπτες καθορίζουν πόσες πληροφορίες πελατών φεύγουν από το Entagl. Το Συμπερίληψη περιεχομένου μηνύματος προσθέτει όσα έγραψαν οι πελάτες: μηνύματα, σημειώσεις και περιλήψεις κλήσεων. Το Συμπερίληψη στοιχείων επικοινωνίας προσθέτει το όνομα, το τηλέφωνο και το email του πελάτη. Και τα δύο ξεκινούν απενεργοποιημένα. Παίρνεις παρ’ όλα αυτά κάθε event και χωρίς αυτά, με ένα contact ID εκεί όπου θα ήταν οι λεπτομέρειες. Μόνο ο ιδιοκτήτης του workspace ή ένας admin μπορεί να τα ενεργοποιήσει, και μόνο αν το εργαλείο λήψης επιτρέπεται να αποθηκεύει δεδομένα πελατών. Σε workspace με HIPAA τα δεδομένα πελατών δεν αποστέλλονται ποτέ, ό,τι κι αν δείχνουν οι διακόπτες.

Συνδεδεμένες εφαρμογές

Εργαλεία και developers μπορούν να καταχωρούν τα δικά τους webhooks μέσω του API του Entagl, και εμφανίζονται από μόνα τους στις Συνδεδεμένες εφαρμογές. Για καθεμία βλέπεις σε πόσα events ακούει και πότε έλαβε το τελευταίο. Μπορείς να ανοίξεις τις Πρόσφατες παραδόσεις της, να χρησιμοποιήσεις Παύση και Συνέχιση, ή Αφαίρεση. Τα Make scenarios έχουν τη δική τους σελίδα: Κανάλια → Make.

Δες τι στάλθηκε και στείλε το ξανά

Πάτησε Πρόσφατες παραδόσεις για να δεις τα τελευταία 50 events που το Entagl προσπάθησε να στείλει, με τα νεότερα πρώτα. Κάθε ένα δείχνει αν έφτασε, την απάντηση που έδωσε το εργαλείο σου (όπως 200 ή 500), πόσες προσπάθειες χρειάστηκαν και πότε είναι η επόμενη προσπάθεια. Όταν μια παράδοση έχει αποτύχει οριστικά, διόρθωσε το πρόβλημα από τη δική σου πλευρά και πάτησε Αποστολή ξανά. Το Entagl το στέλνει μέσα σε λίγα δευτερόλεπτα.

Επαναλήψεις και τι συμβαίνει όταν ένα εργαλείο συνεχίζει να αποτυγχάνει

Αν το εργαλείο σου δεν λειτουργεί ή απαντά με σφάλμα, το Entagl προσπαθεί ξανά μετά από 30 δευτερόλεπτα, 2 λεπτά, 10 λεπτά, 1 ώρα, 6 ώρες και 24 ώρες. Αυτό είναι περίπου 31 ώρες πριν μια παράδοση σημειωθεί ως αποτυχημένη. Αν μια συνδεδεμένη εφαρμογή συνεχίσει να αποτυγχάνει για 3 συνεχόμενες ημέρες, το Entagl τη βάζει σε παύση και στέλνει ειδοποίηση στον ιδιοκτήτη του workspace. Διόρθωσε το εργαλείο και μετά πάτησε Συνέχιση. Αν το Make αναφέρει ότι το webhook ενός scenario δεν υπάρχει πια, το Entagl σταματά αμέσως να στέλνει εκεί.

Έλεγξε ότι ένα αίτημα προήλθε πραγματικά από το Entagl

Κάθε αίτημα περιέχει μια υπογραφή στο header X-Entagl-Signature, που δημιουργείται με το signing secret σου. Ο developer σου τη χρησιμοποιεί για να αποδείξει ότι το αίτημα προήλθε από το Entagl και ότι κανείς δεν το άλλαξε στη διαδρομή.

  • Τα Connected apps και webhooks που δημιουργούνται μέσω του API στέλνουν t=1767225600,v1=5257a869…. Το t δείχνει πότε στάλθηκε, σε δευτερόλεπτα. Κάθε v1 είναι ένα HMAC-SHA256 του κειμένου timestamp.body (η τιμή t, μια τελεία και μετά το ακατέργαστο body του αιτήματος), φτιαγμένο με το secret σου. Απόρριψε κάθε αίτημα του οποίου το t είναι παλαιότερο από 5 λεπτά, ώστε ένα παλιό αίτημα να μην μπορεί να επαναληφθεί. Αμέσως μετά από αλλαγή secret μπορεί να δεις δύο τιμές v1: αποδέξου το αίτημα αν ταιριάζει έστω μία.
  • Το webhook που ρύθμισες σε αυτή τη σελίδα στέλνει sha256= ακολουθούμενο από ένα HMAC-SHA256 του ακατέργαστου body του αιτήματος.

Συχνές εργασίες

Σύνδεση webhook

Περίπου 3 λεπτά
  1. Πήγαινε στα Κανάλια και άνοιξε τα Webhooks.
  2. Επικόλλησε το URL που σου έδωσε το άλλο εργαλείο στο URL του webhook. Πρέπει να ξεκινά με https://.
  3. Στα Συμβάντα, τσέκαρε όσα θέλεις να λαμβάνεις. Άφησε τους δύο διακόπτες δεδομένων πελατών κλειστούς, εκτός αν το εργαλείο λήψης χρειάζεται πραγματικά ονόματα ή μηνύματα.
  4. Αποθηκεύστε. Αντιγράψτε το signing secret από το παράθυρο που ανοίγει και φυλάξτε το σε ασφαλές μέρος. Εμφανίζεται μόνο μία φορά.
  5. Ελέγξτε ότι ο διακόπτης στο επάνω μέρος της κάρτας είναι ενεργός και δείχνει Ενεργό. Τα events αρχίζουν να ρέουν από εκείνη τη στιγμή.

Δοκιμάστε το webhook σας

Περίπου 1 λεπτά
  1. Ανοίξτε Κανάλια → Webhooks και βρείτε το Δοκιμή παράδοσης.
  2. Πατήστε Αποστολή δοκιμής. Το Entagl στέλνει αμέσως ένα δείγμα event στο URL σας.
  3. Δείτε το αποτέλεσμα. Το Η δοκιμή παραδόθηκε σημαίνει ότι το εργαλείο σας απάντησε. Αν απέτυχε, το μήνυμα θα σας πει γιατί (για παράδειγμα timeout), ώστε να το διορθώσετε και να δοκιμάσετε ξανά.

Συμβουλές

Κάθε request έχει ένα event ID στο header X-Entagl-Event-Id. Αν έρθει retry για κάτι που το εργαλείο σας έχει ήδη χειριστεί, χρησιμοποιήστε αυτό το ID για να το παραλείψετε.
Στο webhook που ρυθμίζετε σε αυτή τη σελίδα, τα Δημιουργήθηκε κράτηση και Προστέθηκαν έγγραφα κράτησης στέλνονται μία φορά, τη στιγμή που συμβαίνουν, χωρίς το retry schedule. Φροντίστε το URL να είναι προσβάσιμο.
Απαντήστε γρήγορα. Το εργαλείο σας πρέπει να επιστρέφει κωδικό επιτυχίας (οποιοδήποτε 2xx) μέσα σε 5 δευτερόλεπτα και να κάνει τις αργές εργασίες μετά. Μια αργή απάντηση μετρά ως αποτυχία και γίνεται retry.
Η Παύση είναι η ήπια επιλογή: η σύνδεση παραμένει, τίποτα δεν στέλνεται και το Συνέχιση συνεχίζει πάλι με νέα events. Το Αφαίρεση διαγράφει τη σύνδεση.

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

Ήταν χρήσιμη αυτή η σελίδα;