Your AI Connector Docs

Telegram (Beta)

Ligue a sua conta Telegram existente à plataforma para que as suas conversas no Telegram fluam diretamente para a aplicação e um Agente de IA possa responder. A ligação é feita introduzindo o seu número de telefone e um código de início de sessão — da mesma forma que adicionaria o Telegram num novo dispositivo.

Beta. O Telegram está agora disponível para todos, mas ainda é recente — espere algumas arestas por limar enquanto o aperfeiçoamos. Se algo não funcionar como descrito, informe o apoio ao cliente.


O que é a integração com o Telegram?

A integração com o Telegram liga a sua conta pessoal do Telegram à plataforma utilizando o próprio fluxo de início de sessão do Telegram. Não há nenhum bot para criar nem nenhum número de telefone separado para comprar — inicia sessão com a conta Telegram que já utiliza e as suas conversas individuais ficam disponíveis dentro da aplicação.

Isto é ideal para empresas que já falam com clientes no Telegram e pretendem um Agente de IA, Transmissões e uma caixa de entrada partilhada sobre a sua conta existente.

Importante — leia antes de ligar. Esta é uma integração não oficial que automatiza uma conta pessoal do Telegram. As regras do Telegram desencorajam a automatização e o envio de mensagens em massa ou não solicitadas, e as contas que violem essas regras podem ser restringidas ou banidas permanentemente (em alguns casos, o próprio número de telefone pode ser bloqueado de se registar novamente). Utilize este canal apenas para enviar mensagens a pessoas que já o contactaram ou que são contactos guardados, mantenha os volumes baixos e deixe a IA responder a um ritmo natural. Não o utilize para contactos a frio em massa.


Telegram vs. WhatsApp Web

Ambos ligam uma conta que já possui, sem uma API de Negócios oficial.

Funcionalidade Telegram WhatsApp Web
Configuração Introduzir número de telefone + código de início de sessão Emparelhar o seu telemóvel (QR ou código de emparelhamento)
Tipo de conta A sua conta pessoal Telegram O seu WhatsApp pessoal/empresarial
Custo por mensagem Gratuito Gratuito
Mensagens de modelo Não aplicável Não suportado
Indicadores de escrita Suportado Suportado
Multimédia (entrada) Fotografias, documentos, notas de voz Fotografias, documentos, notas de voz
Suporte oficial Integração não oficial Integração não oficial
Ideal para Empresas já ativas no Telegram, contactos existentes/frequentes Empresas no WhatsApp, início rápido

O mesmo número em ambos? Sim. Se o mesmo número de telefone estiver no Telegram e no WhatsApp (Web), pode ligá-lo como ambos os canais — funcionam como duas ligações separadas na página Canais, cada uma com o seu próprio estado, aquecimento e limites. Ligar um não afeta nem substitui o outro.


Configurar o Telegram

Passo 1: Abrir o Fluxo de Ligação

  1. Na barra lateral esquerda, clique em Definições perto da parte inferior.
  2. Na barra lateral de Definições, em Canais, clique em Canais.
  3. Encontre o cartão Telegram — que apresenta um aviso de Beta — e clique em Ligar.

Passo 2: Introduzir o seu Número de Telefone

  1. Introduza o número de telefone da conta Telegram que pretende ligar, incluindo o código de país (por exemplo 555 123 4567).
  2. Ative Importar conversas existentes se pretender importar as suas conversas individuais recentes do Telegram como contactos, para não começar com uma caixa de entrada vazia. (Ativar esta opção também lhe permite controlar Manter IA em pausa para conversas importadas — recomendado e ativado por predefinição, para que a importação do seu histórico nunca acione respostas automáticas a mensagens antigas. Pode desativar esta opção por contacto mais tarde, quando estiver pronto.)
  3. Clique em Enviar Código de Início de Sessão.
  4. O Telegram envia um código de início de sessão para a sua aplicação Telegram (normalmente chega como uma mensagem do chat de serviço oficial “Telegram”, nem sempre como um SMS).

Passo 3: Introduzir o Código de Início de Sessão

  1. Abra o Telegram no seu telemóvel.
  2. Leia o código de início de sessão no chat de serviço Telegram.
  3. Escreva o código na aplicação.
  4. Clique em Verificar Código.

O código expira rapidamente. Tenha o seu telemóvel à mão antes de clicar em Enviar Código de Início de Sessão e introduza o código prontamente. Se expirar, inicie a ligação novamente para obter um novo.

Passo 4: Palavra-passe de Dois Fatores (Se tiver uma)

Se a sua conta Telegram tiver a verificação em dois passos ativada, a aplicação solicitará a sua palavra-passe de 2FA após o código. Introduza-a e clique em Verificar Palavra-passe. A sua palavra-passe é utilizada apenas para concluir o início de sessão seguro e nunca é armazenada de forma legível.

