O Telegram é o canal certo quando o Slack não é uma opção — você está fora do tenant do Slack do espaço de trabalho, está colaborando com um grupo que vive no Telegram, ou quer um canal de mensagens diretas leve com o Okou, separado do Slack do seu time.
O bot é seu. Cada bot do Telegram fica ligado a um único agente no seu espaço de trabalho do Okou, então um bot pessoal e um bot do time podem levar a agentes diferentes, com workflows diferentes.
Conectando
- Fale com o @BotFather no Telegram. Rode
/newbot, dê um nome ao seu bot e copie o token que o BotFather entregar. - No Okou, abra Where Okou works e escolha Telegram.
- Cole o token do bot. Escolha para qual agente ele deve rotear.
- (Para uso em grupo) Desative o privacy mode do bot no BotFather:
/setprivacy→ escolha seu bot → Disable. Sem isso, o bot só enxerga mensagens que o mencionam diretamente com @; com o modo desativado, ele lê o contexto do grupo em volta das menções e respostas. - Abra o Telegram e mande uma mensagem para o bot. A primeira mensagem inicia um chat vinculado no Okou.
Como usar o Okou no Telegram
Dois padrões principais:
Mandar mensagem direta ao bot. Funciona como uma conversa privada com o Okou. Mensagens, arquivos, fotos — o Okou vê tudo. Cada thread de mensagem direta corresponde a um chat no Okou.
Adicionar o bot a um grupo. Com o privacy mode desativado, o bot lê as mensagens ao redor das menções e respostas. Mencione o bot com @ ou responda às mensagens dele para manter o fio. Os outros participantes do grupo nunca veem o raciocínio do Okou, só o resultado que o bot publica de volta.
Fluxos comuns no Telegram
- Triagem da caixa de entrada pelo celular. No trem, mande mensagem para o seu bot: "resuma meu Slack não lido do #cs." O Okou responde em segundos.
- Grupos de fornecedores ou parceiros. Adicione o bot a um grupo com pessoas de fora da sua empresa. O bot cuida de agendamento, lembretes ou tradução sem expor seu Slack interno.
- Um bot por agente. Ligue um bot de pesquisa ao seu agente de pesquisa e um bot pessoal ao seu agente pessoal. Mesmo aplicativo do Telegram, bots diferentes, agentes diferentes.
Roteamento por agente
Cada token de bot está ligado a exatamente um agente. Se você quiser outro agente respondendo, crie um segundo bot no BotFather e ligue esse. Isso é proposital: nessa superfície, a identidade de um bot do Telegram é a identidade do agente.
Suporte a arquivos
O Telegram aceita fotos, mensagens de voz, documentos e PDFs. O Okou ingere todos como entradas do chat. Os arquivos de saída — os artefatos que o Okou produz — voltam como documentos do Telegram ou como imagens exibidas ali mesmo.
Tropeços comuns
- O bot não responde no grupo. O privacy mode ainda está ligado. Rode
/setprivacyde novo no BotFather → Disable, depois remova o bot do grupo e adicione outra vez. - O agente errado responde. O token do bot está ligado a um único agente. Para mudar, troque o vínculo em Where Okou works ou use um bot separado.
- Token do bot vazou. Gere outro no BotFather (
/revoke) e atualize o token no Okou. O antigo para de funcionar na hora.
O que vem depois
- Veja Workflows para registrar o trabalho móvel recorrente.
- Veja Permissions para o que o Okou pode e não pode fazer pelo seu bot.
