> ## 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 de Telegram

> Opciones para publicar usando la API de Telegram

## Publicar en Telegram

JSON para una publicación básica con un enlace e imagen usando la API de 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"]
}
```

Telegram mostrará automáticamente la previsualización del enlace en el canal o grupo salvo que se incluya una imagen o un video. En el ejemplo anterior se mostrará la imagen. Si se elimina la imagen, se mostrará la previsualización del enlace.

Si tu video no termina con una extensión de video conocida como mp4, usa el parámetro `isVideo`. Consulta el [endpoint /post](/apis/post/post) para más detalles.

Consulta las [pautas de medios de Telegram](/media-guidelines/telegram) y la [autorización de Telegram](/dashboard/connect-social-accounts/telegram) para más información.

## GIFs animados

Solo se permite una URL con un GIF animado de Telegram. Si la URL del medio no termina en ".gif" o ".GIF", establece el campo `isVideo` en `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"]
}
```

## Menciones en Telegram

Menciona otro handle de Telegram añadiendo `@handle` en el texto de la publicación. Por ejemplo:

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

<Warning>
  Revisa las [reglas importantes](/testing/post-verification#mentions) sobre las menciones.
</Warning>

## Límites de caracteres

Consulta los [límites de caracteres de Telegram](/help-center/technical-support/character_limits#telegram-character-limits) para más información.