Publicar un flujo

Un flujo desplegado se puede consumir de muchas formas: llamándolo por API, dejando que lo dispare un correo nuevo en Gmail, poniendo su chat en tu web o publicándolo como servidor MCP. La ventana Acceso a API reúne todas esas formas. Las pestañas que ves en ella dependen de los componentes del flujo: cada componente de entrada añade la suya.

Abrir Acceso a API

En el editor, pulsa Acceso a API en la columna derecha. Arriba eliges:

• Modo de consumo: Producción usa la versión desplegada; Test, el borrador que tienes en el editor. En Test solo aparecen las pestañas cURL y Webhook.
• Clave API: la clave con la que se harán las llamadas. Las pestañas que muestran código o una dirección la llevan ya escrita. Ver Claves API.
• Versión desplegada: qué versión responderá. Si el flujo no tiene ninguna, pulsa Desplegar una versión. Casi todas las formas de publicar la necesitan. Ver Versiones y publicación.

El icono de ayuda junto al título abre Llamar a un flujo por API.

Qué pestaña aparece con cada componente

Si el flujo tiene…	Aparece	Para
Ningún componente de entrada especial	cURL, API Python, API JavaScript	Llamarlo desde tu código. Ver Llamar a un flujo por API.
Chat Output	Chat embebido HTML y Chat Integrado	Poner el chat del flujo en tu web.
Webhook Input	Webhook	Que otra aplicación lo dispare enviando datos a una dirección.
Gmail Webhook, Google Drive, Google Forms, Google Calendar, Outlook Mail, Outlook Calendar, OneDrive, Shopify u Odoo	<Servicio> Webhook	Ejecutarlo cada vez que llega algo nuevo a ese servicio. Ver Webhooks de servicios.
Teams Webhook o Jira Webhook	Teams Webhook / Jira Webhook	Lo mismo, con los eventos de Teams o de Jira.
Telegram Webhook	Telegram	Conectar un bot de Telegram.
WhatsApp Business, Twilio, Instagram o Mailchimp	WhatsApp, WhatsApp/Twilio, Instagram Webhook, Mailchimp Webhook	La dirección que hay que pegar en ese servicio.
MCP Server	MCP Server	Publicar sus herramientas para Claude, Cursor o Visual Studio Code. Ver Publicar como servidor MCP.
A2A Server	A2A Server	Publicarlo como agente para otros agentes. Ver Publicar un agente A2A.
Cualquiera	Rastrear Flujo	Enviar la traza de cada ejecución a LangSmith.

Un flujo con un componente de webhook se dispara siempre por su webhook, así que en ese caso no aparecen cURL, API Python ni API JavaScript. Tampoco aparecen en los flujos con un Voice Agent: a un agente de voz se le llama por teléfono o desde la web, y se publica en la consola de agentes de voz (ver Agentes de voz).

Llamarlo por API

Las pestañas cURL, API Python y API JavaScript dan el código para llamar al flujo, con tu clave y tu servidor ya puestos.

Cómo lanzar la ejecución, consultar su estado, leer el resultado o el stream y los errores están en Llamar a un flujo por API.

El webhook del flujo

La pestaña Webhook muestra la dirección a la que otra aplicación debe enviar sus datos con un POST. La dirección ya lleva tu clave API, codificada, en el parámetro x-api-key. Lo que envía la otra aplicación llega al componente Webhook Input.

Para probarlo sin salir del editor, pulsa Probar Webhook, el botón que aparece abajo en el lienzo. Mientras dice Escuchando …, envía una petición a la dirección: el flujo se ejecuta con lo que llegue y lo ves en el editor.

Qué recibe quien llama, con o sin un componente Webhook Response, está en Webhooks.

Webhooks de servicios

Los componentes de Gmail, Google Drive, Google Forms, Google Calendar, Outlook, OneDrive, Shopify, Odoo, Teams y Jira no esperan a que les llamen: NappAI se suscribe a ese servicio y ejecuta el flujo cada vez que llega algo nuevo. En Gmail, Google, Outlook, OneDrive, Shopify y Odoo, NappAI comprueba si hay novedades cada minuto.

