Um bot calado tem um de dois problemas, e eles aparecem de formas diferentes:
- As mensagens não chegam. A mensagem do cliente nunca aparece em /conversations. Alguma coisa entre o Telegram e o Omni Octo quebrou.
- As mensagens chegam, e ninguém responde. A mensagem está na thread, e nenhuma resposta vem depois. Alguma coisa decidiu que o agente não devia responder.
Mande uma mensagem para o seu bot do seu próprio Telegram, abra /conversations, e você sabe qual dos dois tem.
As mensagens não chegam
Abra o canal em /channels e olhe primeiro o status dele.
| O que você vê | A causa | A correção |
|---|---|---|
Status Erro, e Informações da plataforma mostra um validationError | A última verificação falhou: o motivo está escrito ali | Corrija o que ele diz e depois aperte Validar. Conecte seu bot do Telegram explica cada motivo. |
| Status Ativa, mas você revogou ou trocou o token no BotFather | O Omni Octo não é avisado quando um token é revogado; ele fica sabendo na próxima verificação | Atualizar credenciais, cole o novo token, Salvar e validar. |
| Status Ativa, e o bot também estava configurado em outra ferramenta | O Telegram envia as mensagens de um bot a um só lugar. A outra ferramenta as levou | Pare de usar o bot lá, depois Atualizar credenciais, cole o mesmo token e Salvar e validar. Isso aponta o bot de volta ao Omni Octo. |
| Status Pendente | O token foi salvo e nunca verificado | Validar. |
| O cliente editou a mensagem dele | Edições não são entregues como mensagens novas | Nada a corrigir: a mensagem original é a que chegou. |
| A mensagem foi enviada em um grupo | O Telegram mostra a um bot apenas algumas mensagens de grupo por padrão | Veja grupos. |
Atualizar credenciais com o mesmo token também é a correção para um bot que foi conectado antes de o Omni Octo começar a registrar bots em Conectar e validar, se ele nunca recebeu uma mensagem: ele roda os dois passos de novo.
As mensagens chegam, e ninguém responde
Abra a conversa.
| O que você vê | A causa | A correção |
|---|---|---|
| ”Nenhum agente de IA responde aqui. Assuma para responder.” | Não há agente no bot | Coloque um — coloque um agente no seu bot. |
| Status Precisa de humano, com “Alguém da sua equipe assumiu esta conversa, então a IA está pausada aqui.” | Um colega assumiu a conversa | Responda, ou aperte Devolver à IA agora. |
| Sem aviso, sem resposta, em todas as conversas | O agente está desligado, ou o workspace está pausado por faturamento | Ligue o agente de novo pela página dele; confira o faturamento nas configurações. |
| A resposta está na thread, marcada como falha | O Telegram se recusou a entregá-la — por exemplo, o cliente bloqueou o bot | Nada do seu lado; o cliente precisa desbloquear o bot. |
Coisas que parecem um problema e não são
- O agente esperou alguns segundos antes de responder a uma foto. Ele espera passar 5 segundos sem chegar nada novo, para responder a um álbum e à pergunta dele juntos — fotos, mensagens de voz e arquivos.
- Um arquivo mostra ”… not available”. Ele passava de 16 MB, ou não pôde ser baixado do Telegram. A mensagem em si chegou, e o agente foi avisado de que um arquivo não pôde ser carregado.
- A conversa começa com
/start. Isso é o que o Telegram envia quando um cliente aperta Start. Ela chega como a primeira mensagem do cliente, e o agente a responde como qualquer outra. Para que seja respondida com uma saudação, diga isso nas instruções do agente.
Para onde ir depois
- Conecte seu bot do Telegram — cada status e cada mensagem de validação.
- Coloque um agente no seu bot — quem responde, e o que pausa o agente.
- Devolva uma conversa à IA — quando o silêncio da IA é porque um colega assumiu a conversa.