# 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](../get-started/dashboard.md). 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. ::: tip **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. ::: ### 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.