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 Introduza o número de telefone + código de início de sessão Emparelhe o seu telemóvel (QR ou código de emparelhamento)
Tipo de conta A sua conta pessoal Telegram O seu WhatsApp pessoal/empresarial
Custo mensal 50 créditos por mês por conta ligada 50 créditos por mês por número ligado
Custo por mensagem Gratuito Gratuito
Mensagens de modelo Não aplicável Não suportado
Indicadores de escrita Suportado Suportado
Multimédia (recebida) 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 calorosos/existentes Empresas no WhatsApp, início rápido

Quanto custa. Cada conta do Telegram ligada custa 50 créditos por mês, deduzidos do seu saldo de créditos, sem qualquer taxa adicional por mensagem. A primeira cobrança ocorre 30 dias após a ligação e, posteriormente, a cada 30 dias enquanto a conta permanecer ligada. Desligar a conta interrompe a cobrança. Se o seu saldo for insuficiente quando a mensalidade for devida, esse mês será ignorado e será feita uma nova tentativa cerca de 30 dias depois. Um mês ignorado nunca é cobrado posteriormente, o carregamento do saldo não aciona uma cobrança e a conta permanece ligada.

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 a opção 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 desencadeie respostas automáticas a mensagens antigas. Pode desativar esta opção por contacto mais tarde, quando estiver pronto.)
  3. Selecione Compreendo que a minha conta será cobrada em 50 créditos/mês por esta ligação. O botão Enviar Código de Início de Sessão permanecerá desativado até o fazer.
  4. Clique em Enviar Código de Início de Sessão.
  5. 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 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.

Cada conta de Telegram só pode ser ligada uma vez por área de trabalho. Se a conta já estiver ligada, mesmo com um número de telefone diferente, o fluxo de ligação é interrompido e é-lhe indicado que deve utilizar a ligação existente ou desligá-la primeiro.

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.

Não precisa de ir à procura. Quando o Telegram termina a sessão, aparece uma barra Telegram signed you out no topo de cada página na aplicação com um botão Reconnect que abre o início de sessão imediatamente. Se a ligação cair por outro motivo, aparece uma barra Telegram disconnected enquanto a aplicação continua a tentar restabelecer a ligação em segundo plano, desaparecendo automaticamente assim que esta for restabelecida. Isto inclui uma ligação que permanece aberta mas deixa de responder: a aplicação verifica a cada poucos minutos se o Telegram ainda responde e reinicia uma ligação inativa por conta própria. Até que a conta seja ligada novamente, a IA não responderá através dela.

Desligar

Abra o cartão Telegram e clique em Desligar. Isto termina a sessão da plataforma na sua conta Telegram, limpa a sessão e interrompe a taxa mensal. Também pode terminar a ligação a partir do próprio Telegram: Definições → Dispositivos → Sessões Ativas e, em seguida, 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 já 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.

Defina o seu próprio limite diário

Pode definir o limite diário de mensagens por si próprio 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. O seu limite substitui imediatamente o limite de mensagens do aquecimento, tanto abaixo como acima dele. O limite diário de novos contactos continua a seguir o aquecimento, pelo que uma conta nova pode enviar mais respostas, mas não pode enviar mensagens a mais estranhos. Limpar o limite coloca a conta de volta no agendamento de aquecimento.

O aumento do limite entra em vigor imediatamente e reativa quaisquer conversas que tenham sido pausadas no limite anterior. Não existe um número “seguro” publicado para o Telegram: seja conservador, esteja atento a avisos de spam e recue no momento em que detetar problemas. Enviar muito acima do que uma conta normal faz é a forma mais rápida de a conta ser restringida, e a restrição recai sobre a sua conta do Telegram, não sobre a plataforma.

Também pode definir o limite a partir da 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 Canais da referência da API), ou altere o dia de aquecimento com o endpoint ramp-day.

A reconexão mantém o seu aquecimento

Se desligar e voltar a ligar 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 esta se reconecta, pelo que não começa novamente no dia 1.

Interruptor de paragem de seguimento por conta

O interruptor Seguimentos automáticos controla apenas esta conta. Quando está desligado, não são enviados quaisquer tipos de seguimentos automáticos a partir dessa conta, independentemente das suas definições de Transmissão ou Agente. Numa conta nova (com menos de ~30 dias de aquecimento), é mais seguro manter os seguimentos desligados e enviar apenas a resposta inicial — os seguimentos são o que mais frequentemente leva uma conta de baixa confiança a ser classificada como “isto é um bot”. Volte a ligá-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.


Distribuir Visitantes por Várias Contas

Uma ligação curta pode rodar por várias contas do Telegram, da mesma forma que roda por números de WhatsApp. Cada clique abre t.me/<username> da conta com mais espaço disponível hoje; as contas que estão desligadas, não têm nome de utilizador ou atingiram o limite de envio de hoje são ignoradas, pelo que a ligação continua a funcionar se uma conta ficar inativa. Crie-a em Definições → Ligações Curtas → Nova ligação e escolha Telegram. Cada conta precisa de ter um nome de utilizador público definido no Telegram.


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 Connected na página Canais.
  • Se um envio falhar devido a um tempo limite (timeout), a aplicação verifica a ligação imediatamente e reinicia-a quando o Telegram não responde. Tente enviar a mensagem novamente alguns minutos depois.
  • 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 a 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.