Mετάβαση στο κύριο περιεχόμενο

Webhooks: Συνδέστε το Smartsupp με το Make, το n8n και τα δικά σας εργαλεία

Ειδοποιήσεις συμβάντων σε πραγματικό χρόνο από το Smartsupp προς οποιοδήποτε URL — ρυθμίστε webhooks, επιλέξτε συμβάντα και συνδεθείτε με το Make ή το n8n μέσα σε λίγα λεπτά.

Συντάχθηκε από: Michal Jindra

Τα webhooks επιτρέπουν στο Smartsupp να στέλνει ειδοποιήσεις σε πραγματικό χρόνο σε οποιοδήποτε URL επιλέξετε — μόλις ανοίξει μια συνομιλία, δημιουργηθεί μια επαφή ή παραδοθεί ένα μήνυμα, το σύστημά σας ενημερώνεται. Αυτό το άρθρο εξηγεί τι είναι τα webhooks, πώς να τα ρυθμίσετε στον πίνακα ελέγχου σας και πώς να τα συνδέσετε με πλατφόρμες αυτοματισμού όπως το Make και το n8n.

Έχουμε χωρίσει το άρθρο σε μερικές ενότητες:

Σε τι χρησιμεύουν τα webhooks;

Ένα webhook είναι ένα αυτόματο μήνυμα HTTP που στέλνει το Smartsupp σε ένα URL της επιλογής σας κάθε φορά που προκύπτει ένα επιλεγμένο συμβάν. Αντί να ελέγχουν περιοδικά για αλλαγές, τα εργαλεία σας λαμβάνουν δεδομένα τη στιγμή που συμβαίνει κάτι.

Στις συνηθισμένες περιπτώσεις χρήσης περιλαμβάνονται:

  • Πλατφόρμες αυτοματισμού — ενεργοποιήστε ροές εργασίας στο Make, στο n8n ή σε παρόμοια εργαλεία για να προσθέτετε επαφές σε ένα CRM, να δημοσιεύετε ειδοποιήσεις στο Slack ή να καταγράφετε δυνητικούς πελάτες σε ένα υπολογιστικό φύλλο

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

  • Ειδοποιήσεις — ειδοποιήστε την ομάδα σας όταν αξιολογούνται συνομιλίες ή όταν αποτυγχάνει η παράδοση μηνυμάτων

Συμβουλή: Τα webhooks είναι διαθέσιμα στο πακέτο Plus και στα ανώτερα πακέτα — το Plus περιλαμβάνει 1 webhook, το Expert περιλαμβάνει 3 και το Ultimate προσφέρει προσαρμοσμένο όριο. Συγκρίνετε πακέτα →


Δημιουργία webhook

Η ρύθμιση ενός webhook απαιτεί μόνο λίγα βήματα στον πίνακα ελέγχου του Smartsupp:

  • 1. Ανοίξτε τις Ρυθμίσεις και μεταβείτε στην ενότητα Webhooks .

  • 2. Πατήστε για να προσθέσετε ένα νέο webhook και εισαγάγετε το URL του τελικού σημείου σας — τη διεύθυνση όπου το Smartsupp θα στέλνει δεδομένα συμβάντων.

  • 3. Επιλέξτε τα συμβάντα που θέλετε να λαμβάνετε (δείτε την πλήρη λίστα στην επόμενη ενότητα).

  • 4. Αποθηκεύστε το webhook. Από εκείνη τη στιγμή, τα επιλεγμένα συμβάντα παραδίδονται ως αιτήματα HTTP POST με ωφέλιμα φορτία JSON.

Σημείωση: Τα webhooks που έχουν ρυθμιστεί προηγουμένως συνεχίζουν να λειτουργούν κανονικά. Γίνονται προσπάθειες ώστε όλα τα υπάρχοντα webhooks να είναι ορατά και διαχειρίσιμα από τη νέα ενότητα του πίνακα ελέγχου.

⚠️ Έχετε δημιουργήσει webhooks στο παρελθόν; Τα παλαιότερα webhooks δεν εμφανίζονται ακόμη σε αυτή την ενότητα — συνεχίζουν να λειτουργούν όπως πριν. Ενοποιούμε το παλιό και το νέο σύστημα, ώστε να μπορείτε να διαχειρίζεστε τα πάντα από ένα σημείο.


Διαθέσιμα συμβάντα

Το Smartsupp μπορεί να ειδοποιεί το τελικό σημείο σας για συμβάντα σε τρεις κατηγορίες. Επιλέξτε μόνο τα συμβάντα που χρειάζεται πραγματικά η ροή εργασίας σας — έτσι διατηρείτε χαμηλό τον φόρτο του τελικού σημείου σας και αποφεύγετε την περιττή κίνηση.

Επαφές

  • contact.created

  • contact.updated

  • contact.acquired

  • contact.banned

  • contact.unbanned

Συνομιλίες

  • conversation.opened

  • conversation.closed

  • conversation.closed_by_contact

  • conversation.rated

  • conversation.agent_assigned

  • conversation.agent_unassigned

  • conversation.agent_joined

  • conversation.agent_left

  • conversation.agent_replied

  • conversation.bot_replied

  • conversation.contact_replied

  • conversation.message_delivered

  • conversation.message_delivery_failed

Επισκέπτες

  • visitor.connected

  • visitor.disconnected

  • visitor.updated

  • visitor.typing

  • visitor.triggered

  • visitor.replied

