Telegram Bot

Conecte um Bot do Telegram ao Aillom MEX para atender usuários automaticamente com IA.

Pré-requisito: Um bot criado via @BotFather no Telegram. O processo leva menos de 2 minutos.

1. Criar o Bot no Telegram

No Telegram, inicie uma conversa com o @BotFather e siga os passos:

/newbot
→ Informe o nome: Meu Atendente
→ Informe o username: meu_atendente_bot
→ Você receberá um TOKEN como: 7123456789:AAFxxxxxxxxxxxxxxxx

Guarde o token — você vai precisar dele no próximo passo.

2. Registrar o Canal no MEX

curl -X POST https://api.mex.aillom.com.br/api/telegram \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "meu-bot-telegram",
    "agent_id": "uuid-do-agente",
    "bot_token": "7123456789:AAFxxxxxxxxxxxxxxxx"
  }'

Resposta:

{
  "id": "uuid-do-canal",
  "name": "meu-bot-telegram",
  "status": "active",
  "bot_username": "meu_atendente_bot",
  "agent_id": "uuid-do-agente",
  "created_at": "2025-01-01T00:00:00Z"
}

O MEX configura o webhook do Telegram automaticamente — nenhuma configuração manual é necessária.

3. Verificar o Status

curl https://api.mex.aillom.com.br/api/telegram/{id} \
  -H "Authorization: Bearer SEU_TOKEN"

Status	Descrição
`active`	✅ Bot ativo e recebendo mensagens
`error`	❌ Token inválido ou bot deletado

4. Fluxo de Mensagens

Quando um usuário envia uma mensagem ao bot:

O Telegram encaminha o evento ao webhook do MEX
O MEX identifica o bot e o Agente vinculado
A IA processa com contexto, histórico e conversation_vars
A resposta é enviada via API do Telegram

5. Comandos do Bot (opcional)

Você pode configurar comandos padrão via @BotFather para melhorar a experiência:

/setcommands
→ start - Iniciar atendimento
→ ajuda - Ver opções disponíveis
→ encerrar - Finalizar conversa

Gerenciar Canais

# Listar todos os bots Telegram do Workspace
curl https://api.mex.aillom.com.br/api/telegram \
  -H "Authorization: Bearer SEU_TOKEN"

# Atualizar agente vinculado ou nome
curl -X PUT https://api.mex.aillom.com.br/api/telegram/{id} \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "novo-uuid", "name": "novo-nome"}'

# Deletar canal (remove o webhook do bot automaticamente)
curl -X DELETE https://api.mex.aillom.com.br/api/telegram/{id} \
  -H "Authorization: Bearer SEU_TOKEN"

Recursos Suportados

Recurso	Suporte
Mensagens de texto	✅
Imagens recebidas	✅
Áudio / Voice	✅
Documentos	✅
Grupos e Supergrupos	✅
Inline Keyboards	✅ (via ferramentas do agente)
Channels (broadcast)	❌ Não suportado