For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/el/workflows/on-api-call.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
On API Call
Το On API Call ξεκινάει το γράφημα από το δικό σας σύστημα — CRM, φόρμα, κουμπί (Runs when: When an API call is made). Δεν χρειάζεται επισύναψη agent. Τα phone triggers χρειάζονται.

Γιατί αυτό το trigger
Ενότητα με τίτλο «Γιατί αυτό το trigger»Μια λίστα σε πρόγραμμα είναι Campaigns. Μία AI outbound κλήση είναι initiate-call. Αυτό είναι “τρέξε αυτόν τον αυτοματισμό τώρα” με JSON body — στείλε email, ενημέρωσε φύλλο, ανοίξτε κόμβους. Βάλτε Make Outbound Call στο γράφημα μόνο αν το επόμενο βήμα είναι πραγματικά κλήση.
Πρώτη ρύθμιση
Ενότητα με τίτλο «Πρώτη ρύθμιση»-
+ Add Trigger - On API Call
Το Payload Schema είναι το JSON schema του body που POSTάρεται στο run-workflow endpoint (με το κλειδί API σας). Επικυρώνεται ζωντανά. Προεπιλεγμένο κενό αντικείμενο χωρίς απαιτούμενα πεδία δέχεται οποιοδήποτε αντικείμενο. Δείγμα schemas και βοηθός cURL εμφανίζονται στον πίνακα· δημιουργήστε κλειδί API αν χρειάζεστε.

on-api-call-form -
Από Work Flow Triggered, προσθέστε κόμβους που διαβάζουν αυτά τα κλειδιά.
-
Save & go live. Αντιγράψτε το workflow id από το URL ή τη λίστα.
-
POST με κλειδί API που μπορεί να τρέξει workflows:
POST https://api.voicelogica.ai/api/v1/agentic/work-flows/run-workflow/YOUR_WORKFLOW_IDx-api-key: YOUR_API_KEYContent-Type: application/json{"order_id": "ORD123","email": "ada@example.com"} -
Επιβεβαιώστε ότι οι κόμβοι έτρεξαν (email, φύλλο ή builder dry-run πρώτα).
Αντιμετώπιση προβλημάτων
Ενότητα με τίτλο «Αντιμετώπιση προβλημάτων»Να χρησιμοποιήσω το API initiate-call ή το trigger On API Call του workflow;
Χρησιμοποιήστε το initiate-call όταν θέλετε ο agent να καλέσει έναν αριθμό και να μιλήσει με το άτομο. Χρησιμοποιήστε το trigger On API Call όταν θέλετε να εκτελείται ένα workflow από το σύστημά σας, π.χ. για αποστολή email, ενημέρωση φύλλου ή διακλάδωση με βάση δεδομένα.
Γιατί δεν μπορώ να αποθηκεύσω το workflow On API Call λόγω του payload schema;
Το Payload Schema πρέπει να είναι έγκυρο JSON Schema, και ο πίνακας το ελέγχει καθώς πληκτρολογείτε. Ξεκινήστε από το προεπιλεγμένο κενό αντικείμενο ή από ένα κουμπί δείγματος schema και πατήστε Beautify.
