TeleBoost

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

Começando

A API do TeleBoost está disponível nos planos Pro e Business. Crie uma chave em Configurações → Desenvolvedores → Chaves de API — ela é exibida apenas uma vez, então copie-a nesse momento. Todas as solicitações usam HTTPS e retornam JSON.

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

Os endpoints de listagem retornam { "data": [...], "next_cursor": "...", "has_more": true }. Envie next_cursor de volta como ?cursor= para paginar.

Autenticação e escopos

Dois mecanismos, um modelo de escopo. Use uma chave de API (Authorization: Bearer tb_live_…) para scripts e automação, ou OAuth 2.1 para aplicativos de IA conectados via MCP. As chaves são limitadas ao workspace: uma chave está vinculada aos seus dados individuais ou a uma equipe no momento da criação.

Escopo	Concede
workspace.read	Metadados do workspace, membros da equipe, uso do plano e cotas
accounts.write	Atualizar configurações de contas conectadas, como cotas diárias de envio
contacts.read / write	Leads, campos personalizados, notas, status e pontuações de engajamento
lists.read / write	Listas e seus membros
groups.read / write	Grupos salvos do Telegram (alvos de campanha e raspagem)
inbox.read	Conversas e histórico de mensagens em todas as contas
messages.send	Enviar mensagens de uma conta conectada
campaigns.read / write	Campanhas de DM e grupo, estatísticas, iniciar / pausar
templates.read / write	Modelos de mensagem e personalidades de IA
tickets.read / write	Tickets, status, prioridades, SLA e lembretes
analytics.read	Métricas agregadas, painéis e mapas de calor

Recursos da API

Todos os caminhos são relativos a https://teleboost.app/api/v1. Uma seleção é mostrada abaixo — a referência completa e sempre atualizada de cada endpoint está na especificação OpenAPI.

Método	Caminho	Descrição	Escopo
GET	/accounts	Listar contas conectadas (somente status)	workspace.read
PATCH	/accounts/{id}/quota	Atualizar a cota de envio de uma conta	accounts.write
GET	/contacts	Listar e pesquisar contatos	contacts.read
POST	/contacts	Criar um contato	contacts.write
PATCH	/contacts/{id}	Atualizar status, campos personalizados	contacts.write
GET	/lists	Navegar pelas listas com contagens	lists.read
POST	/lists/{id}/contacts	Adicionar contatos a uma lista	lists.write
GET	/groups	Listar grupos salvos do Telegram	groups.read
GET	/conversations	Listar conversas da caixa de entrada	inbox.read
GET	/conversations/{id}/messages	Histórico de mensagens	inbox.read
POST	/messages	Enviar uma mensagem	messages.send
GET	/campaigns/dm	Listar campanhas de DM	campaigns.read
POST	/campaigns/dm/{id}/start	Iniciar / retomar uma campanha de DM	campaigns.write
POST	/campaigns/group	Criar uma campanha de grupo	campaigns.write
GET	/templates	Listar modelos de mensagem	templates.read
GET	/personalities	Listar personalidades de IA	templates.read
GET	/tickets	Listar tickets	tickets.read
POST	/tickets	Criar um ticket	tickets.write
POST	/reminders	Criar um lembrete	tickets.write
GET	/analytics/summary	KPIs agregados	analytics.read
GET	/analytics/activity	Mapa de calor de atividade de entrada 7×24	analytics.read
GET	/workspace/usage	Uso do plano e cotas da API	workspace.read

Servidor MCP

O TeleBoost executa um servidor MCP hospedado para que qualquer IA compatível com MCP — Claude, ChatGPT, Cursor, Zed e ferramentas de automação como n8n e Make — possa trabalhar diretamente com seu 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)

O servidor expõe ferramentas que espelham a API: search_contacts, get_conversation, create_ticket, send_message, start_campaign, get_analytics_summary e outras. Ferramentas fora dos escopos concedidos a uma conexão nunca são expostas.

Webhooks

Registre um endpoint HTTPS em Configurações → Desenvolvedores → Webhooks. Cada entrega carrega um cabeçalho X-TeleBoost-Signature — um HMAC-SHA256 do corpo com o segredo do seu endpoint. Verifique-o antes de confiar no 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)

As entregas são repetidas com backoff exponencial por até 24 horas; endpoints que continuam falhando são desativados automaticamente com um alerta. Eventos disponíveis:

Limites de taxa

Os limites são por plano e retornados em cada resposta por meio dos cabeçalhos X-RateLimit-*. Um 429 inclui Retry-After.

Plano	Por minuto	Por dia	Envios / hora
Pro	120	10.000	30
Business	300	50.000	100

O envio de mensagens também respeita a cota de segurança de cada conta — o limite horário da API é adicional, e não substituto, desses limites.