TeleBoost

npx add-mcp 'https://mcp.teleboost.app/mcp'

Primeros pasos

La API de TeleBoost está disponible en los planes Pro y Business. Crea una clave en Configuración → Desarrolladores → Claves de API — se muestra una sola vez, así que cópiala en ese momento. Todas las solicitudes usan HTTPS y devuelven JSON.

curl https://teleboost.app/api/v1/contacts \
  -H "Authorization: Bearer tb_live_your_key_here"

Los endpoints de listas devuelven { "data": [...], "next_cursor": "...", "has_more": true }. Pasa next_cursor de vuelta como ?cursor= para paginar.

Autenticación y alcances

Dos mecanismos, un modelo de alcances. Usa una clave de API (Authorization: Bearer tb_live_…) para scripts y automatización, o OAuth 2.1 para aplicaciones de IA que se conectan mediante MCP. Las claves están limitadas al espacio de trabajo: una clave está vinculada a tus datos individuales o a un equipo en el momento de su creación.

Alcance	Otorga
workspace.read	Metadatos del espacio de trabajo, miembros del equipo, uso del plan y cuotas
accounts.write	Actualizar configuraciones de cuentas conectadas, como cuotas diarias de envío
contacts.read / write	Prospectos, campos personalizados, notas, estados y puntuaciones de participación
lists.read / write	Listas y sus miembros
groups.read / write	Grupos de Telegram guardados (objetivos de campañas y scraping)
inbox.read	Conversaciones e historial de mensajes en todas las cuentas
messages.send	Enviar mensajes desde una cuenta conectada
campaigns.read / write	Campañas de DM y grupos, estadísticas, iniciar / pausar
templates.read / write	Plantillas de mensajes y personalidades de IA
tickets.read / write	Tickets, estados, prioridades, SLA y recordatorios
analytics.read	Métricas agregadas, paneles y mapas de calor

Recursos de la API

Todas las rutas son relativas a https://teleboost.app/api/v1. A continuación se muestra una selección — la referencia completa y siempre actualizada de cada endpoint está en la especificación OpenAPI.

Método	Ruta	Descripción	Alcance
GET	/accounts	Listar cuentas conectadas (solo estado)	workspace.read
PATCH	/accounts/{id}/quota	Actualizar la cuota de envío de una cuenta	accounts.write
GET	/contacts	Listar y buscar contactos	contacts.read
POST	/contacts	Crear un contacto	contacts.write
PATCH	/contacts/{id}	Actualizar estado, campos personalizados	contacts.write
GET	/lists	Explorar listas con conteos	lists.read
POST	/lists/{id}/contacts	Agregar contactos a una lista	lists.write
GET	/groups	Listar grupos de Telegram guardados	groups.read
GET	/conversations	Listar conversaciones de la bandeja de entrada	inbox.read
GET	/conversations/{id}/messages	Historial de mensajes	inbox.read
POST	/messages	Enviar un mensaje	messages.send
GET	/campaigns/dm	Listar campañas de DM	campaigns.read
POST	/campaigns/dm/{id}/start	Iniciar / reanudar una campaña de DM	campaigns.write
POST	/campaigns/group	Crear una campaña de grupo	campaigns.write
GET	/templates	Listar plantillas de mensajes	templates.read
GET	/personalities	Listar personalidades de IA	templates.read
GET	/tickets	Listar tickets	tickets.read
POST	/tickets	Crear un ticket	tickets.write
POST	/reminders	Crear un recordatorio	tickets.write
GET	/analytics/summary	KPIs agregados	analytics.read
GET	/analytics/activity	Mapa de calor de actividad entrante 7×24	analytics.read
GET	/workspace/usage	Uso del plan y cuotas de API	workspace.read

Servidor MCP

TeleBoost ejecuta un servidor MCP alojado para que cualquier IA compatible con MCP — Claude, ChatGPT, Cursor, Zed y herramientas de automatización como n8n y Make — pueda trabajar directamente con tu pipeline.

MCP endpoint:  https://mcp.teleboost.app/mcp

1. Copy the URL from Settings → Developers → Connected AI apps
2. Add it as a custom connector in your AI tool
3. Authorize via the TeleBoost consent screen (OAuth 2.1 + PKCE)

El servidor expone herramientas que reflejan la API: search_contacts, get_conversation, create_ticket, send_message, start_campaign, get_analytics_summary y más. Las herramientas fuera de los alcances otorgados a una conexión nunca se exponen.

Webhooks

Registra un endpoint HTTPS en Configuración → Desarrolladores → Webhooks. Cada entrega incluye un encabezado X-TeleBoost-Signature — un HMAC-SHA256 del cuerpo con el secreto de tu endpoint. Verifícalo antes de confiar en el payload.

import hmac, hashlib

def verify(body: bytes, header: str, secret: str) -> bool:
    expected = "sha256=" + hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, header)

Las entregas se reintentan con retroceso exponencial hasta por 24 horas; los endpoints que fallan repetidamente se desactivan automáticamente con una alerta. Eventos disponibles:

Límites de tasa

Los límites dependen del plan y se devuelven en cada respuesta mediante los encabezados X-RateLimit-*. Un 429 incluye Retry-After.

Plan	Por minuto	Por día	Envíos / hora
Pro	120	10,000	30
Business	300	50,000	100

Los envíos de mensajes también respetan la cuota de seguridad propia de cada cuenta — el límite horario de API es adicional a esos límites, no en lugar de ellos.