# Telegram (Beta) Conecte sua conta existente do Telegram à plataforma para que suas conversas no Telegram fluam diretamente para o aplicativo e um Agente de IA possa responder. Você se conecta inserindo seu número de telefone e um código de login — da mesma forma que adicionaria o Telegram em um novo dispositivo. > **Beta.** O Telegram agora está disponível para todos, mas ainda é novo — espere algumas imperfeições ocasionais enquanto o refinamos. Se algo não funcionar como descrito, informe o suporte. --- ## O que é a integração com o Telegram? A integração com o Telegram vincula sua conta pessoal do Telegram à plataforma usando o próprio fluxo de login do Telegram. Não há bot para criar nem número de telefone separado para comprar — você faz login com a conta do Telegram que já usa, e seus chats individuais ficam disponíveis dentro do aplicativo. Isso é ideal para empresas que já conversam com clientes no Telegram e desejam um Agente de IA, Transmissões e uma caixa de entrada compartilhada além da conta que já possuem. > **Importante — leia antes de conectar.** Esta é uma integração **não oficial** que automatiza uma **conta pessoal do Telegram**. As regras do Telegram desencorajam a automação e o envio de mensagens em massa ou não solicitadas, e contas que violam essas regras podem ser **restringidas ou banidas permanentemente** (em alguns casos, o próprio número de telefone pode ser bloqueado para novos registros). Use este canal apenas para enviar mensagens a pessoas que **já entraram em contato com você ou são contatos salvos**, mantenha volumes baixos e deixe a IA responder em um ritmo natural. **Não** o utilize para prospecção fria em massa. --- ## Telegram vs. WhatsApp Web Ambos conectam uma conta que você já possui, sem uma API oficial de negócios. | Recurso | Telegram | WhatsApp Web | |---|---|---| | **Configuração** | Insira o número de telefone + código de login | Emparelhe seu telefone (QR ou código de emparelhamento) | | **Tipo de conta** | Sua conta pessoal do Telegram | Seu WhatsApp pessoal/comercial | | **Custo por mensagem** | Gratuito | Gratuito | | **Mensagens de modelo** | Não aplicável | Não suportado | | **Indicadores de digitação** | Suportado | Suportado | | **Mídia (entrada)** | Fotos, documentos, notas de voz | Fotos, documentos, notas de voz | | **Suporte oficial** | Integração não oficial | Integração não oficial | | **Ideal para** | Empresas já ativas no Telegram, contatos calorosos/existentes | Empresas no WhatsApp, início rápido | > **Mesmo número em ambos?** Sim. Se o mesmo número de telefone estiver no Telegram e no WhatsApp (Web), você pode conectá-lo como **ambos** os canais — eles funcionam como duas conexões separadas na página Canais, cada uma com seu próprio status, aquecimento e limites. Conectar um não afeta nem substitui o outro. --- ## Configurando o Telegram ### Passo 1: Abra o Fluxo de Conexão 1. Na barra lateral esquerda, clique em **Settings** perto da parte inferior. 2. Na barra lateral de Settings, em **Channels**, clique em **Channels**. 3. Encontre o cartão **Telegram** — ele contém um aviso de **Beta** — e clique em **Connect**. ### Passo 2: Insira seu número de telefone 1. Digite o número de telefone da conta do Telegram que você deseja conectar, incluindo o código do país (por exemplo, `555 123 4567`). 2. Ative **Importar conversas existentes** se você quiser trazer suas conversas individuais recentes do Telegram como contatos, para não começar com uma caixa de entrada vazia. (Ativar isso também permite que você controle **Manter IA pausada para conversas importadas** — recomendado e ativado por padrão, para que a importação do seu histórico nunca acione respostas automáticas para mensagens antigas. Desative por contato posteriormente quando estiver pronto.) 3. Clique em **Enviar Código de Login**. 4. O Telegram envia um código de login **para o seu aplicativo Telegram** (geralmente chega como uma mensagem do chat de serviço oficial "Telegram", nem sempre como um SMS). ### Passo 3: Insira o código de login 1. Abra o Telegram no seu telefone. 2. Leia o código de login no chat de serviço do **Telegram**. 3. Digite o código no aplicativo. 4. Clique em **Verificar Código**. > **O código expira rapidamente.** Tenha seu telefone em mãos antes de clicar em **Enviar Código de Login** e insira o código prontamente. Se expirar, inicie a conexão novamente para obter um novo. ### Passo 4: Senha de Duas Etapas (Se você tiver uma) Se sua conta do Telegram tiver a **verificação em duas etapas** ativada, o aplicativo solicitará sua **senha de 2FA** após o código. Insira-a e clique em **Verificar Senha**. Sua senha é usada apenas para concluir o login seguro e nunca é armazenada em formato legível. Uma vez verificado, sua conta aparecerá na página Canais como **Conectado**. Suas conversas no Telegram agora estão acessíveis através da plataforma, e um Agente de IA atribuído a este canal pode responder às mensagens recebidas. ### Importando suas conversas existentes Se você ativou **Importar conversas existentes** no Passo 2: - Apenas chats privados (individuais) recentes são importados. Chats em grupo não são incluídos, e apenas uma quantidade limitada do histórico recente é extraída por chat. - A importação é executada uma vez, em segundo plano, logo após você se conectar. Contas maiores podem levar um pouco de tempo para que tudo apareça. - As mensagens importadas preenchem a conversa em Chats, mas não contam para os números ou gráficos do seu [Dashboard](../get-started/dashboard.md). Apenas o que você envia e recebe após a conexão é medido lá. Se você se conectar sem importar, as novas conversas continuarão chegando normalmente a partir desse momento — apenas o histórico mais antigo será ignorado. --- ## Gerenciamento de Sessão ### Verificando o Status da Conexão O status da sua conexão com o Telegram é exibido no cartão **Telegram** na página **Canais**: | Status | Significado | |---|---| | **Connected** | Ativo e enviando/recebendo mensagens | | **Code sent** | Aguardando você inserir o código de login | | **Two-factor required** | Aguardando sua senha de verificação em duas etapas | | **Not connected** | Nenhuma sessão ativa | ### Reconectando Se sua sessão cair, abra **Configurações → Canais → Canais**, encontre o cartão do Telegram e use a ação de conectar/gerenciar. Se a sessão não puder ser restaurada automaticamente (por exemplo, se você a encerrou pelo seu celular), será solicitado que você faça login novamente com um novo código. ### Desconectando Abra o cartão do **Telegram** e clique em **Desconectar**. Isso desconecta a plataforma da sua conta do Telegram e limpa a sessão. Você também pode encerrá-la pelo próprio Telegram: **Configurações → Dispositivos → Sessões Ativas** e, em seguida, encerrar a sessão da plataforma. --- ## Mantendo a segurança no Telegram Como isso automatiza uma conta pessoal, protegê-la contra banimentos é sua responsabilidade. A plataforma controla o ritmo da IA e dos envios para parecer natural, mas siga estas práticas: - **Envie mensagens apenas para contatos conhecidos/existentes.** Responda a pessoas que enviaram mensagens primeiro ou que são contatos salvos. Evite enviar mensagens em massa para estranhos — essa é a maneira mais rápida de acionar o filtro de spam do Telegram. - **Mantenha os volumes baixos**, especialmente em uma conta recém-conectada. Aumente gradualmente ao longo dos dias, não tudo de uma vez. - **Evite enviar links para pessoas que não o conhecem** — mensagens cheias de links para estranhos são um gatilho comum para banimento. - **Deixe a IA responder em um ritmo natural.** Os atrasos integrados e o indicador de digitação existem para manter a conversa humana — não tente desativá-los. - **Use um número real que você controla.** Números descartáveis/virtuais (VoIP — um número de telefone baseado na internet, não um SIM físico) têm muito mais probabilidade de serem sinalizados. > **Aviso.** Se o Telegram sinalizar a conta por spam, o envio é interrompido até que o comportamento mude — apenas esperar não resolve. Violações repetidas podem banir permanentemente a conta e seu número de telefone. --- ## Limites de envio, aquecimento e controles de acompanhamento O Telegram usa os mesmos limites de envio de proteção, aquecimento automático e interruptor de segurança de acompanhamento por conta que o WhatsApp Web. Eles existem para evitar que uma conta pessoal pareça uma fazenda de spam e seja sinalizada. Na página **Canais**, assim que sua conta do Telegram estiver conectada, você verá: - Um cartão de **Limites de Envio e Aquecimento** com os mesmos medidores do WhatsApp Web — mensagens enviadas hoje, novos contatos hoje e o dia atual de aquecimento. - Um botão de alternância de **Follow-ups Automatizados** — ele começa **ativado** para um número recém-conectado, portanto, desative-o você mesmo enquanto o número ainda estiver em aquecimento. Ele permanece interativo durante todo o processo, mas mostra quais etapas de aquecimento (idade do número, aumento gradual de atividade, engajamento recente de contatos) ainda não foram concluídas. ### Aquecimento automático (rampa) Uma conta do Telegram recém-conectada é intencionalmente limitada e desbloqueia mais capacidade ao longo do tempo. A conta ganha um "dia de qualificação" apenas nos dias em que realmente envia pelo menos 75% do seu limite atual — dias ociosos não contam, portanto, a conta não pode progredir sem um uso real e constante. - **Limite diário de mensagens** = `50 + 8 × (day − 1)`, limitado a **500/dia** (atingido no dia 58). - **Limite diário de novos contatos** = `floor((day − 1) × 5 / 6)` (arredondado para baixo para um número inteiro), limitado a **50/dia** (atingido no dia 61). Portanto, em uma conta nova, você começa com 50 mensagens/dia e 0 novos contatos/dia, subindo até o teto máximo em aproximadamente dois meses. A página Canais mostra o dia atual, o uso de hoje em relação ao limite e quanto falta para atingir o máximo. ::: tip **Dica:** Se você conectar uma conta que **já** possui meses de histórico genuíno no Telegram, o painel de aumento permite que você avance o dia de aquecimento para que os limites sejam removidos imediatamente. Use isso com honestidade — apenas para contas que realmente possuem histórico orgânico. Uma conta totalmente nova que pula o aquecimento tem muito mais chances de ser banida. ::: ### Substituição manual além da rampa Assim que uma conta terminar a rampa completa de 58 dias, uma substituição opcional permite que você aumente o limite diário de mensagens acima de 500 (de 750 até 5.000, em incrementos de 250 mensagens). Não existe um número "seguro" publicado para o Telegram — mantenha-se conservador, fique atento a sinalizações de spam e recue no momento em que notar problemas. A substituição só está disponível em contas totalmente aquecidas; uma conta nova não pode pular o aquecimento dessa forma. ### Interruptor de desligamento de acompanhamento por conta O botão de **Acompanhamentos Automatizados** controla apenas esta conta. Quando está desativado, **nenhum acompanhamento automatizado de qualquer tipo** é enviado a partir dessa conta, independentemente das suas configurações de Transmissão ou campanha. Em uma conta nova (menos de ~30 dias de aumento), é mais seguro deixar os acompanhamentos desativados e enviar apenas a resposta inicial — os acompanhamentos são o que mais frequentemente faz com que uma conta de baixa confiança seja classificada como "bot". Ative-o novamente assim que a conta estiver aquecida e estável. Quando o limite diário de mensagens é atingido, os acompanhamentos agendados são automaticamente transferidos para o dia seguinte, em vez de falharem. --- ## Mensagens de mídia Fotos, documentos e notas de voz recebidos são puxados para o chat para que a IA possa entendê-los (notas de voz são transcritas automaticamente). As respostas da IA enviadas são **apenas texto** nesta versão. Respostas longas são cortadas automaticamente para o limite de 4.096 caracteres do Telegram. --- ## Leia o status no seu telefone Quando a IA responde a um chat do Telegram, ou você abre esse chat em Chats, o chat também é marcado como lido no seu aplicativo do Telegram — para que o ícone de não lidas do seu celular permaneça sincronizado em vez de acumular centenas de chats não lidos. Chats que o bot **não** responde (por exemplo, quando está desligado, fora do horário de funcionamento ou quando optou por não responder) são deixados como **não lidos** propositalmente, para que você ainda possa identificá-los e tratá-los pessoalmente. --- ## Limitações - **Apenas chats pessoais 1 para 1.** Mensagens de grupos e canais não são tratadas nesta versão. - **Sem botões inline.** Menus de botões interativos não são suportados. - **Envio apenas de texto.** A IA responde com texto; o envio de mídia está planejado para uma atualização futura. - **Integração não oficial.** Depende do login do cliente do Telegram e não é endossada pelo Telegram; mudanças na plataforma por parte deles podem afetá-la. - **Risco da conta.** Automação excessiva ou não solicitada pode fazer com que a conta seja restrita ou banida — siga as orientações de segurança acima. --- ## Solução de problemas ### O código de login nunca chega - Verifique o chat de serviço do **Telegram** dentro do aplicativo Telegram — o código geralmente é entregue lá, não por SMS. - Certifique-se de ter inserido o número de telefone com o código do país correto. - O Telegram limita o envio de códigos para contas/números que considera suspeitos. Aguarde alguns minutos e tente novamente. ### "Código expirado" ou "Código inválido" - O código é válido apenas por um curto período. Inicie a conexão novamente para solicitar um novo e insira-o prontamente. ### Solicitação de senha inesperada - Sua conta tem a verificação em duas etapas ativada. Insira sua senha do Telegram para concluir o login. Se você a esqueceu, redefina-a em **Configurações → Privacidade e Segurança → Verificação em Duas Etapas** do Telegram. ### Mensagens não estão sendo enviadas - Verifique se o status da conexão aparece como **Conectado** na página de Canais. - Confirme se o contato é alguém para quem você pode enviar mensagens no Telegram. - Se a conta foi sinalizada recentemente por spam, reduza o volume e mantenha contato apenas com contatos existentes. ### Conta desconectada - Sua sessão foi encerrada (por você, de outro dispositivo ou pelo Telegram). Vá para **Configurações → Canais → Canais**, clique em **Desconectar** e faça login novamente. --- ## Melhores práticas - **Conecte uma conta que já conversa com clientes no Telegram**, não uma conta nova descartável. - **Comece com um baixo volume de automação** e aumente gradualmente. - **Responda a contatos recebidos e contatos ativos** em vez de enviar mensagens frias para estranhos. - **Mantenha sua conta saudável** — um número real, uso normal e ritmo conservador reduzem drasticamente o risco de banimento.