API REST do Captafy: guia completo para desenvolvedores

Visão geral da API

A API REST do Captafy permite acesso programático a leads, scores, eventos e configurações. Base URL: https://api.captafy.io/v1.

Autenticação

Use API keys no header Authorization: Authorization: Bearer sua_api_key. Gere chaves no Dashboard → Configurações → API.

Endpoints principais

GET /leads

Lista leads com filtros: score mínimo, data, página visitada, fonte. Suporta paginação.

GET /leads/:id

Perfil completo de um lead: score, histórico de visitas, eventos, propriedades customizadas.

GET /leads/:id/events

Timeline de eventos de um lead específico.

POST /events

Envie eventos server-side. Útil para enriquecer perfis com dados de backend (compra realizada, plano atualizado).

POST /webhooks

Configure webhooks programaticamente.

Rate limits

Free: 100 req/min. Pro: 1.000 req/min. Enterprise: customizado. Headers X-RateLimit-Remaining informam o limite restante.

Exemplo prático: exportar leads quentes

curl -H "Authorization: Bearer sk_live_xxx" "https://api.captafy.io/v1/leads?min_score=80&limit=50"

Retorna JSON com os 50 leads mais quentes, incluindo score, páginas visitadas e timestamps.

SDKs

SDKs oficiais disponíveis para Node.js, Python e Go. Instale via npm/pip/go get.

API-first: tudo que o dashboard faz, a API faz. Integre como quiser.

Comece a usar

Documentação completa em captafy.io/docs/api. API keys disponíveis no plano gratuito.