# Configuração da plataforma Telegram

Conecte seu bot do Telegram ao Pushwoosh para executar o Telegram como parte de suas jornadas omnicanal de um só lugar e acompanhar os resultados de entrega na análise de Jornada.

## Pré-requisitos

Antes de configurar o Telegram, certifique-se de que os seguintes requisitos sejam atendidos:

*   **Conta do Telegram:** Use uma conta ativa do Telegram que possa acessar o [@BotFather](https://t.me/BotFather).
*   **Bot do Telegram:** Crie um bot do Telegram no BotFather.

## Copie o token da API do seu bot do Telegram

Para obter um token de API para um bot existente:

1.  No Telegram, abra o **@BotFather**.
2.  Envie `/mybots` e selecione seu bot.
3.  Toque em **API Token** e copie o token.

Se você não tiver um bot, crie um no **@BotFather** seguindo [o guia oficial do Telegram](https://core.telegram.org/bots/features#botfather).

## Configure a plataforma Telegram no Pushwoosh

Para configurar a plataforma Telegram, siga estes passos:

1.  Navegue para **Configurações > Configurar plataformas** e abra **Telegram**.

2.  Se você já tem um bot, clique em **Adicionar token**. Se não, clique em **Criar um bot**.

Quando você clica em **Criar um bot**, o Pushwoosh abre as instruções para criar o bot no Telegram via **@BotFather**. Conclua a criação do bot no Telegram, depois retorne ao Pushwoosh e conecte o token do bot.

<img src="/configure-project-telegram-configuration-1.webp" alt="Tela de integração do Telegram em Configurar plataformas com Adicionar token e instruções para o BotFather."/>

3.  Na caixa de diálogo **Conectar bot do Telegram**, insira o **token da API** que você copiou do BotFather. [Saiba como obter o token](#copy-your-telegram-bot-api-token).

<img src="/configure-project-telegram-configuration-3.webp" alt="Caixa de diálogo Conectar bot do Telegram com Nome de exibição, campo de token da API, Verificar token, Cancelar e Conectar."/>

4.  Clique em **Verificar token** para validar o token.
<img src="/configure-project-telegram-configuration-2.webp" alt="Caixa de diálogo Conectar bot do Telegram com Nome de exibição, campo de token da API, Verificar token, Cancelar e Conectar."/>

5.  Clique em **Conectar** para salvar. Para descartar as alterações, clique em **Cancelar**.

## Gerenciar tokens de bot do Telegram

<Aside type="caution">

Cada projeto pode usar **um** token de API de bot do Telegram por vez. Para usar um bot diferente, substitua o token em **Configurar plataformas** ou use outro projeto.
Se você alterar o token da API do bot, as Jornadas do Telegram ativas serão pausadas.
</Aside>

### Adicionar um novo token

1.  Nas configurações do **Telegram**, clique em **Adicionar token**.
2.  Na caixa de diálogo **Conectar bot do Telegram**, insira o novo **token da API**.
3.  Clique em **Verificar token**.
4.  Clique em **Conectar**.

### Excluir um token

1.  Clique no **menu de três pontos** ao lado do token do bot.
2.  Clique em **Excluir**.

A exclusão de um token pausa todas as jornadas ativas do Telegram.

## Enviar mensagens do Telegram

Após a configuração, você pode enviar mensagens do Telegram no **Construtor de Jornada do Cliente**.

<LinkCard title="Saiba mais" href="/product/messaging-channels/telegram/send-telegram-via-customer-journey/" />