# On API Call

**On API Call** inicia el grafo desde *su* sistema - CRM, formulario, botón (**Runs when: When an API call is made**). **No** necesita adjuntarse a un agent. Los triggers de teléfono sí.

  <ShotPlaceholder
    src="/assets/workflows/on-api-call.png"
    name="wf-api"
    alt="Trigger On API Call en el lienzo"
    capture="Lienzo On API Call."
  />

## Por qué este trigger

Una lista en un horario es [Campaigns](https://docs.voicelogica.ai/es/outbound-calls/campaigns/). Una única llamada saliente de IA es [initiate-call](https://docs.voicelogica.ai/es/outbound-calls/api/). Esto es "ejecutar esta automatización ahora" con un cuerpo JSON - enviar email, actualizar una hoja, expandir nodos. Coloque **Make Outbound Call** en el grafo solo si el siguiente paso es realmente una llamada.

## Primera configuración

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

   **Payload Schema** es el esquema JSON del cuerpo POSTado al endpoint run-workflow (con su clave API). Validado en vivo. El objeto vacío predeterminado sin campos requeridos acepta cualquier objeto. Aparecen esquemas de muestra y un ayudante de cURL en el panel; cree una [clave API](https://docs.voicelogica.ai/es/getting-started/api-keys/) si necesita una.

     <ShotPlaceholder
       src="/assets/workflows/on-api-call-form.png"
       name="on-api-call-form"
       alt="Configuración de Payload Schema de On API Call"
       capture="Configuración del trigger On API Call."
     />

2. Desde **Work Flow Triggered**, agregue nodos que lean esas claves.

3. **Save & go live**. Copie el workflow id de la URL o la lista.

4. POST con una clave API que pueda ejecutar 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. Confirme que los nodos se ejecutaron (email, hoja, o una ejecución en seco del constructor primero).

## Solución de problemas

**¿Debería usar initiate-call?**

¿Necesita que el *agent* hable con un número? - [initiate-call](https://docs.voicelogica.ai/es/outbound-calls/api/). ¿Necesita que el *grafo* se ejecute (email, hoja, ramas)? - este trigger.

**Guardar está bloqueado en el payload schema**

El esquema debe ser un JSON Schema válido para el dialecto que valida el panel. Comience desde el objeto predeterminado, o use un botón de esquema de muestra, luego Beautify.

## Próximos pasos

[Ejecutar un workflow](../index.mdx) - Guardar, luego este POST.  
[Workflow Nodes](https://docs.voicelogica.ai/es/workflow-nodes/) - qué poner después del trigger.  
[API keys](https://docs.voicelogica.ai/es/getting-started/api-keys/) - clave con alcance de ejecución de workflow.