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

# API do Telegram

> Opções para publicar usando a API do Telegram

## Publicando no Telegram

JSON para uma publicação básica com link e imagem usando a API do Telegram:

```json Telegram Post theme={"system"}
{
  "post": "The best Telegram message ever #best https://www.telegram.com", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["telegram"]
}
```

O Telegram gerará automaticamente a prévia do link no canal ou grupo, a menos que haja uma imagem ou vídeo incluído. No exemplo acima, a imagem será exibida. Se você remover a imagem, a prévia do link será exibida.

Se seu vídeo não terminar em uma extensão de vídeo conhecida, como mp4, use o parâmetro `isVideo`. Consulte o [endpoint /post](/apis/post/post) para detalhes.

Consulte as [Diretrizes de mídia do Telegram](/media-guidelines/telegram) e a [Autorização do Telegram](/dashboard/connect-social-accounts/telegram) para mais informações.

## GIFs animados

Apenas uma URL é permitida com um GIF animado no Telegram. Se a URL da mídia não terminar em ".gif" ou ".GIF", defina o campo `isVideo` como `true`.

```json Telegram Animated GIF theme={"system"}
{
    "randomPost": true,
    "platforms": [
        "telegram"
    ],
    "isVideo": true,    // Set to true if the mediaURL does not end in .gif or .GIF
    "mediaUrls": ["https://img.ayrshare.com/012/cat.gif"]
}
```

## Menções no Telegram

Mencione outro usuário do Telegram adicionando `@handle` no texto da publicação. Por exemplo:

```json Telegram Post with Mention theme={"system"}
{
  "post": "The best Telegram image post ever @handle",
  "platforms": ["telegram"]
}
```

<Warning>
  Revise as [regras importantes](/testing/post-verification#mentions) sobre menções.
</Warning>

## Limites de caracteres

Consulte [Limites de caracteres do Telegram](/help-center/technical-support/character_limits#telegram-character-limits) para mais informações.