API Documentation

POST /api/capture-lead Capturar um novo lead

Parâmetros (Body JSON)

Campo	Tipo	Obrigatório	Descrição
nome	string	Sim	Nome do lead
email	string	Não	Email do lead
telefone	string	Não	Telefone (formato E.164)
url_origem	string	Não	URL de onde o lead veio
robotName	string	Não	Nome do assistente

Exemplo — cURL

bash

# Capturar um lead
curl -X POST https://linkmagico.app.br/api/capture-lead \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_API_KEY" \
  -d '{
    "nome": "João Silva",
    "email": "joao@email.com",
    "telefone": "+5511999999999",
    "url_origem": "https://meusite.com"
  }'

Resposta (200 OK)

json

{
  "success": true,
  "leadId": "lead_abc123",
  "message": "Lead capturado com sucesso"
}

POST /api/process-chat-inteligente Enviar mensagem ao chat IA

Parâmetros (Body JSON)

Campo	Tipo	Obrigatório	Descrição
message	string	Sim	Mensagem do usuário
robotName	string	Sim	Nome do assistente
leadId	string	Não	ID do lead (para contexto)
conversationId	string	Não	ID da conversa (continuidade)

Exemplo — JavaScript (fetch)

javascript

const response = await fetch('https://linkmagico.app.br/api/process-chat-inteligente', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'SUA_API_KEY'
  },
  body: JSON.stringify({
    message: 'Quero saber sobre o produto',
    robotName: 'MeuAssistente'
  })
});
const data = await response.json();
console.log(data.response); // Resposta da IA

Resposta (200 OK)

json

{
  "success": true,
  "response": "Olá! Posso ajudar com informações...",
  "conversationId": "conv_xyz789"
}

POST /api/track-conversion Rastrear evento de conversão

Parâmetros (Body JSON)

Campo	Tipo	Obrigatório	Descrição
apiKey	string	Sim	API Key do tenant
type	string	Sim	"cta_click" ou "checkout_click"
url	string	Não	URL do link clicado
leadId	string	Não	ID do lead que clicou

Exemplo — cURL

bash

curl -X POST https://linkmagico.app.br/api/track-conversion \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "SUA_API_KEY",
    "type": "checkout_click",
    "url": "https://pay.hotmart.com/xxx"
  }'

GET /api/conversion-stats Métricas de conversão do tenant

Autenticação

Requer X-API-Key ou ?apiKey=

Resposta (200 OK)

json

{
  "success": true,
  "stats": {
    "totalCtaClicks": 142,
    "totalCheckoutClicks": 38,
    "conversionRate": "26.8%",
    "last7days": [
      { "date": "2026-05-20", "cta": 22, "checkout": 6 }
    ]
  }
}

POST /admin/leads/backup/create Criar backup dos leads

Autenticação

Requer X-API-Key

Exemplo — cURL

bash

curl -X POST https://linkmagico.app.br/admin/leads/backup/create \
  -H "X-API-Key: SUA_API_KEY"

Plano	Mensagens/mês	Chatbots	Leads
Starter	500	1	100
Pro	2.000	3	500
Scale	10.000	10	2.000

Como autenticar

Rate Limits