publora/telegram-post

Publicación en Telegram

Crea y programa publicaciones en canales y grupos de Telegram usando el servidor MCP de Publora. Soporta formato markdown enriquecido, fotos, videos y opciones de entrega de mensajes.

Requisitos previos

Planes: Funciona con el plan gratuito Starter. Límites y precios actuales: publora.com/pricing.

Primeros pasos

1. Crear cuenta en publora.com/register (gratis)
2. Crear bot de Telegram:
   • Envía un mensaje a @BotFather en Telegram
   • Envía /newbot y sigue las instrucciones
   • Guarda el token del bot
3. Añadir el bot a tu canal:
   • Añade el bot como administrador a tu canal/grupo
   • Concede el permiso can_post_messages
4. Conectar en Publora en el Panel de control con el token del bot y el nombre del canal
5. Obtener clave API en app.publora.com/dashboard/api
6. Conectar tu agente al servidor MCP en https://mcp.publora.com, autenticando con Authorization: Bearer sk_TU_CLAVE_API. En Claude Code:

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_TU_CLAVE_API"

Claude Desktop, Cursor, Codex, OpenClaw y el conector de claude.ai necesitan un archivo de configuración o flujo diferente: consulta configuración de cliente para la ruta exacta y el fragmento de código.

API REST de respaldo

Si el servidor MCP no está disponible o devuelve errores, usa la API REST directamente:

URL base: https://api.publora.com/api/v1

Autenticación: Usa el encabezado x-publora-key (NO Authorization: Bearer):

# Obtener tus plataformas conectadas
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_tu_clave_api"

# Crear una publicación
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["telegram-1001234567890"],
    "content": "*Anuncio*\n\nTu mensaje aquí",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Formato del ID de plataforma: telegram-{chat_id} donde {chat_id} es el ID numérico del canal/grupo de /platform-connections.

Ejemplos de IDs: telegram-1001234567890, telegram--1002345678901

📖 Documentación completa de la API: docs.publora.com

Límites de la plataforma (Bot API)

Característica	Límite
Mensaje de texto	4,096 caracteres
Pie de foto de medio	1,024 caracteres (¡límite crítico!)
Imágenes	10 MB máximo, 10 por grupo de medios
Formatos de imagen	JPEG, PNG, GIF, BMP, WebP
Tamaño de video	50 MB máximo (¡no 4 GB, eso es para usuarios!)
Formatos de video	MP4, MOV, AVI, MKV, WebM
Límite de velocidad	30 msg/seg global, 20 msg/min por grupo

Importante: La Bot API tiene límites mucho más bajos que los usuarios normales de Telegram. Los videos de más de 50 MB y los pies de foto de más de 1,024 caracteres fallarán.

Formato Markdown

Telegram usa su propia variante de markdown con asteriscos simples para negritas:

Sintaxis	Resultado
*negrita*	negrita
_cursiva_	cursiva
`código`	código en línea
código	Bloque de código
[texto](url)	hipervínculo
> texto	Cita en bloque

Nota: Esto difiere del Markdown estándar donde **asteriscos dobles** crean negrita.

Herramientas disponibles

create_post

Crea una nueva publicación en Telegram.

Parámetros:

• platforms: Arreglo con el ID de tu conexión de Telegram (ej. ["telegram-1001234567890"])
• content: Texto del mensaje (soporta markdown)
• scheduledTime: Fecha y hora UTC en formato ISO 8601. Opcional: si se omite, la publicación se crea como borrador. Envía una hora futura para programarla. Una hora con cinco o más minutos en el pasado se rechaza con SCHEDULED_TIME_IN_PAST, así que para publicación inmediata usa la hora actual más un minuto.
• mediaUrls: hasta 10 URLs públicas https de imágenes o videos. Publora las descarga del lado del servidor y las adjunta antes de la validación, por lo que los medios y la programación se realizan en una sola llamada. Esta es la alternativa directa al flujo de borrador seguido de get_upload_url y luego complete_media. La ingesta tiene un límite de 60 URLs por hora.

get_upload_url

Obtiene una URL prefirmada para la subida de medios.

complete_media

Finaliza un archivo subido mediante get_upload_url, después de que el PUT prefirmado haya tenido éxito. Es opcional, porque la programación también finaliza los medios pendientes, pero llamarlo de forma anticipada permite detectar errores de formato y sonda antes de publicar. No es necesario para medios adjuntos con mediaUrls.

Parámetros:

• mediaId: el ID devuelto por get_upload_url

list_connections

Lista tus cuentas conectadas con sus IDs de plataforma. Llama a esto primero y copia los IDs textualmente; nunca son adivinables.

