> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar a integração com o Telegram

> Saiba como conectar o Telegram às suas landing pages no LanderLab e enviar notificações instantâneas de leads para um chat, grupo ou canal do Telegram em tempo real.

Conecte o Telegram às suas landing pages no LanderLab para receber uma notificação instantânea sempre que chegar um novo lead. Em vez de ficar conferindo o painel, a sua equipe vê cada lead no momento em que ele é enviado, direto em um chat, grupo ou canal do Telegram.

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

A integração com o Telegram usa um bot do Telegram para enviar uma mensagem ao chat escolhido sempre que um lead é coletado na sua landing page. Todos os campos do lead são incluídos automaticamente, então você recebe o envio completo sem nenhuma configuração além de conectar a integração.

Ela é ideal para alertas em tempo real: notifique a sua equipe de vendas em um grupo compartilhado, envie leads para um canal privado ou receba um aviso pessoal a cada novo envio.

## Antes de começar

Você precisa de duas coisas para conectar o Telegram:

1. **Um token de bot**, criado com o BotFather do Telegram.
2. **Um Chat ID**, que informa ao bot para onde enviar as notificações (um chat pessoal, um grupo ou um canal).

Você só precisa criar o bot uma vez. Depois disso, pode reutilizar o mesmo bot para enviar notificações de quantas landing pages quiser.

## Passo 1: Criar um bot do Telegram e obter o token do bot

O seu bot é a conta que entrega as notificações. Você o cria pelo BotFather, o bot oficial do Telegram para gerenciar bots.

<Steps>
  <Step title="Abra o BotFather no Telegram">
    Na barra de pesquisa do Telegram, digite `BotFather` e abra a conta verificada (a que tem o selo azul e o nome de usuário `@BotFather`).

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/botfather.png?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=ea65bfd31940bb7d2833927589e1eb7d" alt="A conta verificada do BotFather nos resultados de pesquisa do Telegram, com o selo azul" width="1456" height="829" data-path="images/botfather.png" />
    </Frame>
  </Step>

  <Step title="Crie um novo bot">
    Clique em **Start** e envie o comando `/newbot`.
  </Step>

  <Step title="Dê um nome ao seu bot">
    O BotFather pedirá um **name** (o nome de exibição, que pode ser o que você quiser) e depois um **username** (nome de usuário). O nome de usuário precisa ser único e terminar em `bot` (por exemplo, `LanderLabdoc_Bot`).
  </Step>

  <Step title="Copie o token do seu bot">
    Depois que o nome de usuário for aceito, o BotFather responderá com uma mensagem de confirmação contendo o token do seu bot. Ele é parecido com `123456789:AAExampleTokenReplaceWithYourOwn000`. Copie-o e guarde-o em um lugar seguro.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/botapi.png?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=40bea8773dd6af8e9fd6411bdae12929" alt="A mensagem de confirmação do BotFather no Telegram, com o token de API do novo bot" width="1456" height="829" data-path="images/botapi.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Trate o token do seu bot como uma senha. Qualquer pessoa que o tenha pode controlar o seu bot. Nunca o publique nem o compartilhe com pessoas em quem você não confia.
</Warning>

## Passo 2: Obter o seu Chat ID

O Chat ID informa ao bot exatamente para onde enviar as notificações. A forma de encontrá-lo depende de para onde você quer que os seus leads sejam enviados. Escolha abaixo a opção que corresponde à sua configuração.

