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í.

wf-apiExpand

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

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 si necesita una.

   

   on-api-call-formExpand

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

   x-api-key: YOUR_API_KEY
   Content-Type: application/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. ¿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 - Guardar, luego este POST.→Workflow Nodes - qué poner después del trigger.→API keys - clave con alcance de ejecución de workflow.→