# On API Call

Το **On API Call** ξεκινάει το γράφημα από το *δικό σας* σύστημα — CRM, φόρμα, κουμπί (**Runs when: When an API call is made**). **Δεν** χρειάζεται επισύναψη agent. Τα phone triggers χρειάζονται.

  <ShotPlaceholder
    src="/assets/workflows/on-api-call.png"
    name="wf-api"
    alt="On API Call trigger στον καμβά"
    capture="On API Call canvas."
  />

## Γιατί αυτό το trigger

Μια λίστα σε πρόγραμμα είναι [Campaigns](https://docs.voicelogica.ai/el/outbound-calls/campaigns/). Μία AI outbound κλήση είναι [initiate-call](https://docs.voicelogica.ai/el/outbound-calls/api/). Αυτό είναι "τρέξε αυτόν τον αυτοματισμό τώρα" με JSON body — στείλε email, ενημέρωσε φύλλο, ανοίξτε κόμβους. Βάλτε **Make Outbound Call** στο γράφημα μόνο αν το επόμενο βήμα είναι πραγματικά κλήση.

## Πρώτη ρύθμιση

1. **+ Add Trigger - On API Call**

   Το **Payload Schema** είναι το JSON schema του body που POSTάρεται στο run-workflow endpoint (με το κλειδί API σας). Επικυρώνεται ζωντανά. Προεπιλεγμένο κενό αντικείμενο χωρίς απαιτούμενα πεδία δέχεται οποιοδήποτε αντικείμενο. Δείγμα schemas και βοηθός cURL εμφανίζονται στον πίνακα· δημιουργήστε [κλειδί API](https://docs.voicelogica.ai/el/getting-started/api-keys/) αν χρειάζεστε.

     <ShotPlaceholder
       src="/assets/workflows/on-api-call-form.png"
       name="on-api-call-form"
       alt="Ρυθμίσεις Payload Schema του On API Call"
       capture="On API Call trigger settings."
     />

2. Από **Work Flow Triggered**, προσθέστε κόμβους που διαβάζουν αυτά τα κλειδιά.

3. **Save & go live**. Αντιγράψτε το workflow id από το URL ή τη λίστα.

4. POST με κλειδί API που μπορεί να τρέξει workflows:

   ```
   POST https://api.voicelogica.ai/api/v1/agentic/work-flows/run-workflow/YOUR_WORKFLOW_ID
   ```

   ```http
   x-api-key: YOUR_API_KEY
   Content-Type: application/json
   ```

   ```json
   {
     "order_id": "ORD123",
     "email": "ada@example.com"
   }
   ```

5. Επιβεβαιώστε ότι οι κόμβοι έτρεξαν (email, φύλλο ή builder dry-run πρώτα).

## Αντιμετώπιση προβλημάτων

**Πρέπει να χρησιμοποιήσω initiate-call;**

Χρειάζεστε τον *agent* να μιλήσει σε αριθμό — [initiate-call](https://docs.voicelogica.ai/el/outbound-calls/api/). Χρειάζεστε το *γράφημα* να τρέξει (email, φύλλο, κλάδοι) — αυτό το trigger.

**Το Save είναι μπλοκαρισμένο στο payload schema**

Το schema πρέπει να είναι έγκυρο JSON Schema για το dialect που επικυρώνει ο πίνακας. Ξεκινήστε από το προεπιλεγμένο αντικείμενο ή χρησιμοποιήστε κουμπί δείγματος schema, στη συνέχεια Beautify.

## Επόμενα βήματα

[Get a workflow running](https://docs.voicelogica.ai/el/workflows/) — Save, στη συνέχεια αυτό το POST.  
[Workflow Nodes](https://docs.voicelogica.ai/el/workflow-nodes/) — τι να βάλετε μετά το trigger.  
[API keys](https://docs.voicelogica.ai/el/getting-started/api-keys/) — κλειδί με πεδίο εκτέλεσης workflow.