Uma vez verificado, a sua conta aparece na página Canais como Ligada. As suas conversas no Telegram estão agora acessíveis através da plataforma e um Agente de IA atribuído a este canal pode responder às mensagens recebidas.

Importar as Suas Conversas Existentes

Se ativou a opção Importar conversas existentes no Passo 2:

  • Apenas são importadas conversas privadas (individuais) recentes. As conversas de grupo não estão incluídas e apenas uma quantidade limitada de histórico recente é recolhida por conversa.
  • A importação é executada uma vez, em segundo plano, logo após a ligação. Em contas maiores, pode demorar algum tempo até que tudo apareça.
  • As mensagens importadas preenchem a conversação em Chats, mas não contam para os números ou gráficos do seu Dashboard. Apenas o que envia e recebe após a ligação é medido aí.

Se se ligar sem importar, as novas conversas continuam a fluir normalmente a partir desse momento — apenas o histórico mais antigo é ignorado.


Gestão de Sessão

Verificar o Estado da Ligação

O estado da sua ligação ao Telegram é apresentado no cartão Telegram na página Canais:

Estado Significado
Ligado Ativo e a receber/enviar mensagens
Código enviado À espera que introduza o código de início de sessão
Autenticação de dois fatores necessária À espera da sua palavra-passe de verificação de dois passos
Não ligado Sem sessão ativa

Reestabelecer a Ligação

Se a sua sessão cair, abra Definições → Canais → Canais, encontre o cartão do Telegram e utilize a sua ação de ligar/gerir. Se a sessão não puder ser restaurada automaticamente (por exemplo, se a terminou a partir do seu telemóvel), ser-lhe-á pedido que inicie sessão novamente com um novo código.

Desligar

Abra o cartão do Telegram e clique em Desligar. Isto termina a sessão da plataforma na sua conta Telegram e limpa a sessão. Também pode terminá-la a partir do próprio Telegram: Definições → Dispositivos → Sessões Ativas, e depois termine a sessão da plataforma.


Manter a segurança no Telegram

Como isto automatiza uma conta pessoal, a responsabilidade de a proteger contra banimentos é sua. A plataforma regula a IA e os envios de saída para parecerem naturais, mas siga estas práticas:

  • Envie mensagens apenas para contactos conhecidos/existentes. Responda a pessoas que lhe enviaram mensagens primeiro ou que são contactos guardados. Evite enviar mensagens em massa a estranhos — essa é a forma mais rápida de acionar o sinalizador de spam do Telegram.
  • Mantenha os volumes baixos, especialmente numa conta ligada recentemente. Aumente o ritmo lentamente ao longo de vários dias, não tudo de uma vez.
  • Evite enviar links para pessoas que não o conhecem — mensagens com muitos links para estranhos são um motivo comum para bloqueios.
  • Deixe a IA responder a um ritmo natural. Os atrasos integrados e o indicador de escrita servem para manter a conversa com um aspeto humano — não tente contorná-los.
  • Utilize um número real que controla. Números descartáveis/virtuais (VoIP — um número de telefone baseado na internet, não um cartão SIM físico) têm muito mais probabilidade de serem sinalizados.

Aviso. Se o Telegram sinalizar a conta por spam, o envio para até que o comportamento mude — esperar apenas não resolve o problema. Violações repetidas podem banir permanentemente a conta e o respetivo número de telefone.


Limites de envio, aquecimento e controlos de seguimento

O Telegram utiliza os mesmos limites de envio de proteção, aquecimento automático e interruptor de segurança de seguimento por conta que o WhatsApp Web. Estes existem para evitar que uma conta pessoal pareça uma exploração de spam e seja sinalizada. Na página Canais, assim que a sua conta Telegram estiver ligada, verá:

  • Um cartão de Limites de Envio e Aquecimento com os mesmos medidores do WhatsApp Web — mensagens enviadas hoje, novos contactos hoje e o dia de aquecimento atual.
  • Um interruptor de Acompanhamentos Automatizados — este inicia-se ligado para um número recém-conectado, por isso desative-o enquanto o número ainda está em fase de aquecimento. Permanece interativo durante todo o processo, mas mostra quais as etapas de aquecimento (idade do número, aumento gradual da atividade, envolvimento recente de contactos) que ainda não foram superadas.

Aquecimento automático (rampa)

Uma conta do Telegram recém-ligada é intencionalmente limitada e desbloqueia mais capacidade ao longo do tempo. A conta apenas ganha um “dia de qualificação” nos dias em que envia, efetivamente, pelo menos 75% do seu limite atual — os dias de inatividade não contam, pelo que a conta não pode progredir sem uma utilização 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 contactos = floor((day − 1) × 5 / 6) (arredondado para baixo para um número inteiro), limitado a 50/dia (atingido no dia 61).

