Telegram

Telegram es el canal más rápido de configurar: un bot tuyo, un token y un código para probar que el chat es tuyo. Tus mensajes caen en Home, ves al bot escribiendo mientras trabaja, y podés mandar notas de voz, fotos y archivos.

Creá el bot

1. En Telegram, abrí @BotFather, mandá /newbot y seguí los pasos: un nombre visible y después un usuario que termine en bot.

2. BotFather te contesta con el token del bot. Tiene esta forma: 123456789:AA…. Guardalo bien: quien lo tenga controla el bot.

Conectalo a APX

Panel

1. Abrí Configuración › Canales. Si ya hay otro canal, usá Agregar canal y elegí Telegram.

2. Pegá el token en Token del bot y elegí Quién responde (tu secretaria, de entrada).

3. Tocá Conectar bot. El estado pasa a Conectado.

Terminal

El token se lee de APX_CHANNEL_TOKEN, nunca de la línea de comandos, así no queda en el historial de la shell:

read -rs APX_CHANNEL_TOKEN && export APX_CHANNEL_TOKEN   # pegá el token y Enter
apx channels add telegram acme-bot --agent nova
unset APX_CHANNEL_TOKEN

acme-bot es el id del canal (minúsculas, números y -); --agent recibe el id de un agente (apx agents los lista).

El token se guarda en tu almacén de secretos (el Llavero en macOS). El panel solo muestra el principio y el final; con Cambiar token lo reemplazás.

Emparejate

El bot todavía no te conoce: para él sos un desconocido más. Vinculá tu cuenta una vez:

1. Escribile cualquier cosa a tu bot desde tu Telegram. Te contesta con un código de 6 números.

2. En Configuración › Canales, en Tu cuenta, escribí el código en Este es mi Telegram y tocá Vincular. (La pantalla del canal en la barra lateral ofrece lo mismo, como Vinculá tu Telegram.)

Desde la terminal es apx pairing me <código>. Poné solo un código que te mandó tu propio bot, nunca uno que te pase otra persona.

Desde ahí, lo que le escribís al bot sos vos: va a Home (o a un chat propio, si pusiste Tus mensajes en Chat propio), con todas las tools y la memoria de tu agente.

APX

La pantalla del canal: contactos y sus chats

Mientras trabaja

Mientras el agente trabaja ves “escribiendo…”, y la respuesta llega como un mensaje normal cuando termina; las respuestas largas se parten en varios mensajes. Tu chat queda libre todo el tiempo: si escribís de nuevo, por defecto tu mensaje se suma al trabajo en curso (ver Mientras el agente trabaja).

Las preguntas que te hace el agente (aprobaciones, opciones) vienen con botones, así que podés aprobar un paso desde el teléfono.

Otras personas

Cualquier otra persona que encuentre tu bot es un desconocido. De entrada (Mandar código) recibe un código y espera hasta que lo aprobás: desde el pedido en Esperando tu aprobación, desde tu aviso, diciéndoselo a tu agente o con apx pairing ok <código>. Podés cambiar a Avisarme, Contestar o Ignorar; mirá A quién le contesta.

Las personas aprobadas son contactos: sus chats están sellados (sin tools, sin nada de tu memoria). Aparecen en Personas en Telegram, donde las podés bloquear u olvidar.

Grupos

El bot también puede atender grupos de Telegram, como un bot de Discord atiende salas de un servidor. Los grupos son opcionales: uno que no está en la lista no existe para APX, así que no se lee ni se guarda, aunque el bot esté ahí.

1. En @BotFather, mandá /mybots, elegí tu bot y después Bot Settings › Group Privacy › Turn off. Con la privacidad activa, Telegram solo le pasa al bot los mensajes del grupo que lo @mencionan o le responden, así que Siempre y Cuando sirve nunca verían el resto. Desactivarla vale para los grupos a los que el bot entra después: si ya está en uno, sacalo y volvé a agregarlo.

2. Agregá el bot al grupo y escribí algo ahí con el canal conectado. Telegram no deja listar los grupos de un bot, así que APX los aprende de lo que llega: que lo agreguen, o cualquier mensaje.

3. En Configuración › Canales, en Grupos, elegí el grupo en Agregar un grupo donde está el bot…. Escribir su ID (un número negativo, -100… en un supergrupo) queda como alternativa.

Cada grupo tiene los mismos modos, palabras que lo llaman, notas, reglas y límites que una sala de Discord (ver Salas del servidor). En Cuando lo llaman, lo llama una @mención del bot, un comando dirigido a él (/help@tu_bot) o una respuesta a uno de sus mensajes. Las respuestas van al grupo, como respuesta al mensaje que contestan, y solo mencionan a las personas que nombra un turno tuyo.

Los grupos son públicos, así que sus turnos van sellados

En un grupo el agente contesta sin memoria y sin nada tuyo, aunque seas vos quien escribe. Los chats privados con el bot no cambian.

Nota

Cuando Telegram convierte un grupo en supergrupo (por ejemplo, al hacer admin a alguien), su ID cambia: volvé a elegirlo de la lista y quitá el viejo.

Un bot por proyecto

El panel configura un bot de Telegram. Si querés un bot aparte para un proyecto, agregalo desde la terminal con su propio id y token, y apuntalo al agente de ese proyecto:

read -rs APX_CHANNEL_TOKEN && export APX_CHANNEL_TOKEN
apx channels add telegram northwind-bot --agent <id-del-agente-del-proyecto>
unset APX_CHANNEL_TOKEN

Después escribile al bot nuevo y vinculate con apx pairing me <código>: Configuración › Canales muestra el primer bot de cada tipo.

Precaución

Cada bot necesita su propio token de BotFather. Dos canales no pueden compartir uno: Telegram entrega los mensajes de un bot a un solo receptor.

apx

❯ apx channels
telegram       telegram  running   @acme_store_bot    agent nova
northwind-bot  telegram  running   @northwind_bot     agent lucia

Para quitar un bot: Quitar este bot en su configuración, o apx channels rm <id>. Su token se va con él.