Referência da API
Live — v1 available now

REST API

Acione chamadas de voz AI, sincronize contatos e leia os resultados das chamadas de qualquer backend, CRM ou ferramenta sem código.

Base URL:https://outboundcalls.ai/api/v1

Authentication

Generate an API key from Dashboard → Settings → API Keys. Passe como um token Bearer em cada solicitação.

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

As chaves são hashadas em repouso e mostradasonly oncena criação. Gire ou revogue a qualquer momento na mesma página de Configurações.

O que você pode conectar

A API é REST simples + token Bearer, então funciona com qualquer coisa que fale HTTPS — nenhum SDK necessário.

Zapier

Webhooks + HTTP

Acione chamadas quando um novo lead for adicionado ao seu CRM, planilha ou formulário.

Make (Integromat)

Módulo HTTP

Crie fluxos de trabalho visuais: Formulário → OutboundCalls → atualização Slack/Email/CRM.

n8n

Nó de Solicitação HTTP

Automação auto-hospedada. Conecte seu banco de dados, agendador ou pilha de mensagens.

HubSpot / Salesforce / Pipedrive

CRM

Envie novos contatos para uma campanha automaticamente; puxe resumos de chamadas como registros de atividade.

Backend personalizado (Node, Python, PHP, Go, Ruby)

Qualquer linguagem

REST padrão + token Bearer. Funciona com qualquer coisa que possa fazer uma chamada HTTPS.

Plataformas sem código (Bubble, Retool, Airtable Automations)

Sem código

Conecte o endpoint a uma ação de fluxo de trabalho — sem SDK necessário.

Fluxos de trabalho reais que você pode construir

Um novo lead preenche seu Typeform → ligue para eles em até 30 segundos
Booking confirmation in Calendly → AI agent calls 24h before to confirm
Failed Stripe payment → reminder call instead of just an email
Upload diário de CSV do seu CRM → agente de IA liga para cada contato durante o horário comercial
WhatsApp inbound message → callback from voice agent if requested
Progresso de campanha de longa duração sincronizado em seu data warehouse a cada 15 min

Endpoints

Conta

GET/me

Agentes

GET/agents
GET/agents/:id

Contatos

GET/contacts
POST/contacts

Chamadas

POST/calls
GET/calls
GET/calls/:id

Campanhas

GET/campaigns
GET/campaigns/:id

Mais endpoints (criar/atualizar/excluir agentes, importação CSV, controle de campanha) estão no roadmap. Precisa de um urgentemente?Tell us.

Code examples

cURL
# Trigger an outbound call from your agent
curl -X POST https://outboundcalls.ai/api/v1/calls \
  -H "Authorization: Bearer oc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "clxAGENT123",
    "toNumber": "+14155551212",
    "contactId": "clxCONTACT456"
  }'

# Response
{
  "id": "clxCALL789",
  "phoneFrom": "+12025550100",
  "phoneTo": "+14155551212",
  "status": "RINGING",
  "elevenlabsConvId": "conv_abc...",
  "createdAt": "2026-04-29T10:32:11.000Z"
}
JavaScript / Node.js
// Trigger a call from any Node.js / browser app
const r = await fetch('https://outboundcalls.ai/api/v1/calls', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.OC_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    agentId: 'clxAGENT123',
    toNumber: '+14155551212',
  }),
});
const call = await r.json();
console.log(call.id, call.status); // RINGING

// Later — fetch transcript & summary
const detail = await fetch(`https://outboundcalls.ai/api/v1/calls/${call.id}`, {
  headers: { Authorization: `Bearer ${process.env.OC_API_KEY}` },
}).then(r => r.json());
console.log(detail.summary, detail.transcript);

Post-call webhook

Configure uma URL de webhook em cada agente. Após cada chamada, OutboundCalls POSTa um payload JSON assinado para seu endpoint com:

  • Full transcript
  • Recording URL
  • AI-generated summary
  • Sentiment score
  • Goal achieved (true/false)
  • Extracted data fields
  • Duration + credits charged
  • Voicemail flag

Todos os payloads são assinados com HMAC-SHA256. Verifique o cabeçalho contra o segredo do webhook do seu agente.

Envie em minutos, não em semanas

Crie uma conta, gere uma chave de API e inicie sua primeira chamada em menos de 5 minutos.