For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/es/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 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í.

Por qué este trigger
Sección titulada «Por qué este trigger»Una lista en un horario es Campaigns. Una única llamada saliente de IA es initiate-call. 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
Sección titulada «Primera configuración»-
+ 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 si necesita una.

on-api-call-form -
Desde Work Flow Triggered, agregue nodos que lean esas claves.
-
Save & go live. Copie el workflow id de la URL o la lista.
-
POST con una clave API que pueda ejecutar 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"} -
Confirme que los nodos se ejecutaron (email, hoja, o una ejecución en seco del constructor primero).
Solución de problemas
Sección titulada «Solución de problemas»¿Debo usar initiate-call o el trigger On API Call?
Si necesita que el agent hable con un número, use initiate-call. Si necesita que se ejecute el workflow (email, hoja, ramas), use el trigger On API Call.
¿Por qué no puedo guardar mi workflow On API Call por el payload schema?
El esquema debe ser un JSON Schema válido para el dialecto que valida el panel. Empiece desde el objeto predeterminado o desde un botón de esquema de ejemplo y luego haga clic en Beautify.
