99,95% uptime
SLO da API nos últimos 12 meses
Docs • API v2.4.0 Enterprise
Documentação e API do Boostly
Do primeiro token à produção em 15 minutos: OAuth 2.0, endpoints REST, webhooks assinados HMAC-SHA256 e SDK prontos. Abaixo: consola API viva — troque endpoints e linguagens, prima «Executar».
1. Crie uma app
Registe-se, obtenha client_id e client_secret. Adicione redirect URI — tokens só via OAuth 2.0 oficial da Meta*.
2. Obtenha um token
Troque o authorization code por um access token. Tokens long-lived renovam-se 7 dias antes de expirar.
3. Encontre um thread e responda
Chame GET /v1/threads/search, redija com POST /v1/replies/draft e publique via approve — ou confirme no Telegram.
Consola API playground
Escolha endpoint e linguagem — o código gera-se sozinho. «Executar» devolve resposta mock com latência.
Resposta
~120 ms
latência mediana da REST API (p50)
40+ endpoints
threads, respostas, anúncios, DM, analítica
15 minutos
do registo à primeira chamada API
Capacidades
Tudo para integrar, pronto
Auth, eventos, limites e SDK: os quatro pilares das integrações.
OAuth 2.0 + scopes
Scopes mínimos por ação, PKCE para clientes públicos, revoke numa chamada DELETE /v1/tokens.
Webhooks assinados
Cada evento assinado HMAC-SHA256 (X-Hub-Signature-256). Retries com backoff exponencial até 24 h.
Rate limits honestos
Limites em cabeçalhos X-RateLimit-*. O jitter adaptativo de 4–9 min mantém a conta fora dos filtros de spam da Meta*.
SDK e CLI
SDK oficiais para Python, Go e TypeScript + spec OpenAPI 3.1. Gere um cliente para a sua stack num minuto.
Engineering Deep Dive
Como a API funciona por dentro
Quatro decisões de engenharia que tornam integrações previsíveis.
Autenticação OAuth 2.0
Authorization Code + PKCE. Scopes: threads.read, replies.write, ads.moderate, dm.send. Tokens em vault AES-256-GCM, renovação transparente.
Webhooks e HMAC-SHA256
Assinatura sobre o raw body com o seu app secret. Verifique com comparação timing-safe, responda 200 em 10 segundos — ou repetimos.
Rate limits
600 req/min por chave, 35 publicações/dia por perfil, jitter 4–9 min. Perante 429 — cabeçalho Retry-After e fila do nosso lado.
Abordagem SDK-first
OpenAPI 3.1 → clientes gerados. Os SDK repetem, refrescam tokens e mascaram PII nos logs por defeito.
Referência de endpoints
Núcleo REST API: método, rota e propósito.
| Método | Rota | Descrição |
|---|---|---|
| GET | /v1/threads/search | Pesquisa semântica de threads quentes com scoring. |
| POST | /v1/replies/draft | Rascunho de resposta de especialista no seu tom. |
| POST | /v1/replies/approve | Aprovação: publicar ou fila do Telegram. |
| GET | /v1/ads/comments | Fluxo de comentários sob os seus criativos. |
| POST | /v1/ads/comments/hide | Shadow-hide de spam: o autor nunca nota. |
| POST | /v1/dm/send | Isca digital ao DM com qualificação. |
Exemplo de webhook: novo thread quente
O Boostly chama o seu URL a cada evento. Verifique a assinatura antes de processar.
POST → https://seu-domínio/hooks/boostly • cabeçalho 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 erro
Todos os erros são JSON com code, message e retryable.
| Código | Significado | O que fazer |
|---|---|---|
| 400 invalid_scope | Scope fora do App Review | Remova o scope extra, consulte docs |
| 401 token_expired | Token expirado | Refresque ou repita OAuth |
| 409 already_published | Resposta já publicada | Peça GET de estado em vez de repetir |
| 422 spam_suspect | Rejeitado como spam pela Meta* | Suba o jitter, abrande |
| 429 rate_limited | Limite excedido | Respeite Retry-After, ative a fila |
Boostly API vs Graph API direta vs scraping
Porque as integrações se constroem sobre nós, não à volta.
| Critério | Boostly API | Direto / scraping |
|---|---|---|
| Risco de ban | 0%: quotas oficiais e jitter | Alto: limites manuais e bans |
| Aprovação Telegram | Integrada: cartões em 1 toque | Construir do zero |
| Moderação antispam | Dark Post Shield incluído | Só ocultar manual |
| Auditoria | Log, máscaras PII, export SIEM | Logue você mesmo |
Lance a primeira integração hoje
Sandbox, spec OpenAPI e SDK — grátis no trial. Primeira resposta aprovada em 15 minutos.
Lance a primeira integração hojeSandbox incluída • Sem cartão
v2.4.0Começar 3 dias grátis
Perguntas sobre a API
Registe uma app no dashboard: obtenha client_id e client_secret, complete OAuth 2.0. A sandbox de testes vai no trial — grátis.
Calcule HMAC-SHA256 do raw body com o seu app secret e compare com X-Hub-Signature-256 (timing-safe). Exemplo na secção de webhooks.
600 req/min por chave, até 35 publicações/dia por perfil, jitter 4–9 min. Visíveis em cabeçalhos X-RateLimit-*.
SDK oficiais para Python, Go e TypeScript mais spec OpenAPI 3.1 para qualquer linguagem. Exemplos nas abas da consola.
Respeite Retry-After e enfila — os SDK fazem-no sozinhos. Não martele retries: é a via rápida para o ban da Meta*.
Sim: DELETE /v1/tokens/{id} revoga no instante. Perante anomalia o auto-revoke age sozinho e avisa no Telegram.