> ## 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`. راجع [نقطة النهاية /post](/apis/post/post) للتفاصيل.

راجع [إرشادات وسائط Telegram](/media-guidelines/telegram) و[صلاحيات Telegram](/dashboard/connect-social-accounts/telegram) لمزيد من المعلومات.

## صور GIF المتحركة

يُسمح بعنوان URL واحد فقط مع صورة GIF متحركة على Telegram. إذا لم ينتهِ عنوان 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` في نص المنشور. على سبيل المثال:

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

<Warning>
  يُرجى مراجعة [القواعد الهامة](/testing/post-verification#mentions) حول الإشارات.
</Warning>

## حدود الأحرف

يُرجى مراجعة [حدود أحرف Telegram](/help-center/technical-support/character_limits#telegram-character-limits) لمزيد من المعلومات.