Telegram

Objetivo

A integração com Telegram permite conectar um bot ou uma conta de usuário à plataforma, possibilitando o gerenciamento das conversas pelo Zion Talk.

Este é um canal de entrada e saída, permitindo o envio e o recebimento de mensagens entre o Telegram e a plataforma.

Após a conexão, o canal poderá ser utilizado para comunicação com os contatos conforme os módulos e automações configurados.

Como adicionar um canal Telegram

Para adicionar uma nova conexão:

1. Acesse o menu Canais.

2. Clique em Adicionar canal.

3. Selecione Telegram.

1. Preencha as informações solicitadas para configuração do canal.

2. Clique em Salvar.

Após salvar o canal, será possível iniciar a conexão com o Telegram.

Configuração do canal

As configurações disponíveis para o canal Telegram, como Nome do canal, Módulos, Automações e API Key, seguem o padrão de configuração dos canais da plataforma.

Para a descrição detalhada de cada configuração, consulte a documentação do menu Canais.

Iniciando a conexão

Após salvar o canal, a conexão com o Telegram deve ser iniciada pela listagem de canais.

Para isso:

1. Acesse o menu Canais.

2. Localize o canal Telegram cadastrado.

3. Clique em Conectar.

4. Escolha uma das formas de conexão disponíveis:

   • Bot;

   • Conta de usuário.

Conexão via Bot

Para realizar a conexão:

1. Na tela de conexão, selecione a opção Bot.

2. Será exibida uma tela solicitando o Token do Bot.

1. Informe o token gerado pelo BotFather.

2. Clique em Conectar.

Após a validação do token, a conexão será estabelecida e o canal ficará disponível para utilização no Zion Talk.

Como obter o Token do Bot

Caso ainda não possua um bot, siga os passos abaixo:

1. Abra o Telegram e pesquise por @BotFather.

2. Inicie uma conversa com o BotFather.

3. Envie o comando /newbot.

4. Informe o nome que será exibido para o bot.

5. Defina um nome de usuário exclusivo terminado com bot.

6. O BotFather fornecerá o Token do Bot.

7. Copie o token e informe-o no campo correspondente da plataforma.

8. Clique em Conectar para concluir a integração.

Conexão via conta de usuário

Para realizar a conexão:

1. Na tela de conexão, selecione a opção Conta de usuário.

2. Informe o número de telefone vinculado à conta do Telegram.

1. Clique em Próximo.

2. Informe o código de verificação enviado pelo Telegram para o número informado.

1. Clique em Conectar.

Após a validação do código, a sessão será iniciada e o canal ficará disponível para envio e recebimento de mensagens no Zion Talk.

Desconectar Telegram

Ao desconectar o canal, a comunicação entre o Telegram e o Zion Talk é interrompida.

O canal permanece cadastrado, porém deixa de enviar e receber mensagens até que uma nova conexão seja realizada.

Observações

• O Telegram é um canal de entrada e saída, permitindo o envio e o recebimento de mensagens pela plataforma.

• É possível conectar um bot ou uma conta de usuário.

• Para conectar um bot, é necessário informar um Token do Bot válido, gerado pelo BotFather.

• Para conectar uma conta de usuário, é necessário informar um número de telefone válido e concluir a autenticação por meio do código de verificação enviado pelo Telegram.

• Caso o Token do Bot seja revogado ou a sessão da conta de usuário seja encerrada, será necessário realizar uma nova autenticação.

• As funcionalidades disponíveis podem variar conforme os módulos configurados no canal.

• Cada bot ou conta de usuário do Telegram deve possuir sua própria conexão configurada.