Ir al contenido
ES
Abrir la app

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

2 min de lectura
Copiar como Markdown
Ver como MarkdownAbrir el archivo .md.md

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

Trigger On API Call en el lienzo
wf-apiExpand

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.

  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.

    Configuración de Payload Schema de On API Call
    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).

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