99,95% uptime
SLO de la API en los últimos 12 meses
Docs • API v2.4.0 Enterprise
Documentación y API de Boostly
Del primer token a producción en 15 minutos: OAuth 2.0, endpoints REST, webhooks firmados HMAC-SHA256 y SDK listos. Abajo: consola API viva — cambia endpoints e idiomas, pulsa «Ejecutar».
1. Crea una app
Regístrate, obtén client_id y client_secret. Añade redirect URI: tokens solo vía OAuth 2.0 oficial de Meta*.
2. Obtén un token
Canjea el authorization code por un access token. Los tokens long-lived se renuevan 7 días antes de expirar.
3. Encuentra un hilo y responde
Llama GET /v1/threads/search, redacta con POST /v1/replies/draft y publica vía approve — o confirma en Telegram.
Consola API playground
Elige endpoint e idioma — el código se genera solo. «Ejecutar» devuelve una respuesta mock con latencia.
Respuesta
~120 ms
latencia mediana de la REST API (p50)
40+ endpoints
hilos, respuestas, anuncios, DM, analítica
15 minutos
del registro a la primera llamada API
Capacidades
Todo para integrarse, listo
Auth, eventos, límites y SDK: los cuatro pilares de las integraciones.
OAuth 2.0 + scopes
Scopes mínimos por acción, PKCE para clientes públicos, revoke en una llamada DELETE /v1/tokens.
Webhooks firmados
Cada evento firmado HMAC-SHA256 (X-Hub-Signature-256). Reintentos con backoff exponencial hasta 24 h.
Rate limits honestos
Límites en cabeceras X-RateLimit-*. El jitter adaptativo de 4–9 min mantiene la cuenta fuera de filtros spam de Meta*.
SDK y CLI
SDK oficiales para Python, Go y TypeScript + spec OpenAPI 3.1. Genera un cliente para tu stack en un minuto.
Engineering Deep Dive
Cómo funciona la API por dentro
Cuatro decisiones de ingeniería que hacen predecibles las integraciones.
Autenticación OAuth 2.0
Authorization Code + PKCE. Scopes: threads.read, replies.write, ads.moderate, dm.send. Tokens en vault AES-256-GCM, renovación transparente.
Webhooks y HMAC-SHA256
Firma sobre el raw body con tu app secret. Verifica con comparación timing-safe, responde 200 en 10 segundos — o reintentamos.
Rate limits
600 req/min por clave, 35 publicaciones/día por perfil, jitter 4–9 min. Ante 429 — cabecera Retry-After y cola de nuestro lado.
Enfoque SDK-first
OpenAPI 3.1 → clientes generados. Los SDK reintentan, refrescan tokens y enmascaran PII en logs por defecto.
Referencia de endpoints
Núcleo REST API: método, ruta y propósito.
| Método | Ruta | Descripción |
|---|---|---|
| GET | /v1/threads/search | Búsqueda semántica de hilos calientes con intent scoring. |
| POST | /v1/replies/draft | Borrador de respuesta experta en tu tono. |
| POST | /v1/replies/approve | Aprobación: publicar o cola de Telegram. |
| GET | /v1/ads/comments | Flujo de comentarios bajo tus creatividades. |
| POST | /v1/ads/comments/hide | Shadow-hide de spam: el autor no lo nota. |
| POST | /v1/dm/send | Lead magnet al DM con calificación. |
Ejemplo de webhook: nuevo hilo caliente
Boostly llama a tu URL en cada evento. Verifica la firma antes de procesar.
POST → https://tu-dominio/hooks/boostly • cabecera X-Hub-Signature-256
POST /hooks/boostly HTTP/1.1
X-Hub-Signature-256: sha256=9f2c…e41a
{
"event": "thread.hot",
"thread_id": "thr_8H2KQ",
"intent_score": 0.96,
"replies_18m": 48,
"lang": "ru"
}
import hmac, hashlib
sig = hmac.new(APP_SECRET, raw_body, hashlib.sha256).hexdigest()
ok = hmac.compare_digest("sha256=" + sig, request.headers["X-Hub-Signature-256"])
Códigos de error
Todos los errores son JSON con code, message y retryable.
| Código | Significado | Qué hacer |
|---|---|---|
| 400 invalid_scope | Scope fuera del App Review | Quita el scope extra, revisa docs |
| 401 token_expired | Token expirado | Refresca o repite OAuth |
| 409 already_published | Respuesta ya publicada | Pide GET de estado en vez de reintentar |
| 422 spam_suspect | Rechazado como spam por Meta* | Sube el jitter, baja el ritmo |
| 429 rate_limited | Límite excedido | Respeta Retry-After, activa la cola |
Boostly API vs Graph API directa vs scraping
Por qué las integraciones se construyen sobre nosotros, no alrededor.
| Criterio | Boostly API | Directo / scraping |
|---|---|---|
| Riesgo de baneo | 0%: cuotas oficiales y jitter | Alto: límites manuales y baneos |
| Aprobación Telegram | Integrada: tarjetas en 1 toque | Construir desde cero |
| Moderación antispam | Dark Post Shield incluido | Solo ocultado manual |
| Auditoría | Log, máscaras PII, export SIEM | Loguear por tu cuenta |
Lanza tu primera integración hoy
Sandbox, spec OpenAPI y SDK — gratis en el trial. Primera respuesta aprobada en 15 minutos.
Lanza tu primera integración hoySandbox incluido • Sin tarjeta
v2.4.0Empezar 3 días gratis
Preguntas sobre la API
Registra una app en el dashboard: obtén client_id y client_secret, completa OAuth 2.0. El sandbox de pruebas va en el trial — gratis.
Calcula HMAC-SHA256 del raw body con tu app secret y compara con X-Hub-Signature-256 (timing-safe). Ejemplo en la sección de webhooks.
600 req/min por clave, hasta 35 publicaciones/día por perfil, jitter 4–9 min. Visibles en cabeceras X-RateLimit-*.
SDK oficiales para Python, Go y TypeScript más spec OpenAPI 3.1 para cualquier lenguaje. Ejemplos en las pestañas de la consola.
Respeta Retry-After y encola — los SDK lo hacen solos. No machaques reintentos: es la vía rápida al baneo de Meta*.
Sí: DELETE /v1/tokens/{id} revoca al instante. Ante anomalía el auto-revoke actúa solo y avisa por Telegram.