Referenční dokumentace API
Live — v1 available now

REST API

Spouštějte hlasové hovory s AI, synchronizujte kontakty a čtěte výsledky hovorů z libovolného backendu, CRM nebo no-code nástroje.

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

Authentication

Generate an API key from Dashboard → Settings → API Keys. Předávejte jej jako Bearer token v každém požadavku.

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Klíče jsou v úložišti hashované a zobrazují seonly oncepři vytvoření. Kdykoli je můžete rotovat nebo zneplatnit na stejné stránce Nastavení.

Co můžete připojit

API je jednoduché REST API s Bearer tokenem, takže funguje se vším, co komunikuje přes HTTPS — bez nutnosti SDK.

Zapier

Webhooky + HTTP

Spouštějte hovory, když je do vašeho CRM, tabulky nebo formuláře přidán nový lead.

Make (Integromat)

HTTP modul

Vytvářejte vizuální pracovní postupy: formulář → OutboundCalls → aktualizace ve Slacku / e-mailu / CRM.

n8n

Uzel HTTP Request

Automatizace provozovaná ve vlastní infrastruktuře. Připojte svou databázi, plánovač nebo komunikační stack.

HubSpot / Salesforce / Pipedrive

CRM

Automaticky přidávejte nové kontakty do kampaně a stahujte shrnutí hovorů zpět jako záznamy aktivit.

Vlastní backend (Node, Python, PHP, Go, Ruby)

Libovolný jazyk

Standardní REST + Bearer token. Funguje se vším, co umí odeslat HTTPS požadavek.

No-code platformy (Bubble, Retool, Airtable Automations)

No-code

Zapojte endpoint do akce pracovního postupu — bez nutnosti SDK.

Reálné pracovní postupy, které můžete vytvořit

Nový lead vyplní váš formulář Typeform → zavolejte mu do 30 sekund
Booking confirmation in Calendly → AI agent calls 24h before to confirm
Failed Stripe payment → reminder call instead of just an email
Denní nahrání CSV z vašeho CRM → AI agent zavolá každému kontaktu během pracovní doby
WhatsApp inbound message → callback from voice agent if requested
Průběh dlouhodobé kampaně se každých 15 min synchronizuje do vašeho datového skladu

Endpoints

Účet

GET/me

Agenti

GET/agents
GET/agents/:id

Kontakty

GET/contacts
POST/contacts

Hovory

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

Kampaně

GET/campaigns
GET/campaigns/:id

Další endpointy (vytváření/úprava/mazání agentů, import CSV, řízení kampaní) jsou v plánu. Potřebujete některý naléhavě?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

Nastavte URL webhooku u každého agenta. Po každém hovoru OutboundCalls odešle metodou POST podepsaný JSON payload na váš endpoint s těmito údaji:

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

Všechny payloady jsou podepsané pomocí HMAC-SHA256. Ověřte hlavičku vůči tajnému klíči webhooku vašeho agenta.

Nasazujte během minut, ne týdnů

Vytvořte si účet, vygenerujte API klíč a spusťte první hovor za méně než 5 minut.