<AccordionGroup>
  <Accordion title="Chat em grupo (recomendado para equipes)">
    A forma mais fácil de obter o Chat ID de um grupo é pelo aplicativo do Telegram para desktop.

    <Steps>
      <Step title="Crie um grupo e adicione o seu bot">
        Crie um grupo no Telegram (ou abra um existente) e adicione o seu bot como membro.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/botgroup.png?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=d6b8b1e180f8daae0f1d1e1e8a77b80e" alt="Um grupo do Telegram com o bot adicionado como membro" width="1456" height="820" data-path="images/botgroup.png" />
        </Frame>
      </Step>

      <Step title="Envie uma mensagem e copie o link dela">
        Envie qualquer mensagem no grupo. Depois, clique com o botão direito na mensagem (ou mantenha-a pressionada no celular) e escolha **Copy Message Link**.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/6dsdE__B-csyS6Jn/images/copylink.webp?fit=max&auto=format&n=6dsdE__B-csyS6Jn&q=85&s=1a45ce1fd9ad6c51951db3239fccbfa7" alt="O menu de contexto do Telegram em uma mensagem do grupo, com a opção Copy Message Link destacada" width="1568" height="768" data-path="images/copylink.webp" />
        </Frame>
      </Step>

      <Step title="Leia o Chat ID no link">
        O link copiado é parecido com `https://t.me/c/4302014071/2`. O número logo depois de `/c/` é o ID do seu grupo. Neste exemplo, o Chat ID é `4302014071`.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/6dsdE__B-csyS6Jn/images/groupid.png?fit=max&auto=format&n=6dsdE__B-csyS6Jn&q=85&s=194aa213dd4d7d3ee65dfe5bb5f6ca9b" alt="Um link de mensagem do Telegram copiado, com o ID do grupo destacado depois do trecho /c/" width="1568" height="277" data-path="images/groupid.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Se as notificações não chegarem usando apenas o número, adicione o prefixo `-100` ao ID do grupo. Por exemplo, `4302014071` passa a ser `-1004302014071`. Esse é o formato que a Telegram Bot API usa para grupos e canais.
    </Note>
  </Accordion>

  <Accordion title="Chat privado (só você)">
    Use esta opção quando quiser receber notificações pessoais diretamente no seu Telegram.

    <Steps>
      <Step title="Inicie o seu bot">
        Abra o seu novo bot e clique em **Start**, ou envie qualquer mensagem para ele.
      </Step>

      <Step title="Abra a URL getUpdates">
        Em um navegador, abra a URL abaixo, substituindo `<YOUR_BOT_TOKEN>` pelo seu token. Mantenha a palavra `bot` imediatamente antes do token.

        ```text theme={null}
        https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
        ```
      </Step>

      <Step title="Encontre o seu Chat ID">
        A página retorna um bloco de JSON. Procure o objeto `chat` e copie o valor de `id`. Esse número é o seu Chat ID.

        ```json theme={null}
        "chat": {
          "id": 21xxxxx38,
          "type": "private"
        }
        ```
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Canal">
    Use esta opção para transmitir os leads em um canal do Telegram.

    <Steps>
      <Step title="Adicione o seu bot como administrador do canal">
        Adicione o seu bot ao canal e dê a ele direitos de administrador; depois, publique qualquer mensagem no canal.
      </Step>

      <Step title="Abra a URL getUpdates">
        Em um navegador, abra a URL abaixo, substituindo `<YOUR_BOT_TOKEN>` pelo seu token.

        ```text theme={null}
        https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
        ```
      </Step>

      <Step title="Encontre o seu Chat ID">
        Procure o objeto `chat` dentro de `channel_post` e copie o valor de `id`. Os IDs de canal começam com `-100`.

        ```json theme={null}
        "chat": {
          "id": -1001xxxxxx062,
          "type": "channel"
        }
        ```
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

<Tip>
  Está vendo um resultado vazio na URL `getUpdates`? Verifique se você já enviou pelo menos uma mensagem para o seu bot, grupo ou canal. O Telegram só retorna atividades recentes.
</Tip>

## Passo 3: Conectar o Telegram no LanderLab

Com o token do bot e o Chat ID em mãos, você pode conectar a integração.

### Adicionar a integração

