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

# Telegram

> Conecte um canal ou grupo do Telegram ao PostClean

O PostClean publica em **canais e grupos** do Telegram por meio de um bot do PostClean, que você adiciona como administrador.

## Conectar um canal

1. Na barra lateral, abra **Canais** e clique em **Conectar canal** (ou use **Novo** > **Conectar um novo canal**)
2. Escolha **Telegram** e clique em **Conectar Telegram**
3. Na janela **Conectar Telegram**, adicione o bot indicado como **administrador** do seu canal ou grupo (**Abrir no Telegram** leva você até ele)
4. Clique em **Copiar comando** e publique o comando `/connect <código>` nesse canal ou grupo
5. A janela mostra *Aguardando o canal conectar…* e avança assim que o Telegram entrega o comando

O comando expira em **15 minutos**; clique em **Gerar novo comando** para receber outro. O Telegram não tem página de confirmação: depois de conectado, o canal aparece na barra lateral e a janela pergunta quantas vezes por semana você quer postar.

> [!NOTE]
>
> O bot precisa ser **administrador** do canal. O Telegram só entrega posts de canal (inclusive o comando `/connect`) a bots administradores, e o bot precisa de permissão de administrador para publicar.

Cada canal ou grupo vira um canal próprio no PostClean. Conecte quantos quiser no mesmo workspace. Veja [Conectar canais](https://docs.postclean.com.br/knowledge-base/channels/connecting.md).

## Reconectar um canal

Um canal que perdeu a conexão mostra o botão **Reconectar**, que gera um novo código `/connect`. Publique esse código **no mesmo canal ao qual o card se refere**: uma reconexão fica presa a um card e não o transfere para outro chat.

Se você publicar o código em outro lugar, ele é recusado com *Publique o comando no canal que você está reconectando.* O código **não** é consumido, então você ainda pode publicar o mesmo código no canal certo.

## Tipos de conteúdo

| Tipo | `content_type` | Descrição |
| - | - | - |
| **Post** | `telegram_post` | Texto com até 10 imagens/vídeos (várias mídias são enviadas como álbum). GIFs são aceitos |

## Limites de mídia

| `content_type` | Imagem | Vídeo | Formato |
| - | - | - | - |
| `telegram_post` | 5 MB | 20 MB | JPEG/PNG/GIF/WebP; vídeo MPEG4 (MP4 ou MOV) |

Esses são os limites do Telegram para envio por **URL** (o PostClean não usa multipart). Especificações oficiais: [Sending files](https://core.telegram.org/bots/api#sending-files). Catálogo completo: [Mídia](https://docs.postclean.com.br/knowledge-base/media.md#telegram).

## Texto

O Telegram aceita até **4.096** caracteres de texto. As legendas de mídia são limitadas a **1.024**, então um post mais longo é enviado como a mídia seguida de uma mensagem de texto separada. A formatação (negrito, itálico, links, `code`) e as menções simples com `@usuário` são mantidas, e o Telegram cria o link dos usuários públicos sozinho.

## Insights

O Telegram não entra em [Insights](https://docs.postclean.com.br/knowledge-base/insights/overview.md): a Bot API não informa as visualizações dos posts, e o PostClean não mostra métricas do Telegram.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.