Portanto, numa conta nova, começa com 50 mensagens/dia e 0 novos contactos/dia, subindo até ao limite máximo ao longo de cerca de dois meses. A página Canais mostra o dia atual, a utilização de hoje em relação ao limite e quanto falta para atingir o objetivo.

Dica: Se ligar uma conta que tem meses de histórico genuíno no Telegram, o painel de aumento de ritmo permite-lhe avançar o dia de aquecimento para que os limites sejam levantados imediatamente. Utilize isto de forma honesta — apenas para contas que realmente têm histórico orgânico. Uma conta totalmente nova que salta o aquecimento tem muito mais probabilidade de ser banida.

Substituição manual após a rampa

Assim que uma conta terminar a rampa completa de 58 dias, uma substituição opcional permite-lhe aumentar o limite diário de mensagens para além de 500 (de 750 até 5.000, em incrementos de 250 mensagens). Não existe um número “seguro” publicado para o Telegram — seja conservador, esteja atento a sinalizações de spam e recue no momento em que detetar problemas. A substituição só está disponível em contas totalmente aquecidas; uma conta nova não pode ignorar o aquecimento desta forma.

Interruptor de paragem de seguimento por conta

O interruptor de Seguimentos Automatizados controla apenas esta conta. Quando está desativado, nenhum seguimento automatizado de qualquer tipo é enviado a partir dessa conta, independentemente das suas definições de Difusão ou campanha. Numa conta nova (com menos de ~30 dias de aumento de ritmo), é mais seguro deixar os seguimentos desativados e enviar apenas a resposta inicial — os seguimentos são o que mais frequentemente faz com que uma conta de baixa confiança seja classificada como “isto é um bot”. Volte a ativá-lo assim que a conta estiver aquecida e estável.

Quando o limite diário de mensagens é atingido, os seguimentos agendados são automaticamente adiados para o dia seguinte em vez de falharem.


Mensagens de multimédia

As fotografias, documentos e notas de voz recebidos são puxados para o chat para que a IA os possa compreender (as notas de voz são transcritas automaticamente). As respostas de IA enviadas são apenas texto nesta versão. As respostas longas são automaticamente cortadas para o limite de 4096 caracteres do Telegram.


Ler o estado no seu telemóvel

Quando a IA responde a um chat do Telegram, ou quando abre esse chat em Chats, o chat é marcado como lido na sua própria aplicação Telegram — para que o emblema de não lidas do seu telemóvel se mantenha sincronizado em vez de acumular centenas de chats não lidos.

Os chats aos quais o bot não responde (por exemplo, quando está desligado, fora do seu horário de funcionamento ou quando optou por não responder) são deixados não lidos propositadamente, para que ainda os possa detetar e tratar pessoalmente.


Limitações

  • Apenas chats pessoais 1-para-1. As mensagens de grupos e canais não são processadas nesta versão.
  • Sem botões inline. Os menus de botões interativos não são suportados.
  • Envio apenas de texto. A IA responde com texto; o envio de multimédia está planeado para uma atualização posterior.
  • Integração não oficial. Baseia-se no início de sessão do cliente Telegram e não é endossada pelo Telegram; as alterações da plataforma do lado deles podem afetá-la.
  • Risco da conta. A automatização excessiva ou não solicitada pode levar a que a conta seja restringida ou banida — siga as orientações de segurança acima.

Resolução de Problemas

O código de início de sessão nunca chega

  • Verifique a conversa do serviço Telegram dentro da aplicação Telegram — o código é normalmente entregue aí, e não por SMS.
  • Certifique-se de que introduziu o número de telefone com o código de 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 só é válido por um curto período. Inicie a ligação novamente para solicitar um novo e introduza-o prontamente.

Pedido de palavra-passe inesperado

  • A sua conta tem a verificação de dois passos ativada. Introduza a sua palavra-passe do Telegram para concluir o início de sessão. Se a esqueceu, reponha-a em Definições → Privacidade e Segurança → Verificação de Dois Passos do Telegram.

Mensagens não enviadas

  • Verifique se o estado da ligação apresenta Ligado na página Canais.
  • Confirme se o contacto é alguém a quem pode enviar mensagens no Telegram.
  • Se a conta foi recentemente sinalizada por spam, reduza o volume e limite-se aos contactos existentes.

Conta terminada a sessão

  • A sua sessão foi terminada (por si, a partir de outro dispositivo ou pelo Telegram). Vá a Definições → Canais → Canais, clique em Desligar e, em seguida, inicie sessão novamente.

Melhores práticas

  • Ligue uma conta que já comunica com clientes no Telegram, e não uma conta nova descartável.
  • Comece com um volume de automatização baixo e aumente gradualmente.
  • Responda a contactos recebidos e conhecidos em vez de enviar mensagens a desconhecidos.
  • Mantenha a sua conta saudável — um número real, uma utilização normal e um ritmo conservador reduzem drasticamente o risco de banimento.