Τεκμηρίωση / Agent λειτουργιών

Agent λειτουργιών: εναύσματα

Τι μπορεί να ξεκινήσει μια εκτέλεση (κλήση στο κέντρο, webhook, χρονοπρόγραμμα, άλλος agent, χειροκίνητα) και πώς πιάνετε πραγματικό γεγονός με την Αναμονή.

Τελευταία ενημέρωση:

Ένα έναυσμα είναι το πρώτο κουτί στον πίνακα: αποφασίζει πότε τρέχει η ροή και με ποια δεδομένα ξεκινά. Κάθε είδος εναύσματος μπορεί να εμφανιστεί μία φορά σε έναν πίνακα, και ένας πίνακας μπορεί να έχει πολλά είδη (για παράδειγμα μια κλήση στο κέντρο και μια χειροκίνητη εκτέλεση). Τα εναύσματα ξεκινούν εκτελέσεις μόνο όσο ο agent είναι Ενεργός· μια δοκιμαστική εκτέλεση από τον σχεδιαστή λειτουργεί σε κάθε περίπτωση.

Τέλος κλήσης (κέντρο)#

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

  • caller_number, caller_name, callee_number, callee_name, direction (εισερχόμενη, εξερχόμενη, εσωτερική)
  • duration_sec, status (απαντήθηκε, αναπάντητη κ.λπ.), subject, extension (το όνομα του χρήστη του εσωτερικού)
  • recording_url (ο σύνδεσμος λήψης του κέντρου) και recording_ref (το όνομα αρχείου της ηχογράφησης)
  • call_id, contact_id, contact_number

Μια αναπάντητη κλήση δεν έχει ηχογράφηση. Τα βήματα που τη χρειάζονται (λήψη, απομαγνητοφώνηση, περίληψη, αναφορά) σημειώνονται Παραλείφθηκε: δεν υπάρχει τίποτα να γίνει και η εκτέλεση ολοκληρώνεται κανονικά, οπότε μια αναπάντητη κλήση δεν αφήνει ποτέ μια εκτέλεση να περιμένει επαναλήψεις.

Κρατήστε το recording_url μέσα στη ροή: περιέχει το μυστικό λήψης του κέντρου. Για να ταυτοποιήσετε μια ηχογράφηση σε άλλο σύστημα στείλτε αντί γι' αυτό το recording_ref.

Μία κλήση στο κέντρο μπορεί να ξεκινήσει πολλούς agents: κάθε ενεργός agent με αυτό το έναυσμα τρέχει σε αυτήν.

Λήψη webhook#

Οτιδήποτε μπορεί να στείλει JSON μπορεί να ξεκινήσει τον agent: ο πίνακας δείχνει το δικό του URL του agent στον επιθεωρητή (και στις Ρυθμίσεις). Το σώμα του αιτήματος γίνεται τα δεδομένα του εναύσματος, οπότε ένα πεδίο order_id στο σώμα είναι {{trigger.order_id}} στα βήματα.

Τρέχει σε χρονοπρόγραμμα#

Ξεκινά τη ροή κάθε ώρα, κάθε μέρα στις 09:00, τις καθημερινές στις 09:00, κάθε Δευτέρα στις 09:00, την πρώτη του μήνα στις 09:00 ή με δική σας έκφραση cron, στη ζώνη ώρας που επιλέγετε, το πολύ μία φορά κάθε πέντε λεπτά. Δύο επιλογές:

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

Μετά την αποθήκευση ο σχεδιαστής δείχνει τις εκτιμώμενες εκτελέσεις και το κόστος ανά μήνα, γιατί κάθε εκτέλεση χρεώνει τουλάχιστον 30 δευτερόλεπτα αυτοματισμού. Η Επισκόπηση δείχνει την επόμενη προγραμματισμένη εκτέλεση. Το έναυσμα δίνει scheduled_for, fired_at, cron, timezone και missed_by_s.

Κλήση από άλλον agent#

Ένας άλλος agent λειτουργιών του έργου παραδίδει δεδομένα σε αυτόν, με το Κλήση άλλου agent ή τον Διανομέα. Τα δεδομένα που έστειλε είναι τα δεδομένα του εναύσματος· τα caller_agent και caller_run_id λένε ποιος κάλεσε. Χρησιμοποιήστε το για agents που κάνουν μία δουλειά για πολλούς άλλους.

Χειροκίνητη εκτέλεση#

Ξεκινά τη ροή από την κονσόλα ή το API με δεδομένα που πληκτρολογείτε. Χρήσιμο για πίνακες που τρέχετε κατά παραγγελία, όπως η απομαγνητοφώνηση μίας ηχογράφησης από το URL της.

Αναμονή για το πραγματικό γεγονός#

Τα εναύσματα Λήψη webhook, Τέλος κλήσης (κέντρο) και Κλήση από άλλον agent έχουν κουμπί Αναμονή στον επιθεωρητή. Πατήστε το και μετά προκαλέστε το γεγονός: στείλτε το webhook από το άλλο σύστημα, κάντε και κλείστε μια κλήση στο κέντρο, ή τρέξτε τον πίνακα που καλεί αυτόν. Το επόμενο γεγονός εμφανίζεται στον επιθεωρητή ακριβώς όπως θα το λάμβανε το έναυσμα, μορφοποιημένο, και δεν εκτελείται, ακόμη κι όταν ο agent είναι ανενεργός. Η αναμονή διαρκεί δέκα λεπτά. Πατήστε Χρήση ως δοκιμαστικό φορτίο για να τρέξετε τον πίνακα με αυτά ακριβώς τα δεδομένα.

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

Η κονσόλα

Οι σελίδες αυτές είναι μόνο για ανάγνωση. Η δοκιμαστική κλήση, τα κλειδιά API και η ζωντανή αναφορά API βρίσκονται στην κονσόλα, όπου ο λογαριασμός σας είναι συνδεδεμένος.

Άνοιγμα κονσόλας