list_posts / get_post / update_post / delete_post

Gestiona publicaciones programadas y borradores. update_post también modifica content y platforms en un borrador o publicación programada, por lo que corregir un error tipográfico o redirigir la publicación ya no implica eliminarla y volver a crearla. delete_media y prune_media_reference limpian los archivos subidos.

Opciones de publicación (vía API REST)

Opciones específicas de Telegram disponibles a través de platformSettings.telegram en la API REST:

Opción	Descripción
disableNotification	Enviar en silencio (sin sonido)
disableWebPagePreview	Sin tarjetas de previsualización de enlaces
protectContent	Evitar reenvío/guardado

El pie de foto sobre el medio no se puede configurar: showCaptionAboveMedia no es una clave aceptada y enviarla devuelve 400 PLATFORM_SETTING_UNKNOWN.

Nota: platformSettings es aceptado por las herramientas MCP create_post y update_post, así como por REST. El esquema es estricto: una plataforma o clave mal escrita se rechaza con un error de validación en lugar de ignorarse silenciosamente.

Ejemplos

Publicación simple en canal

Publica esto en mi canal de Telegram:
"*Actualización de producto v2.5*

Hemos lanzado las siguientes mejoras:
- _Tiempos de respuesta de API más rápidos_ (promedio 45ms)
- Nuevo endpoint `batch` para operaciones masivas

[Leer el changelog](https://example.com/changelog)"

Anuncio formateado

Crea una publicación en Telegram con este formato:
"*Actualización importante*

Mañana a las 10 AM UTC lanzamos nuestra nueva función.

_Qué hay de nuevo:_
- Mejoras en la función A
- Lanzamiento de la función B

[Leer el anuncio completo](https://example.com/update)"

Publicación con imagen

Publica esta imagen en mi canal de Telegram con el pie:
"*Vista previa del nuevo panel*

Aquí tienes un adelanto de nuestro panel de análisis rediseñado."

Importante: El pie de foto debe tener menos de 1,024 caracteres al publicar con medios.

Publicación programada

Programa esto para mañana a las 8 AM hora de Moscú:
"*¡Buenos días!* Aquí tienes el resumen de mercado de hoy..."

Restricciones importantes

1. Límite del pie de foto: 1,024 caracteres: Al publicar con medios (imágenes/videos), el texto se envía como pie de foto limitado a 1,024 caracteres. Los mensajes solo de texto permiten 4,096 caracteres.

2. Video máximo 50 MB: La Bot API limita los videos a 50 MB (no 4 GB como los usuarios normales). Los videos grandes fallarán.

3. El bot debe ser administrador: Tu bot necesita el rol de administrador con permiso can_post_messages. Esto se verifica al momento de la conexión.

4. Sin medios mixtos: Una sola publicación no puede contener tanto imágenes como videos.

5. Desbordamiento del pie de foto: Si el pie de foto supera los 1,024 caracteres en una publicación con medios, se envía como un mensaje de respuesta separado en lugar de truncarse.

Buenas prácticas

Contenido

1. Usa formato: Los titulares en negrita y el énfasis en cursiva mejoran la legibilidad
2. Previsualizaciones de enlaces: Excelentes para artículos; desactívalas para anuncios más limpios
3. Uso de emojis: Comunes y esperados en Telegram
4. Longitud de publicación: No hay penalización por publicaciones más largas en mensajes solo de texto

Horario

• Audiencia global: Los usuarios de Telegram están en todo el mundo; considera las zonas horarias en las publicaciones
• Mejores horas: 8-10 AM, 12-2 PM, 7-9 PM en las regiones objetivo
• Frecuencia: Los canales pueden publicar con mayor frecuencia (5-10/día)

Participación

• Habilita los comentarios en la configuración del canal para fomentar debates
• Usa encuestas para aumentar la participación
• Fija los anuncios importantes

Solución de problemas

Error	Causa	Solución
"Bot no es administrador"	El bot no tiene permisos de admin	Añade el bot como administrador con can_post_messages
"Canal no encontrado"	Nombre/ID de canal incorrecto	Verifica @nombrecanal o el ID numérico del chat
MEDIA_CAPTION_TOO_LONG	Pie de foto > 1,024 caracteres	Acorta el pie de foto o usa una publicación solo de texto
"Bad Request: el archivo es demasiado grande"	Archivo > 50 MB	Comprime el video/imagen a menos de 50 MB
"Medios mixtos no soportados"	Imágenes + video en la misma publicación	Usa un solo tipo de medio por publicación