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.

Quanto custa. Cada conta do Telegram conectada custa 50 créditos por mês, descontados do seu saldo de créditos, sem taxa adicional por mensagem. A primeira cobrança ocorre 30 dias após a conexão e, em seguida, a cada 30 dias enquanto a conta permanecer conectada. Desconectar interrompe a cobrança. Se o seu saldo estiver muito baixo quando a mensalidade vencer, esse mês será ignorado e uma nova tentativa será feita cerca de 30 dias depois. Um mês ignorado nunca é cobrado posteriormente, recarregar o saldo não aciona uma cobrança e a conta permanece conectada.

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. Marque Eu entendo que minha conta será cobrada em 50 créditos/mês por esta conexão. O botão Enviar código de login permanecerá desativado até que você faça isso.
4. Clique em Enviar código de login.
5. 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.

Cada conta do Telegram pode ser conectada apenas uma vez por workspace. Se a conta já estiver conectada, mesmo que com um número de telefone diferente, o fluxo de conexão é interrompido e avisa você sobre isso: use a conexão existente ou desconecte-a primeiro.

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. 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:

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.

Você não precisa procurar por isso. Quando o Telegram encerra a sessão, uma barra Telegram signed you out aparece no topo de cada página no aplicativo com um botão Reconnect que abre o login imediatamente. Se a conexão cair por outro motivo, uma barra Telegram disconnected é exibida enquanto ele continua tentando reconectar em segundo plano, e desaparece sozinha assim que a conexão é restabelecida. Isso inclui uma conexão que permanece aberta, mas para de responder: o aplicativo verifica a cada poucos minutos se o Telegram ainda responde e redefine uma conexão inativa por conta própria. Até que a conta seja conectada novamente, a IA não responderá nela.

Desconectando #

Abra o cartão Telegram e clique em Desconectar. Isso desconecta a plataforma da sua conta do Telegram, limpa a sessão e interrompe a taxa mensal. Você também pode encerrar pelo próprio Telegram: Configurações → Dispositivos → Sessões Ativas e, em seguida, encerre 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.

Defina seu próprio limite diário #

Você pode definir o limite diário de mensagens por conta própria a qualquer momento, em qualquer dia de aquecimento: abra o cartão do Telegram na página Canais, clique em Definir limite diário e escolha um número de 100 a 1.500 mensagens por dia. Seu limite substitui o limite de mensagens do aquecimento imediatamente, tanto para baixo quanto para cima. O limite diário de novos contatos ainda segue o aquecimento, portanto, uma conta nova pode enviar mais respostas, mas não pode enviar mensagens para mais estranhos. Limpar o limite coloca a conta de volta no cronograma de aquecimento.

Aumentar o limite entra em vigor imediatamente e reativa quaisquer conversas que foram pausadas no limite antigo. Não existe um número “seguro” publicado para o Telegram: mantenha-o conservador, fique atento a sinalizações de spam e recue no momento em que perceber problemas. Enviar muito acima do que uma conta normal faz é a maneira mais rápida de ter a conta restrita, e a restrição recai sobre sua conta do Telegram, não na plataforma.

Você também pode definir o limite pela API: envie daily_message_limit_manual_override (100 a 1.500, ou 0 para limpar) com o endpoint Update Phone Number (consulte Limites de envio e dia de aquecimento na página de referência da API em Canais), ou mova o dia de aquecimento com o endpoint ramp-day.

Reconectar mantém seu aquecimento #

Se você desconectar e reconectar a mesma conta do Telegram, mesmo com um novo número de telefone, o dia de aquecimento é restaurado a partir do histórico de envio da conta nesta plataforma no momento em que ela se reconecta, portanto, você não começa novamente no dia 1.

Interruptor de desligamento de acompanhamento por conta #

A chave Acompanhamentos Automáticos controla apenas esta conta. Quando está desativada, nenhum tipo de acompanhamento automático é enviado a partir dessa conta, independentemente das suas configurações de Transmissão ou Agente. Em uma conta nova (com menos de ~30 dias de aquecimento), é mais seguro manter 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 “isso é um bot”. Ative-a 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.

Distribuindo Visitantes entre Várias Contas #

Um link curto pode alternar entre várias contas do Telegram, da mesma forma que alterna entre números do WhatsApp. Cada clique abre t.me/<username> da conta com mais espaço disponível hoje; contas que estão desconectadas, não possuem nome de usuário ou atingiram o limite de envio de hoje são ignoradas, para que o link continue funcionando caso uma conta fique indisponível. Crie-o em Configurações → Links Curtos → Novo link e escolha Telegram. Cada conta precisa ter um nome de usuário público definido no Telegram.

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 mostra Connected na página Canais.
• Se um envio falhar devido a um tempo limite (timeout), o aplicativo verifica a conexão imediatamente e a redefine quando o Telegram não está respondendo. Tente enviar a mensagem novamente alguns minutos depois.
• 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 pessoas conhecidas.

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.