El Telegram Bot API para tu bandeja de entrada unificada
Una bandeja de entrada unificada para los mensajes directos de tu bot de Telegram.
- Nivel gratuito, sin tarjeta
- API key al instante
- Servidor MCP incluido
Sam O.
últ. vez recientemente
/start18:41
Llegó mi pedido, ¡qué rápido!18:42
¡Qué bueno que llegaron!18:45
Talla equivocada, ¿puedo devolverlos?❤️09:12
Claro, tráelos con esta etiqueta.09:14
/v1/inbox/conversations/{id}/messages200 OKCapacidades: Lo que puedes construir en Telegram
Cada capacidad es un endpoint, el mismo que llamas en todas las demás plataformas.Las pantallas muestran dónde llega cada llamada.
Mensajes directos
Lee los mensajes directos que recibe tu bot y responde con texto, una foto (por URL) o un documento (por URL).
- GET
/v1/inbox/conversations - POST
/v1/inbox/conversations/{id}/messages
Maya R.
últ. vez recientemente
Hoy¿Puedo ver las nuevas bajas?11:20
Aquí están, en tienda el sábado.11:21
- GET
Webhooks
Recibe eventos de webhook en tiempo real en el momento en que un usuario envía un mensaje a tu bot.
Eventos de webhook
dm.received
En todas las plataformas
Listo para agentes
Cada capacidad de Telegram es una herramienta tipada del servidor MCP de SocialAPI.ai.
- social_api_send_dm
Una sola API key
La key que llama a Telegram llama a las 13 plataformas.
Authorization: Bearer sapi_key_…Errores predecibles
Los mismos códigos de estado en todas partes, sin importar la plataforma detrás.
- 401token expirado
- 429límite de tasa
- 501no disponible en esta plataforma
Llama a la API de Telegram
Conectar un bot de Telegram
Los bots de Telegram usan un token estático de @BotFather, no OAuth. Pasa el token en los metadatos y SocialAPI.ai lo valida, registra el webhook y almacena la cuenta en una sola llamada.
curl -X POST https://api.social-api.ai/v1/accounts/connect \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"platform": "telegram",
"metadata": { "bot_token": "<token from @BotFather>" }
}' | jq
# Response (HTTP 201)
{
"account_id": "acc_01HZ9...",
"platform": "telegram",
"username": "mysocialinboxbot",
"display_name": "My Social Inbox Bot"
}En detalle: Cómo funciona la API de Telegram en SocialAPI.ai
Conecta un bot de Telegram con un token de @BotFather y lee y responde sus mensajes directos a través de la misma API que usas para todas las demás plataformas. SocialAPI.ai envuelve el Telegram Bot API y entrega los mensajes entrantes en tiempo real a través de webhooks. Telegram es un conector de mensajería: gestiona DMs, no publicaciones ni comentarios.
DMs entrantes en tiempo real
Cuando conectas un bot, SocialAPI.ai registra automáticamente un webhook de Telegram. Cada mensaje directo que recibe tu bot se ingiere en tiempo real y se muestra en la bandeja de entrada unificada, con el mismo esquema de conversación y mensaje utilizado en todas las plataformas. Telegram no tiene una API de historial de mensajes, por lo que la bandeja de entrada se construye a partir de los mensajes que llegan después de conectarte.
Envía respuestas en una sola llamada
Responde a una conversación con texto, una foto por URL o un documento por URL. SocialAPI.ai elige el método de Telegram correcto para ti. Las respuestas se envían a través del mismo endpoint de envío de mensajes que ya usas para otras plataformas de mensajería.
Configuración en dos minutos, sin revisión de aplicación
Crea un bot enviando un mensaje a @BotFather y enviando /newbot, copia el token y pégalo. No hay cuenta de desarrollador, no hay verificación de empresa y no hay revisión de aplicación. Compara eso con las plataformas de Meta, que requieren una aplicación aprobada antes del acceso a producción.
Precios simples y honestos.
Leer comentarios, DMs y menciones es gratis e ilimitado en todos los planes. Los planes de pago comienzan en $29/mes con posts e interacciones ilimitados. El nivel gratuito no requiere tarjeta de crédito.
Preguntas frecuentes
Lo que preguntan los desarrolladores antes de lanzar con Telegram.
¿Cómo obtengo un token de bot de Telegram?
Abre Telegram, envía un mensaje a @BotFather, envía /newbot y sigue las instrucciones para elegir un nombre y un nombre de usuario que termine en bot. BotFather responde con un token con el formato <bot_id>:<secret>. Pega ese token al conectarte. Todo el proceso tarda unos dos minutos sin revisión de aplicación.
¿Puedo publicar posts en Telegram?
No. El conector de Telegram en SocialAPI.ai es solo de mensajería. Lee y responde a los mensajes directos de tu bot. No publica posts en canales o grupos.
¿Telegram funciona para chats privados y grupos?
El conector está diseñado alrededor de los mensajes directos, donde la conversación se mapea al chat del usuario con tu bot. Un bot solo puede ver los mensajes que un usuario envía después de iniciarlo, y un bot nunca puede enviar mensajes a un usuario que no le haya enviado mensajes primero.
Todas las demás plataformas, una sola API: Todas las demás plataformas, una sola API
La misma key, las mismas estructuras, el mismo webhook.
¿Listo para unificar tus interacciones sociales?
Nivel gratuito disponible. Sin tarjeta de crédito. Incluye el servidor MCP.