Saltar al contenido

Canales

Actualizado el

El chatbot que creaste para tu sitio web también puede responder en WhatsApp, Telegram, Slack, Discord, tu chatbox de Crisp y tu correo de soporte, con el mismo conocimiento, las mismas herramientas y los mismos flujos de trabajo, y todas las conversaciones quedan en el mismo registro.

Antes de empezar, crea tu chatbot y publícalo en Deploy. En estas apps solo responde mientras está en vivo. Cada app se configura en pocos minutos, en la sección Channels de tu panel y en la propia app. Para poner el mismo chatbot dentro de tu propia app para iPhone o iPad, consulta la guía del SDK de iOS.

WhatsAppEl número de WhatsApp de tu negocio, que responde a tus clientes a través de la Cloud API de Meta.TelegramUn bot de Telegram al que la gente escribe, en un chat privado o en un grupo.SlackUna app en tu espacio de trabajo de Slack, en mensajes directos y en hilos.DiscordUn bot en el servidor de Discord de tu comunidad y en mensajes directos.Correo electrónicoReenvía tu dirección de soporte y el chatbot responde en el mismo hilo.CrispResponde en el chatbox de Crisp que ya tienes y transfiere la conversación a tu equipo.

Cuando tu chatbot necesita saber quién es el usuario

Muchos chatbots solo responden preguntas, y en ese caso ya terminaste. Si el tuyo también actúa en nombre de un usuario con sesión iniciada, por ejemplo para mostrar sus proyectos o crear uno, necesita saber quién escribe. En tu sitio web, el widget ya lleva el token de tu usuario con sesión iniciada a tu servidor de herramientas. En Telegram, Slack, Discord, WhatsApp y el correo electrónico no hay ninguna página que lo lleve, así que cada usuario vincula su cuenta una sola vez. (Crisp es la excepción: tu sitio le pasa el token directamente al chatbox, como muestra la guía de Crisp.)

Cómo funciona para tus usuarios

  1. En un chat privado con el bot, envían /connect en Telegram, o connect en un mensaje directo en Slack o Discord. En un grupo, un canal o un servidor, el bot los dirige a un chat privado, para que nadie más vea el enlace.
  2. El bot responde con un botón que lleva a una página de tu sitio.
  3. Inician sesión en tu producto como siempre y confirman que el chat es suyo.
  4. Desde ese momento, en un chat solo con esa persona, el chatbot actúa como ese usuario con sesión iniciada, igual que en el widget de tu sitio web. En un grupo le responde como a cualquiera, así que nada de su cuenta llega a los demás.

Pueden enviar /disconnect o disconnect en cualquier momento para desvincularse. Si desconectas la app en Channels, se desvinculan todos los que se vincularon a través de ella.

Qué agregar a tu producto

Necesitas una sola página nueva. Tu servidor de herramientas no cambia: recibe el mismo token, en el mismo encabezado, que recibe del widget.

  1. Una página que exige iniciar sesión, por ejemplo https://yourapp.com/connect-chatfrom. El botón del chat la abre con ?chatfrom_code=… al final de la dirección.
  2. Muestra quién lo solicita. Pregúntale a ChatFrom a quién pertenece el código y muestra la respuesta con un botón para confirmar, por ejemplo “¿Conectar Telegram @anna a tu cuenta?”.
  3. Cuando el usuario confirme, envía el código a ChatFrom con el mismo tipo de token que tu sitio le da al widget para ese usuario.
A quién pertenece el códigoHTTP
GET https://chatfrom.io/api/channels/link/{code}
La respuestaJSON
{
  "chatbot": "Acme support",
  "channel": "telegram",
  "display_name": "@anna",
  "expires_at": "2026-09-21T18:15:00.000Z"
}
Vincular la cuentaHTTP
POST https://chatfrom.io/api/channels/link/{code}
{
  "user_token": "<el token que le das al widget para este usuario>",
  "account": "anna@example.com"
}

ChatFrom responde { "linked": true }, y el usuario recibe en su chat un mensaje que le confirma que su cuenta quedó vinculada. account es opcional: es el nombre que tu producto le da a la cuenta, y se le muestra al usuario. Un código sirve una sola vez y durante quince minutos; después, las dos llamadas responden 404 y el usuario vuelve a enviar connect. Un 503 significa que ChatFrom no pudo comprobar el código en ese momento, y volver a intentarlo un poco después puede funcionar.

