# On API Call

**On API Call** startet den Graph von *Ihrem* System – CRM, Formular, Button (**Runs when: When an API call is made**). Es benötigt **keine** Agent-Zuordnung. Phone-Trigger tun dies.

  <ShotPlaceholder
    src="/assets/workflows/on-api-call.png"
    name="wf-api"
    alt="On API Call Trigger auf dem Canvas"
    capture="On API Call Canvas."
  />

## Warum dieser Trigger

Eine Liste nach Zeitplan ist [Campaigns](https://docs.voicelogica.ai/de/outbound-calls/campaigns/). Ein einzelner KI-Ausgangsanruf ist [initiate-call](https://docs.voicelogica.ai/de/outbound-calls/api/). Dies ist „führe diese Automatisierung jetzt aus" mit einem JSON-Body – E-Mail senden, ein Sheet aktualisieren, Knoten auffächern. Setzen Sie **Make Outbound Call** nur dann auf den Graph, wenn der nächste Schritt tatsächlich ein Anruf ist.

## Erste Einrichtung

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

   **Payload Schema** ist das JSON-Schema des an den run-workflow-Endpunkt geposteten Body (mit Ihrem API-Schlüssel). Live validiert. Standard-Leerobjekt ohne erforderliche Felder akzeptiert jedes Objekt. Beispiel-Schemas und ein cURL-Helfer erscheinen im Panel; erstellen Sie einen [API key](https://docs.voicelogica.ai/de/getting-started/api-keys/), wenn Sie einen benötigen.

     <ShotPlaceholder
       src="/assets/workflows/on-api-call-form.png"
       name="on-api-call-form"
       alt="On API Call Payload Schema Einstellungen"
       capture="On API Call Trigger Einstellungen."
     />

2. Von **Work Flow Triggered**, fügen Sie Knoten hinzu, die diese Schlüssel lesen.

3. **Save & go live**. Kopieren Sie die Workflow-ID aus der URL oder der Liste.

4. POST mit einem API-Schlüssel, der Workflows ausführen kann:

   ```
   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. Bestätigen Sie, dass die Knoten gelaufen sind (E-Mail, Sheet oder zuerst ein Builder-Dry-run).

## Fehlerbehebung

**Sollte ich initiate-call verwenden?**

Benötigen Sie, dass der *Agent* mit einer Nummer spricht – [initiate-call](https://docs.voicelogica.ai/de/outbound-calls/api/). Benötigen Sie, dass der *Graph* läuft (E-Mail, Sheet, Verzweigungen) – dieser Trigger.

**Speichern ist beim Payload-Schema blockiert**

Das Schema muss ein gültiges JSON-Schema für den Dialekt sein, den das Panel validiert. Beginnen Sie mit dem Standard-Objekt, oder verwenden Sie einen Beispiel-Schema-Button, dann Beautify.

## Nächste Schritte

[Workflow in Betrieb nehmen](https://docs.voicelogica.ai/de/workflows/) - Speichern, dann dieser POST.  
[Workflow Nodes](https://docs.voicelogica.ai/de/workflow-nodes/) - was nach dem Trigger kommt.  
[API keys](https://docs.voicelogica.ai/de/getting-started/api-keys/) - Schlüssel mit Workflow-Run-Scope.