<Steps>
  <Step title="Abra sua landing page">
    Acesse **Landing Pages** e clique no **nome da landing page** para a qual você quer receber notificações de leads.
  </Step>

  <Step title="Abra a aba de integrações">
    Clique em **Add Integration** para abrir o painel de integrações; depois, pesquise **Telegram** e selecione-o.
  </Step>

  <Step title="Informe um nome e o token do seu bot">
    Dê à integração um **Name** (nome) para identificá-la e cole o **Bot Token** do Passo 1. Clique em **Add Telegram**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/bot-token.webp?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=f8eddbe2a0c4d7c7c4b23e535679460e" alt="O formulário da integração com o Telegram no LanderLab, com os campos Name e Bot Token" width="551" height="317" data-path="images/bot-token.webp" />
    </Frame>
  </Step>
</Steps>

### Configurar a notificação

Depois que você adiciona o bot, um assistente de configuração rápido é aberto para que você escolha para onde as notificações vão e como elas ficam.

<Steps>
  <Step title="Informe o seu Chat ID">
    Cole o **Chat ID** que você encontrou no Passo 2 (por exemplo, `-1004309994071`). Clique em **Continue**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/chatid.webp?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=632546f1d1b7169a066b71284e43f1c2" alt="O passo de Chat ID do assistente de configuração do Telegram no LanderLab" width="696" height="331" data-path="images/chatid.webp" />
    </Frame>
  </Step>

  <Step title="Escolha o formato da mensagem">
    Escolha como cada notificação será escrita:

    | Formato    | O que faz                                                                                                                                             |
    | :--------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **List**   | O LanderLab formata automaticamente todos os campos do lead. Você só adiciona um **Intro text** (texto de introdução), exibido no início da mensagem. |
    | **Custom** | Escreva o seu próprio modelo de mensagem e controle exatamente o que cada notificação diz.                                                            |

    Na maioria dos casos, **List** é a opção mais rápida. Adicione uma introdução como `New lead from Pre-Sell Warm-Up Landing Page` e clique em **Continue**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/6dsdE__B-csyS6Jn/images/image-27.png?fit=max&auto=format&n=6dsdE__B-csyS6Jn&q=85&s=b6df23cb4f87f08a4771194b23d91fc2" alt="O passo de formato da mensagem do assistente de configuração do Telegram, com as opções List ou Custom e um campo de texto de introdução" width="912" height="502" data-path="images/image-27.png" />
    </Frame>
  </Step>

  <Step title="Revise e conecte">
    O último passo mostra uma prévia do destino, do formato da mensagem e do texto de introdução. Todos os campos do lead são incluídos automaticamente. Se estiver tudo certo, clique em **Connect Telegram**.
  </Step>
</Steps>

<Note>
  Se a sua landing page tiver várias variantes de teste A/B, você precisará escolher a quais variantes esta integração se aplica antes que ela seja adicionada.
</Note>

## Testar a integração

Envie um lead de teste pelo formulário ou quiz da sua landing page e confira o seu chat do Telegram. O bot deve entregar uma mensagem com os detalhes do lead em poucos segundos.

## Solução de problemas

<AccordionGroup>
  <Accordion title="Nenhuma notificação está chegando">
    Confirme três coisas: o token do seu bot está correto, o seu bot é membro (ou administrador) do grupo ou canal e o seu Chat ID foi informado corretamente. Para grupos e canais, tente adicionar o prefixo `-100` ao ID.
  </Accordion>

  <Accordion title="As notificações vão para o chat errado">
    Confira o Chat ID novamente. É fácil confundir um grupo, um canal e um chat pessoal. Repita o Passo 2 para o destino exato que você quer.
  </Accordion>

  <Accordion title="O bot não está respondendo">
    Verifique se você clicou em **Start** no chat do bot ou enviou pelo menos uma mensagem para o grupo ou canal. O Telegram não retorna nenhum dado do chat enquanto não houver atividade.
  </Accordion>
</AccordionGroup>