Deploy
Canales
WhatsApp y Telegram: conexión, trigger y conversaciones.
Un canal conecta un agente a WhatsApp o Telegram. Se administran en Canales.
Tres capas
El modelo tiene tres piezas y separarlas es lo que lo hace manejable:
| Capa | Qué es |
|---|---|
| Conexión | La credencial: un número de WhatsApp, un bot de Telegram. Es del workspace y reutilizable. |
| Trigger | «Cuando llegue un mensaje a esta conexión, responde este agente», más las reglas de acceso. |
| Agente | Quien responde. |
Están separadas porque cambian de forma independiente: re-credencializas un bot sin tocar quién contesta, y cambias quién contesta sin tocar la credencial.
Una conexión sin trigger no responde nada. Al crear una, la consola te lleva a su página para que crees el trigger.
Crear una conexión
Conectar abre un menú de plataforma y luego el formulario. Lo que pide depende de cuál elijas:
- Telegram — el Bot Token que te da @BotFather. El identificador del bot es opcional: en Telegram el token es la identidad y ese campo no lo lee nadie.
- WhatsApp — access token, app secret y verify token, los tres. Un access token sin app secret no puede verificar firmas, así que se guardan juntos o no se guarda nada.
Las credenciales se guardan cifradas y no se muestran de vuelta.
El trigger
En la página de la conexión configuras:
- Agente — sin asignar, el canal no responde. Es la forma de apagarlo sin borrarlo.
- Habilitado.
- Chats permitidos — uno por línea. La lista es fail-closed: vacía, se ignora a todo el mundo.
- Rotación de sesión — un chat de mensajería no termina nunca; sin rotación la sesión acumula transcripción sin límite.
Para conocer el id de un chat, escríbele al bot: el mensaje queda registrado aunque se descarte por la lista.
Telegram en grupos
En un chat directo, escribirle al bot es dirigirse a él, y el bot responde. En un grupo no, y por eso existe «Solo responder cuando me mencionen», activo por defecto.
La lista de permitidos no puede hacer este trabajo: está indexada por chat, así que permitir un grupo autoriza cada mensaje de cada miembro.
Cuentan como dirigirse al bot dos cosas:
- Una @mención de su usuario.
- Una respuesta a algo que dijo el bot.
La segunda es la robusta: va por el id numérico, así que sobrevive a un cambio de nombre en BotFather, cosa que la @mención no.
Cuidado
El modo privacidad de BotFather es un filtro aparte y anterior a este. Con él activo —que es su valor por defecto— Telegram ni siquiera entrega los mensajes que no van dirigidos al bot. Es decir: este interruptor parece funcionar incluso estando apagado. Para probarlo de verdad hay que desactivar el de BotFather primero.
WhatsApp llega por webhook. Cada entrega se verifica por firma sobre el cuerpo crudo, y el enrutado usa el identificador de número de teléfono que la propia entrega trae — una entrega para un identificador desconocido se descarta.
Una conexión sin identificador no es alcanzable, y la consola lo dice.
Conversaciones activas
La página de la conexión lista los chats con sesión abierta, con un control para rotar: descarta el hilo, y el siguiente mensaje empieza una sesión nueva.
Nada se pierde al rotar — los eventos y el costo de la conversación anterior ya estaban guardados.