Σχετικοί πόροι: Τεκμηρίωση προγραμματιστή Smartsupp — πλήρη σχήματα ωφέλιμων φορτίων JSON για κάθε τύπο συμβάντος.


Δοκιμή του webhook σας

Πριν ξεκινήσετε την κανονική λειτουργία, χρησιμοποιήστε την ενσωματωμένη λειτουργία δοκιμής για να επαληθεύσετε ότι το τελικό σημείο σας είναι προσβάσιμο και ότι το σενάριό σας στο Make ή στο n8n έχει ρυθμιστεί σωστά.

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

Συμβουλή: Στο Make, το σενάριό σας πρέπει να είναι ενεργό και να αναμένει δεδομένα πριν στείλετε τη δοκιμή. Στο n8n, ορίστε τον κόμβο Webhook ώστε να χρησιμοποιεί το URL παραγωγής του και βεβαιωθείτε ότι η ροή εργασίας είναι ενεργή.


Παράδοση, επαναπροσπάθειες και ασφάλεια

Το Smartsupp έχει σχεδιαστεί για να παραδίδει αξιόπιστα τα συμβάντα webhook, ακόμη και όταν το τελικό σημείο σας είναι προσωρινά μη διαθέσιμο.

  • Μορφή — όλα τα συμβάντα αποστέλλονται ως αιτήματα HTTP POST με σώμα JSON που περιγράφει το συμβάν και τα δεδομένα του

  • Απόκριση — το τελικό σημείο σας θα πρέπει να αποκρίνεται με κωδικό κατάστασης HTTP 2xx όσο το δυνατόν γρηγορότερα· οι αργές αποκρίσεις μπορούν να καθυστερήσουν τις επαναπροσπάθειες

  • Επαναπροσπάθειες — αν η παράδοση αποτύχει, το Smartsupp επαναλαμβάνει την προσπάθεια με αυξανόμενα διαστήματα αναμονής για έως και 3 ημέρες

  • Αυτόματη απενεργοποίηση — τα τελικά σημεία που αποτυγχάνουν επίμονα απενεργοποιούνται αυτόματα· μπορείτε να τα ενεργοποιήσετε ξανά στον πίνακα ελέγχου ανά πάσα στιγμή

  • Ασφάλεια — κάθε αίτημα webhook υπογράφεται, ώστε να μπορείτε να επαληθεύσετε ότι προήλθε πράγματι από το Smartsupp· ανατρέξτε στο docs.smartsupp.com για λεπτομέρειες σχετικά με την επαλήθευση της υπογραφής

Σημείωση: Αν το τελικό σημείο σας απενεργοποιηθεί λόγω επανειλημμένων αποτυχιών, ενεργοποιήστε το ξανά από τις Ρυθμίσεις → Webhooks αφού διορθώσετε το υποκείμενο πρόβλημα. Το Smartsupp θα συνεχίσει αμέσως την αποστολή συμβάντων.


Σύνδεση του Smartsupp με το Make ή το n8n

Η σύνδεση του Smartsupp με μια πλατφόρμα αυτοματισμού απαιτεί τέσσερα βήματα. Η διαδικασία είναι ίδια για το Make και το n8n — διαφέρει μόνο ο κόμβος ενεργοποίησης.

  • 1. Στο Make, προσθέστε ένα Webhooks → Προσαρμοσμένο webhook ως έναυσμα και αντιγράψτε το URL που δημιουργήθηκε. Στο n8n, προσθέστε έναν κόμβο ενεργοποίησης Webhook και αντιγράψτε το URL παραγωγής του.

  • 2. Στο Smartsupp, μεταβείτε στις Ρυθμίσεις → Webhooks, δημιουργήστε ένα νέο webhook και επικολλήστε το URL που αντιγράψατε.

  • 3. Επιλέξτε τα συμβάντα που χρειάζεστε και αποθηκεύστε το webhook.

  • 4. Πατήστε Αποστολή δοκιμής ώστε το Make ή το n8n να καταγράψει τη δομή των δεδομένων — στη συνέχεια, δημιουργήστε το υπόλοιπο σενάριο ή τη ροή εργασίας σας με βάση αυτή.

Συμβουλή: Στο Make, ενεργοποιήστε το σενάριό σας πριν στείλετε τη δοκιμή — διαφορετικά, τα δεδομένα του webhook δεν θα καταγραφούν. Στο n8n, χρησιμοποιήστε το URL παραγωγής (όχι το URL δοκιμής) κατά τη ρύθμιση του webhook του Smartsupp.


Τι ακολουθεί;

  • Smartsupp REST API — εξερευνήστε το πλήρες API για να διαβάζετε και να γράφετε δεδομένα του Smartsupp μέσω προγραμματισμού.

  • Αυτοματισμοί — ρυθμίστε αυτοματισμούς βάσει κανόνων που ενεργοποιούνται απευθείας μέσα στο Smartsupp, χωρίς εξωτερικό εργαλείο.

  • Επισκόπηση ενσωματώσεων — δείτε όλες τις διαθέσιμες εγγενείς ενσωματώσεις με CRM, πλατφόρμες ηλεκτρονικού εμπορίου και άλλα.

💡 Χρειάζεστε περισσότερη βοήθεια; Επικοινωνήστε με την Ομάδα υποστήριξής μας — θα χαρούμε να σας βοηθήσουμε!

Απαντήθηκε η ερώτησή σας;