Προσθέστε μια διεύθυνση https στο Ενσωματώσεις → Webhooks και ειδοποιήσεις για να λαμβάνετε συμβάντα κλήσεων:
| Συμβάν | Πότε |
|---|---|
call.started | Ο πράκτορας απάντησε |
call.ended | Η κλήση τελείωσε, με τη διάρκεια και τα credits |
call.analyzed | Η σύνοψη, το αποτέλεσμα, τα εξαγόμενα πεδία και η απομαγνητοφώνηση είναι έτοιμα |
call.transcript | Κατά τη διάρκεια της κλήσης, οι νέες γραμμές της απομαγνητοφώνησης κάθε λίγα δευτερόλεπτα |
call.tool_called | Ο πράκτορας κάλεσε μία από τις συναρτήσεις σας: name, arguments, status, durationMs |
call.handed_off | Η κλήση παραδόθηκε σε άλλον πράκτορα: fromAgentId, toAgentId |
call.transferred | Η κλήση μεταφέρθηκε σε άνθρωπο: destination |
call.voicemail | Μια εξερχόμενη κλήση έπεσε σε τηλεφωνητή |
call.do_not_call | Το άτομο σε μια εξερχόμενη κλήση ζήτησε να μην το ξανακαλέσουν: phone |
call.recording_ready | Η ηχογράφηση δύο καναλιών αποθηκεύτηκε: recordingUrl (ισχύει 24 ώρες), durationMs |
call.message_sent | Ο πράκτορας έδειξε κάρτες στην οθόνη ενός καλούντος από web ή εφαρμογή: items, quickReplies |
alert.triggered | Ένας από τους συναγερμούς σας (Webhooks και ειδοποιήσεις → Συναγερμοί) ξεπέρασε το όριό του |
alert.resolved | Ο συναγερμός αυτός επανήλθε στο φυσιολογικό |
Τα συμβάντα που στέλνονται κατά τη διάρκεια μιας κλήσης φέρουν data.call (id, agentId, channel, direction, αριθμοί). Κάθε αίτημα είναι υπογεγραμμένο:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Επαληθεύστε την υπογραφή με το μυστικό του webhook που εμφανίστηκε όταν το δημιουργήσατε, και απαντήστε με κατάσταση 2xx. Οι αποτυχημένες παραδόσεις επαναλαμβάνονται μετά από 1 λεπτό, 5 λεπτά, 30 λεπτά, 2 ώρες και 12 ώρες με το ίδιο σώμα και το ίδιο αναγνωριστικό EvaSay-Delivery, ώστε να μπορείτε να αγνοείτε τις επαναλήψεις. Οι τελευταίες παραδόσεις ενός webhook, με το ακριβές σώμα που στάλθηκε και την κατάσταση που απάντησε το endpoint σας, παρατίθενται από το GET /webhooks/{id}/deliveries και στον πίνακα ελέγχου· το POST /webhooks/{id}/deliveries/{delivery_id} στέλνει ξανά μία.
Εκτός από το email και τα webhooks alert.triggered / alert.resolved, οι συναγερμοί μπορούν να πηγαίνουν σε κανάλι Slack (incoming webhook), σε ρομπότ ομάδας WeCom ή στο Telegram, στο Webhooks και ειδοποιήσεις → Συναγερμοί → Αποστολή επίσης σε.
Δημιουργήστε ένα webhook μέσω POST /webhooks με { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. Η απάντηση περιέχει τη συνδρομή και ένα παραγόμενο μυστικό υπογραφής, που επιστρέφεται μόνο κατά τη δημιουργία. Επαληθεύστε το EvaSay-Signature, αποδιπλασιάστε το EvaSay-Delivery και ενημερώστε το CRM σας. Τα webhooks συμβάντων είναι ασύγχρονες ειδοποιήσεις· τα εργαλεία κατά τη διάρκεια της κλήσης επιστρέφουν τα αποτελέσματα απευθείας στον πράκτορα.