Κατάλογος συμβάντων

Μορφή payload

Κάθε συμβάν είναι ένα αντικείμενο JSON:

{
  "id": "evt_01HKQN9…",
  "type": "conversation.created",
  "occurred_at": "2026-04-20T14:23:45.123Z",
  "account_id": "7c1d2c6e-…",
  "site_id": "0f3a…",
  "data": { … the resource, in the same shape the API returns it … }
}

Το id είναι η τιμή της κεφαλίδας X-RolChat-Event-Id και μένει σταθερό σε όλες τις επαναλήψεις. Το type είναι <domain>.<noun>.<verb> ή <domain>.<verb> σε snake_case. Το data περιέχει τον πόρο όπως θα τον επέστρεφε το αντίστοιχο endpoint GET, οπότε ένας δέκτης μπορεί να γραφτεί με βάση την αναφορά API και δεν χρειάζεται ποτέ δεύτερο σχήμα.

Οικογένειες συμβάντων

Οικογένεια	Παραδείγματα	Εκπέμπεται όταν
conversation.*	conversation.created, conversation.assigned, conversation.resolved, conversation.reopened, conversation.merged	Μια συνομιλία αλλάζει κατάσταση ή υπεύθυνο
message.*	message.created, message.delivered, message.read, message.failed	Δημοσιεύεται ένα μήνυμα ή αλλάζει η κατάσταση παράδοσής του
crm.*	crm.lead.created, crm.contact.created, crm.contact.updated, crm.contact.merged, crm.deal.stage_changed, crm.deal.won	Αλλάζει ένας υποψήφιος πελάτης, μια επαφή, μια εταιρεία ή μια συμφωνία
ticket.*	ticket.created, ticket.status_changed, ticket.assigned, ticket.sla_breached	Αλλάζει ένα αίτημα
visitor.*	visitor.identified, visitor.cobrowse.requested	Ένας επισκέπτης αναγνωρίζεται ή ζητά συνεδρία cobrowse
marketing.*	marketing.form.submitted, marketing.booking.created, marketing.campaign.sent, marketing.unsubscribed	Φόρμες, κρατήσεις, καμπάνιες
kb.*	kb.article.published, kb.article.unpublished	Αλλαγές στη βάση γνώσης
phone.*	phone.call.started, phone.call.ended, phone.call.recorded, phone.call.transcribed, phone.voicemail.received	Κλήσεις και τηλεφωνητής
automation.*	automation.rule.executed, automation.rule.failed	Εκτελείται ένας κανόνας αυτοματισμού
privacy.*	privacy.consent.granted, privacy.consent.withdrawn, privacy.dsr.received	Συγκατάθεση και αιτήματα υποκειμένων δεδομένων
billing.*	billing.invoice.created, billing.trial_expiring, billing.subscription.changed	Συνδρομή και τιμολόγια
auth.*	auth.api_key.created, auth.api_key.revoked, auth.account.swapped	Συμβάντα λογαριασμού σχετικά με την ασφάλεια
ai.*	ai.usage.recorded	Κάθε κλήση προσαρμογέα AI, με πλήθος tokens

Η ακριβής λίστα μεγαλώνει μαζί με το προϊόν· η οθόνη συνδρομής δείχνει κάθε τύπο που μπορεί να λάβει ο λογαριασμός σας και επιτρέπει φιλτράρισμα ανά τύπο.

Εγγραφή

Οι συνδρομές webhook ανήκουν σε ένα plugin. Στις Ρυθμίσεις → Plugins, ανοίξτε το plugin (ή δημιουργήστε ένα προσαρμοσμένο) και προσθέστε ένα endpoint: URL HTTPS, τους τύπους συμβάντων που θέλετε και προαιρετική λίστα επιτρεπόμενων IP. Το μυστικό υπογραφής εμφανίζεται μία φορά. Οι παραδόσεις, οι επαναλήψεις και τα dead letters για αυτό το endpoint εμφανίζονται στο Αρχείο webhooks του plugin.

Το Plugin Protocol στη σελίδα Plugins περιγράφει πώς ένα plugin δηλώνει στο manifest του τα συμβάντα που χρειάζεται.

Σειρά και παράδοση

• Η παράδοση είναι τουλάχιστον μία φορά. Αφαιρέστε διπλότυπα με βάση το id.
• Τα συμβάντα ενός πόρου αποστέλλονται με τη σειρά, αλλά οι επαναλήψεις μπορούν να αλλάξουν τη σειρά των παραδόσεων. Χρησιμοποιήστε το occurred_at και το updated_at του πόρου αντί για τον χρόνο άφιξης.
• Μια συνδρομή που αποτυγχάνει συνεχώς συσσωρεύει dead letters· περισσότερα από 100 για ένα endpoint ενεργοποιούν ειδοποίηση στην πλευρά του RolChat και εμφανίζουν προειδοποίηση στο αρχείο του plugin.