Como conectar a FoneClaw a um bot do Telegram
Crie um bot com BotFather, conecte sua conta privada à FoneClaw, verifique uma tarefa Android suportada e saiba corrigir erros de token, rede e webhook.
- Para conectar FoneClaw a um bot do Telegram, crie um bot dedicado com o @BotFather, guarde o token com cuidado e use esse bot apenas para a conversa com a FoneClaw.
- Depois de salvar o token na tela Telegram Connections, abra seu próprio bot, envie hello em até dez minutos e espere a confirmação de vínculo.
- A conexão do Telegram leva mensagens até a FoneClaw; permissões Android, aprovações aplicáveis e resultado salvo continuam sendo verificados no telefone.
- Erros de token, bot já conectado, rede indisponível e conflito com webhook ou outro leitor pedem correções diferentes; remover um webhook interrompe o endpoint que usava esse bot.
Crie um bot dedicado no Telegram
Conectar FoneClaw a um bot do Telegram é diferente de controlar o aplicativo Telegram por voz. Aqui, você cria um bot privado para enviar pedidos à FoneClaw por conversa. Se o que você quer é operar o app Telegram diretamente com voz no Android, use o guia Controle o Telegram por voz no Android. Neste tutorial, o objetivo é preparar uma entrada de conversa pelo bot.
Consulte o tutorial oficial do Telegram sobre bots e BotFather se quiser confirmar a origem do processo. No app Telegram, converse com o @BotFather, use o comando /newbot, escolha um nome e um nome de usuário para o bot. Ao final, o BotFather entrega um token único. Esse token autentica o bot; ele não é sua senha pessoal do Telegram nem um código de login da sua conta.
Guarde o token como uma credencial privada. Não envie em grupos, não cole em serviços que você não controla e não reutilize um bot que já alimenta outro sistema importante. Um bot dedicado evita conflitos e deixa mais claro qual conversa está ligada à FoneClaw.
Vincule sua conta privada
Na FoneClaw, abra Telegram Connections, a tela de conexões do Telegram. Cole o token no campo BotFather token e toque em Save bot token, o controle para salvar o token. Depois disso, abra no Telegram o bot que você acabou de criar. Não converse com o BotFather nessa etapa: a mensagem precisa ir para o seu próprio bot.
Envie hello para esse bot em até dez minutos e espere a confirmação de vínculo. A conexão é para conversas privadas. A conta do Telegram que envia a primeira mensagem é a conta vinculada; por isso, faça o pareamento usando o seu próprio perfil, não o aparelho ou a conta de outra pessoa.
Se você salvou o token certo, mas enviou a mensagem ao bot errado, a FoneClaw não terá como associar aquela conversa ao token salvo. Se outra pessoa enviar a primeira mensagem, o vínculo pode ir para a conta errada. Se a janela expirar, toque em Connect this chat no telefone, use a nova janela de dez minutos indicada e envie hello ao seu próprio bot.
Confira um resultado Android suportado
Depois da confirmação, experimente uma tarefa simples e sem dado sensível. Um bom primeiro pedido é: “salve comprar filtro de água como tarefa”. O pedido não traz data, dia da semana nem prazo relativo, então o resultado esperado é uma tarefa persistente sem prazo, em vez de uma data inventada.
A conversa pelo Telegram leva o pedido até a FoneClaw, mas o resultado ainda precisa ser verificado no telefone. Quando uma ação precisa de permissão ou aprovação aplicável, confira isso na FoneClaw e no Android. Depois, veja se a tarefa aparece como item salvo.
Se você ainda não completou a primeira configuração da FoneClaw, o guia Como usar um agente de IA grátis no Android com FoneClaw mostra o caminho inicial. Para entender por que um pedido sem prazo fica sem data definida, veja ToDo de IA no Android sem data: salve com segurança.
Diagnostique o erro de conexão
Quando a conexão falha, corrija o erro específico em vez de trocar várias coisas ao mesmo tempo.
| Sinal | Causa provável | O que fazer |
|---|---|---|
| Token rejeitado | Token incompleto, antigo ou copiado do lugar errado | Volte ao @BotFather, copie o token do bot correto e salve novamente |
| Nenhuma confirmação após salvar | A janela de pareamento expirou ou o hello não chegou ao bot correto | Toque em Connect this chat no telefone, use a nova janela de dez minutos indicada e envie hello ao seu próprio bot |
| Bot já conectado | O mesmo bot já está em uso por uma conexão existente | Use um bot dedicado novo ou remova a conexão anterior quando isso for intencional |
| Telegram inalcançável | Rede, bloqueio temporário ou indisponibilidade do serviço | Verifique conexão, tente de novo mais tarde e evite repetir pedidos importantes |
| Conflito com outro leitor ou webhook | Outro serviço já recebe atualizações desse bot | Prefira criar um bot novo; remova o webhook apenas se quiser parar o endpoint atual |
O ponto mais delicado é o webhook. Remover um webhook interrompe a entrega para o serviço que estava usando esse endereço. Se esse bot já atende outro painel, automação ou integração, criar um bot novo para a FoneClaw costuma ser a opção mais limpa.
Pause, retome ou remova a conexão
A tela de conexão inclui Pause connection, para pausar a conexão, e Resume connection, para retomá-la. Pausar ajuda quando você quer interromper temporariamente o recebimento de pedidos pelo bot sem apagar tudo. Depois de pausar, a conexão precisa ser retomada para voltar a aceitar mensagens.
Atualizar o token preserva o pareamento e o histórico de conversa local quando a conexão continua válida para o bot correto. Isso não deve ser usado como atalho para trocar a conta vinculada ou reiniciar uma janela expirada. Quando a janela expirar, use Connect this chat no telefone, siga a nova janela de dez minutos indicada e envie hello ao seu próprio bot.
Remover a conexão apaga o token salvo, as solicitações em fila e os registros de entrega locais. O histórico local de chat é mantido. Essa remoção não revoga o token no Telegram nem muda as credenciais no BotFather; se você quer invalidar o token do bot, faça isso pelo Telegram. Para conferir o escopo público atual, consulte os recursos da FoneClaw. Para instalar ou atualizar o app, use o download da FoneClaw.