Un boceto de la página, en NodeJavaScript
// La página que abre el botón “Connect your account”. El usuario debe haber iniciado sesión.
app.get("/connect-chatfrom", requireLogin, async (req, res) => {
  const code = req.query.chatfrom_code;
  const who = await fetch(`https://chatfrom.io/api/channels/link/${code}`).then((r) => r.json());
  if (who.error) return res.render("link-expired");
  // Muestra quién lo solicita, para que el usuario pueda comprobar que el chat es realmente suyo.
  res.render("confirm-link", { code, app: who.channel, name: who.display_name });
});

// El usuario hizo clic en “Sí, conectar”. Protege este POST contra solicitudes
// de otros sitios, como cualquier formulario de tu sitio; si no, una página que
// envíe un código por su cuenta vincularía cuentas sin la confirmación.
app.post("/connect-chatfrom", requireLogin, csrfProtection, async (req, res) => {
  const token = signUserToken(req.user.id); // la misma función que genera el data-user-token del widget
  const out = await fetch(`https://chatfrom.io/api/channels/link/${req.body.code}`, {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify({ user_token: token, account: req.user.email }),
  }).then((r) => r.json());
  res.render(out.linked ? "linked" : "link-expired");
});

Deja que tu agente de programación la cree

Si trabajas con un agente de programación como Claude Code, Cursor o Copilot, ábrelo en el código de tu producto y pega este prompt. Crea la página, reutiliza el token que tu widget ya recibe y te dice la dirección que debes ingresar en ChatFrom. El mismo prompt está en la página Channels de tu panel, con el nombre de tu chatbot ya puesto.

Prompt para tu agente de programación
Add a "Connect your chat account" page to our app, so users can link their Telegram, Slack, Discord or WhatsApp chat with our ChatFrom chatbot to their account here. ChatFrom already sends our signed-in users' token to our tool server from the website widget; this page lets a Telegram, Slack, Discord or WhatsApp user hand over the same token once, so the chatbot can act for them in the chat too.

How the flow works:
1. In Telegram, Slack, Discord or WhatsApp, the user sends "connect" to the bot. The bot replies with a button to our page: https://<your app>/connect-chatfrom?chatfrom_code=<code>. The code is one-time and expires after 15 minutes.
2. Our page requires the user to be signed in, using our normal login. If they are not signed in, send them to log in and bring them back to this page with the chatfrom_code kept.
3. Our server asks ChatFrom who the code belongs to:
   GET https://chatfrom.io/api/channels/link/<code>
   200: { "chatbot": "...", "channel": "telegram", "display_name": "@anna", "expires_at": "..." }
   "channel" names the chat app: "telegram", "slack", "discord", "whatsapp", "email" today, and more may come. Accept any value: show the known ones by name and anything else as "your chat app". Never treat an unfamiliar channel as an error. "display_name" is the user's name in that app and may be null when the app would not say; then show a wording without it, such as "Connect this Slack chat to your account?".
   404: { "error": "..." }  (unknown, used or expired code)
   503: { "error": "..." }  (ChatFrom could not check the code just now; offer to try again in a moment)
4. Show a confirmation, for example: "Connect Telegram @anna to your account <their email>?" with a "Yes, connect" button and a "Cancel" link. This step is required: without it, someone could send their own code to another person and link that person's account without them noticing.
5. When they confirm, our server links the account:
   POST https://chatfrom.io/api/channels/link/<code>
   Content-Type: application/json
   { "user_token": "<token for this user>", "account": "<how we name the account, e.g. their email>" }
   200: { "linked": true, "channel": "...", "display_name": "..." }
   404: the code has expired or was already used; tell the user to send "connect" again in the chat.
   400: user_token is missing or not URL-safe.
6. Show a result page: "Linked. You can go back to the chat." The user also gets a message in the chat.

Requirements:
- user_token must be the same kind of token we already give the ChatFrom widget as data-user-token for this user (reuse the function that makes it). ChatFrom never decodes it; it sends it as the X-User-Id header to our tool server (MCP), which already knows how to check it. Do not change the tool server.
- The token can be at most 1024 characters of A-Z, a-z, 0-9 and . _ ~ -.
- Choose its lifetime on purpose. If our widget tokens expire quickly, issue a longer-lived one here, because a linked chat keeps using it until the user unlinks, and the user has to link again when it expires. Our tool server should still reject it when the account is deleted or signed out everywhere.
- Call both ChatFrom endpoints from our server, not from the browser. Never put the token in a URL or log it.
- Protect the confirm POST against cross-site request forgery, as with every other form in our app.
- Treat a 404 from either call as "link expired" with a friendly page, not an error.
- Match the look of our other account pages. No new dependencies unless we already use them.