Desde el componente

En las propiedades del componente, debajo de sus campos, aparece el estado de la suscripción y un botón:

• Comprobando estado… mientras NappAI lo consulta.
• Sincronizado: la suscripción está activa y coincide con lo que tiene configurado el componente.
• Desincronizado: todavía no hay suscripción, o has cambiado los filtros del componente (por ejemplo, las etiquetas de Gmail) desde que te suscribiste.

El botón, Suscribirse (o Consumir en Teams y Jira), abre Acceso a API directamente en la pestaña de ese servicio. Necesita que el componente tenga una credencial elegida.

Desde Acceso a API

La pestaña del servicio enseña el mismo estado y compara, campo a campo, lo que tiene el componente con lo que tiene la suscripción. El icono Actualizar vuelve a comprobarlo.

• Si sale Desincronizado, pulsa Suscribirse (en Teams y Jira, Registrar Webhook). Si ya había una suscripción, se actualiza con lo que tiene ahora el componente.
• Si sale Sincronizado, puedes Cancelar suscripción (en Jira, Eliminar Webhook; en Teams, Cancelar registro del Webhook).

Hace falta una versión desplegada

Para suscribirse hay que tener una versión desplegada; sin ella, la pestaña lo avisa y el botón queda desactivado. Cancelar una suscripción se puede siempre. Los avisos que llegan ejecutan la versión desplegada.

El estado compara con el editor

Sincronizado y Desincronizado comparan la suscripción con cómo está ahora el componente en el editor, no con la versión desplegada. Si cambias los filtros, vuelve a suscribirte y despliega una versión nueva para que los avisos lleguen al flujo cambiado.

Telegram

La pestaña Telegram conecta el bot de la credencial elegida en Credencial Telegram. Muestra Consumido si el bot ya envía sus mensajes a este flujo y No consumido si no. Publicar lo conecta, y Actualizar lo vuelve a conectar si cambias de clave o de credencial. Necesita una clave API y una versión desplegada.

WhatsApp, Twilio, Instagram y Mailchimp

Sus pestañas muestran la dirección que debes pegar en la configuración de ese servicio para que envíe sus mensajes o eventos al flujo. La página de cada componente explica dónde se pega.

El chat en tu web

Si el flujo tiene un Chat Output:

• Chat embebido HTML da el código que hay que pegar dentro del <body> de tu página para mostrar el chat del flujo. Los atributos del código (modo, historial, sesión, colores…) vienen explicados en el propio código.
• Chat Integrado configura el chat paso a paso: en General, el nombre de usuario, el modo de visualización (pantalla completa o flotante), el historial, la subida de archivos, la gestión de sesiones o los tweaks; en Apariencia, los temas y colores. Guardar y Lanzar lo abre en una pestaña nueva.

Los dos llevan la clave API elegida arriba, así que cualquiera que vea el código de la página la puede leer. Usa una clave solo para esto y regenérala si se filtra.

MCP y A2A

• Con un componente MCP Server, el flujo se publica como servidor MCP y sus herramientas se pueden usar desde Claude, Cursor o Visual Studio Code. Ver Publicar como servidor MCP.
• Con un componente A2A Server, el flujo se publica como agente al que otros agentes pueden encargar tareas. Ver Publicar un agente A2A.

Agentes de voz

Un flujo con un Voice Agent no se publica en Acceso a API, sino en la consola de agentes de voz: allí eliges si atiende desde la web, por teléfono o en los dos sitios, y obtienes el widget. Ver El menú de agentes de voz y Llamadas salientes.

Ejecutarlo cada cierto tiempo

Para que un flujo se ejecute solo, por ejemplo cada lunes a las 9:00, no hace falta ningún componente: prográmalo en el Programador. Necesita una versión desplegada y una clave API.

Quién puede publicar

Acceso a API necesita poder ver las claves API, y desplegar una versión o suscribir un webhook necesita un rol que pueda editar flujos. Ver Roles y permisos.