> ## 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.

# Telegram API

> Опції для публікації через Telegram API

## Публікація в Telegram

JSON для базового поста з посиланням та зображенням через Telegram API:

```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"]
}
```

Telegram автоматично покаже прев'ю посилання в каналі або групі, якщо не додано зображення або відео. У наведеному вище прикладі буде показано зображення. Видалення зображення призведе до показу прев'ю посилання.

Якщо ваше відео не закінчується відомим розширенням відео, як-от mp4, будь ласка, використовуйте параметр `isVideo`. Докладніше див. в endpoint [/post](/apis/post/post).

Див. [Telegram Media Guidelines](/media-guidelines/telegram) та [Telegram Authorization](/dashboard/connect-social-accounts/telegram) для отримання додаткової інформації.

## Анімовані GIF

З анімованим GIF Telegram дозволено лише один URL. Якщо media URL не закінчується на ".gif" або ".GIF", встановіть поле `isVideo` в `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"]
}
```

## Згадки в Telegram

Згадайте інший Telegram handle, додавши `@handle` у текст поста. Наприклад:

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

<Warning>
  Ознайомтеся з [важливими правилами](/testing/post-verification#mentions) щодо згадок.
</Warning>

## Обмеження кількості символів

Див. [Telegram Character Limits](/help-center/technical-support/character_limits#telegram-character-limits) для отримання додаткової інформації.