> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/configuracao/canais/telegram-nativo.md).

# Telegram Nativo

### Visão geral

O canal **Telegram** permite que o DigitalSac receba e envie mensagens através de um bot do Telegram.

No sistema, esse canal aparece internamente com o tipo:

```
telegram
```

Ele é usado para empresas que desejam centralizar atendimentos recebidos pelo Telegram dentro do DigitalSac, junto com os demais canais da operação.

***

### Para que serve

O canal Telegram permite atender clientes que entram em contato pelo Telegram.

Com ele, é possível:

* Receber mensagens de usuários do Telegram
* Enviar respostas pelo DigitalSac
* Criar tickets automaticamente
* Organizar atendimentos em filas
* Vincular usuários responsáveis
* Trabalhar com contatos
* Receber e enviar mídias, conforme suporte disponível
* Usar automações e fluxos de atendimento
* Centralizar o histórico de conversas

***

### Como o canal funciona

O Telegram funciona através de um token de bot.

A empresa cria ou utiliza um bot no Telegram e informa o token no DigitalSac.

Depois da configuração, as mensagens enviadas para o bot passam a ser recebidas pelo sistema.

Fluxo básico:

```
Cliente envia mensagem para o bot do Telegram.
O DigitalSac recebe a mensagem.
O sistema identifica ou cria o contato.
Um ticket é criado ou atualizado.
O atendimento aparece para a fila ou usuário responsável.
O atendente responde pelo DigitalSac.
A resposta é enviada ao cliente pelo Telegram.
```

***

### Token do Telegram

O token do Telegram é a credencial que conecta o bot ao DigitalSac.

No sistema, esse dado é armazenado no canal Telegram.

Exemplo:

```
Canal: Telegram Atendimento
Tipo: Telegram
Token: token do bot
```

Esse token deve ser mantido em segurança.

***

### Cadastro do canal

No cadastro do canal Telegram, normalmente são configurados:

* Nome do canal
* Tipo do canal
* Token do Telegram
* Status
* Fila vinculada, quando aplicável
* Fluxo de atendimento, quando aplicável
* Configurações de mensagens

Exemplo:

```
Nome do canal: Telegram Suporte
Tipo: Telegram
Uso: Atendimento de suporte pelo Telegram
```

***

### Relação com filas

O canal Telegram pode ser vinculado a filas de atendimento.

Exemplo:

```
Canal: Telegram Suporte
Fila: Suporte
```

Quando um cliente envia mensagem pelo Telegram, o ticket pode ser direcionado para a fila Suporte.

***

### Relação com usuários

Os usuários precisam ter permissão para acessar o canal e a fila correspondente.

Exemplo:

```
Usuário: João
Canal permitido: Telegram Suporte
Fila: Suporte
```

Resultado:

```
João poderá responder atendimentos recebidos pelo Telegram, conforme suas permissões.
```

***

### Contatos do Telegram

Quando um cliente envia mensagem pelo Telegram, o sistema identifica ou cria o contato.

Esse contato pode conter informações específicas do Telegram, como identificadores internos da plataforma.

O usuário final normalmente verá o contato dentro do DigitalSac como parte do histórico de atendimento.

***

### Mensagens e mídias

O canal Telegram pode processar mensagens de texto e mídias, conforme os recursos disponíveis no sistema.

Exemplos:

* Texto
* Imagem
* Áudio
* Documento
* Vídeo

As mensagens recebidas ficam registradas no ticket.

***

### Uso com automações

O Telegram pode ser usado com automações e fluxos de atendimento.

Exemplo:

```
Cliente envia mensagem para o bot.
Sistema envia saudação automática.
Cliente escolhe uma opção.
Ticket é direcionado para a fila correta.
Atendente assume o atendimento.
```

Esse fluxo ajuda a organizar a triagem antes do atendimento humano.

***

### Diferença entre Telegram e WhatsApp

O Telegram usa bot e token de API.

O WhatsApp por sessão normalmente usa conexão de número.

Resumo:

```
Telegram
Usa bot e token.

WhatsApp Baileys ou WhatsMeow
Usa conexão com número de WhatsApp.

WABA Oficial
Usa API oficial do WhatsApp Business.
```

Para o usuário final, todos aparecem como canais de atendimento dentro do DigitalSac.

***

### Quando usar Telegram

O canal Telegram é indicado para empresas que:

* Atendem clientes pelo Telegram
* Desejam centralizar esse canal no DigitalSac
* Precisam organizar conversas em tickets
* Querem usar filas e usuários
* Desejam manter histórico de atendimento
* Trabalham com automações de entrada

***

### Boas práticas

Recomenda-se:

1. Usar um bot oficial da empresa.
2. Manter o token do bot em segurança.
3. Criar nome claro para o canal.
4. Vincular o canal a uma fila responsável.
5. Definir quais usuários podem atender Telegram.
6. Testar envio e recebimento após configurar.
7. Usar mensagem inicial clara.
8. Monitorar tickets sem responsável.
9. Revisar permissões periodicamente.
10. Não compartilhar o token em locais públicos.

***

### Exemplo prático

Uma empresa pode configurar Telegram para atendimento técnico:

```
Canal: Telegram Suporte
Tipo: Telegram
Fila: Suporte
Usuários:
- João
- Maria
```

Fluxo:

```
Cliente envia mensagem para o bot.
Ticket é criado na fila Suporte.
João ou Maria assume o atendimento.
A conversa continua dentro do DigitalSac.
```

***

### Resumo

O canal Telegram conecta um bot do Telegram ao DigitalSac.

Ele permite receber mensagens, criar tickets, organizar atendimentos em filas e responder clientes pela plataforma.

Em resumo:

```
Tipo interno: telegram
Canal: Telegram
Uso principal: atendimento via bot do Telegram
Configuração principal: token do bot
Organização: tickets, filas, usuários e permissões
```