When it is done:
- Tell me the page's full address, so I can enter it in ChatFrom under Channels, "Your link page".
- Add a short test for the confirm step and for the expired-code case, in the style of our existing tests.
- Explain how to try it: send /connect to the Telegram bot (or "connect" to the Slack app, the Discord bot or the WhatsApp number in a direct message), open the button, sign in, confirm, and check the chat says the account is linked.

En ChatFrom

En Channels, ingresa la dirección de tu página en Your link page y guarda. Hasta que lo hagas, el bot les dice a los usuarios que no vincula cuentas, y sigue respondiendo preguntas generales.

Dos cosas que decidir

  • Mantén el paso de confirmación y protégelo. Permite que el usuario compruebe que el chat es realmente suyo. Sin él, alguien podría enviarle su propio código a otra persona y hacer que esa persona lo vincule a su cuenta sin notarlo. Protege la solicitud de confirmación contra solicitudes de otros sitios, como cualquier formulario de tu sitio; si no, una página que envíe el código por su cuenta se salta la confirmación.
  • Elige cuánto dura el token. Si los tokens que le das al widget expiran después de una hora, un chat vinculado deja de actuar en nombre del usuario al cabo de una hora y el usuario tiene que volver a vincularlo. Para los chats vinculados, emite un token que dure tanto como quieras que un chat vinculado actúe en nombre del usuario, y recházalo en tu servidor cuando el usuario cierre todas sus sesiones o elimine su cuenta.

Qué pueden hacer tus usuarios

En WhatsAppEn TelegramEn SlackEn DiscordEn CrispPor correoQué hace
Cualquier mensaje de textoCualquier mensaje de textoUn mensaje directo, o una mención en un canalUn mensaje directo, o una mención o respuesta en un servidorCualquier mensaje en el chatboxCualquier correo a la direcciónLe hace una pregunta al chatbot
Una foto o un documentoUna foto o un documento, en un chat privadoNo disponibleUn archivo, en un mensaje directoUn archivo en el chatboxNo disponibleEl chatbot lo lee y responde sobre él, si los visitantes pueden adjuntar archivos
new/newnewnewNo disponiblenewEmpieza una conversación nueva
connect/connectconnectconnectNo disponibleconnectVincula su cuenta de tu sitio, en un chat privado
disconnect/disconnectdisconnectdisconnectNo disponibledisconnectLa desvincula

En Crisp no hay comandos: una conversación sigue hasta que pasa un día sin mensajes, como en WhatsApp, Telegram, Slack y Discord; el propio chatbox indica qué usuario inició sesión, y las respuestas por correo y las conversaciones en las que participa tu equipo quedan en manos de tu equipo, en la bandeja de entrada de Crisp. Los archivos dependen del interruptor Visitors can attach files en Deploy: si está activado, el chatbot lee un archivo PDF, de texto, Markdown o CSV, o una foto, enviados en un chat con una sola persona, y toma como pregunta el texto que los acompaña; si está desactivado, pide texto (en Crisp deja el archivo a tu equipo). En un grupo o en un canal de un servidor no se leen archivos, para que un grupo no pueda gastar tus créditos en imágenes. Todo lo demás funciona como en tu sitio web. El chatbot responde con tu conocimiento, usa tus herramientas, transfiere a una persona y cuenta para tu límite mensual. Cuando un flujo de trabajo le pide al usuario que elija algo, las opciones aparecen como botones. Una conversación sigue hasta que pasa un día sin mensajes, o dos semanas por correo, y todas las conversaciones aparecen en Conversations, marcadas con la app de la que vienen.

La primera respuesta de cada conversación empieza con “Estás chateando con un asistente de IA”, en todas las apps. La Ley de IA de la UE exige que se informe a las personas cuando hablan con una IA, salvo que ya sea evidente, así que este aviso está activado a menos que desactives Tell visitors it's an AI assistant en Deploy.

Privacidad

Tu app de Meta y tu número de WhatsApp, el bot de Telegram, la app de Slack, el bot de Discord y tu espacio de trabajo de Crisp te pertenecen, en tu propia cuenta de cada servicio. Los mensajes pasan por ese servicio en tu nombre, así que menciona esos servicios en tu propia política de privacidad, junto a ChatFrom. ChatFrom guarda cifrados sus tokens y secretos, y los tokens de las cuentas vinculadas. Lo que ChatFrom conserva se describe en nuestra política de privacidad y en nuestro acuerdo de tratamiento de datos (DPA).