Conexiones
Actualizado el
Conecta los servicios con los que funciona tu negocio, y tu chatbot y sus flujos de trabajo los aprovechan: consultan un pedido, llaman a tu propia API o actúan a través de tu servidor de herramientas, siempre en nombre del cliente con el que hablan.
Todo esto se configura en Tools, en tu panel. Una vez conectado un servicio, el chatbot lo usa cuando una conversación lo necesita, y un paso Use a tool de un flujo de trabajo puede llamar a cualquiera de sus herramientas. Cada llamada aparece en el registro de la conversación.
Tu API
Una acción personalizada es uno de tus propios endpoints HTTP, descrito una sola vez para que el modelo sepa cuándo llamarlo: consultar un pedido, crear un ticket, reservar un horario. La app hace la llamada en nombre del chatbot, así que tu clave de API nunca llega al modelo ni al visitante.
- En Tools, haz clic en el + del recuadro Your API. Se abre la tarjeta Custom actions con una acción nueva para completar; para agregar más después, haz clic en Add action.
- Ponle un nombre, como
get_order_status, y una descripción para el modelo que diga qué hace y cuándo usarla. - Elige el método e ingresa la URL. Un
{param}en la ruta se completa con los parámetros; los demás van en la cadena de consulta si el método es GET, o en el cuerpo JSON si no lo es. - Escribe los parámetros, uno por línea: nombre, tipo, “required” u “optional”, y una descripción, como
order_id, string, required, El número de pedido. - Agrega los encabezados que necesita tu API, como
Authorization: Bearer …. Un valor guardado se muestra como puntos a partir de entonces y nunca se devuelve a tu navegador. - Guarda y luego haz clic en Test para llamarla con valores de ejemplo y ver exactamente lo que recibiría el modelo.
Cada llamada le indica a tu endpoint para quién es: la persona en X-User-Id y la conversación en X-Session-Id, a menos que tú definas esos encabezados. En tu sitio web, la persona es el ID que ChatFrom le da al visitante (visitor: y un ID del navegador), no tu propio usuario; una prueba envía tu ID de usuario de ChatFrom. El chatbot completa los parámetros, y un cliente puede convencerlo de usar cualquier valor, así que si tu endpoint lee o cambia los datos de un cliente, verifica en tu endpoint que esa persona tenga permiso. Para actuar en nombre de tus usuarios con sesión iniciada, usa tu servidor de herramientas.
Tu servidor de herramientas
Si tu producto tiene un servidor MCP, el chatbot puede usar sus herramientas directamente. En Tools, haz clic en el + del recuadro MCP server. En la tarjeta MCP servers que se abre, agrega el nombre y la dirección del servidor, y los encabezados que necesite, como un token. Haz clic en Find tools y marca las herramientas que el chatbot puede usar, hasta 50; el modelo no ve nada más del servidor. Un token se guarda cifrado y se muestra como puntos una vez guardado. La dirección debe ser pública, en internet: ChatFrom comprueba adónde apunta cuando la guardas, y otra vez a medida que avanzan las conversaciones, y deja fuera el servidor mientras apunte a una red privada.
Marca Send the site's signed-in user token to this server en un servidor de tu propio sitio. Cuando la página que incluye el widget pasa un token que firmó para su usuario, tu servidor lo recibe como X-User-Id y puede actuar sobre esa cuenta y ninguna otra. En las apps de chat, los usuarios vinculan su cuenta una vez para lograr lo mismo, como explica la guía Canales.
Zapier
Zapier llega a miles de apps, como Gmail, Slack o Airtable, a través de un servidor MCP propio, así que el chatbot puede redactar un correo o publicar un mensaje con las acciones que elijas.
- En mcp.zapier.com, agrega un servidor MCP, elige Other como cliente y ponlo en modo Managed. Agrega las acciones que el chatbot puede realizar, como “Send a Slack message”.
- En la configuración del servidor, genera un token de API y cópialo. Zapier lo muestra una sola vez.
- En Tools, agrega un servidor MCP llamado
zapiercon la direcciónhttps://mcp.zapier.com/api/v1/connect, y el encabezadoAuthorization: Bearerseguido de tu token. - Haz clic en Find tools, marca las acciones que el chatbot puede usar y guarda.
Usa el modo Managed. En el modo Agentic, la IA podría agregar acciones propias durante una conversación, algo que no debe hacer un chatbot que habla con el público. Al chatbot solo se le ofrecen las acciones que marcaste, y cada una que ejecuta usa dos tareas de tu plan de Zapier.
Usuarios con sesión iniciada en tu sitio
Para que el chatbot actúe en nombre de la persona que inició sesión en tu sitio, la página le da al widget un token que tu servidor firmó para ese usuario, en la misma etiqueta script que copiaste de Deploy.
- Cómo puede ser el token: hasta 1,024 letras, dígitos y
._~-, como un JWT o una cadena base64url. Un token con cualquier otro carácter, como los+,/o=del base64 estándar, se descarta, como si la página no hubiera dado ninguno. - Adónde va: el widget se lo pasa al chat mediante
postMessage, nunca en una URL, así que no queda en los registros de las solicitudes. Solo llega, comoX-User-Id, a los servidores de herramientas que marcaste para él: no al modelo, ni a tus otras herramientas, ni al registro de la conversación. ChatFrom nunca lo lee; tu servidor lo comprueba y actúa solo sobre esa cuenta. - Una página abierta durante horas: llama a
window.ChatFrom.setUserToken(token)con un token nuevo antes de que expire el anterior, y connullcuando el usuario cierre sesión. Lo usan todos los chatbots de la página. - Una app de una sola página: en una página que no debe tener el chatbot,
window.ChatFrom.remove()quita el widget, owindow.ChatFrom.remove(id), uno de varios chatbots. Si agregas de nuevo la etiqueta script, el widget vuelve a aparecer.
Otro servicio
Puedes llegar a cualquier servicio con API a través de tu API, tu servidor de herramientas o Zapier. ¿Necesitas un servicio integrado? Cuéntanos.