Tài liệu API
Live — v1 available now

REST API

Kích hoạt cuộc gọi thoại AI, đồng bộ liên hệ và đọc kết quả cuộc gọi từ bất kỳ backend, CRM hoặc công cụ no-code nào.

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

Authentication

Generate an API key from Dashboard → Settings → API Keys. Gửi khóa dưới dạng token Bearer trong mọi yêu cầu.

Authorization: Bearer oc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Khóa được băm khi lưu trữ và chỉ hiển thịonly oncekhi tạo. Có thể xoay vòng hoặc thu hồi bất cứ lúc nào từ cùng trang Cài đặt.

Những gì bạn có thể kết nối

API sử dụng REST + token Bearer đơn thuần, nên hoạt động với mọi hệ thống hỗ trợ HTTPS — không cần SDK.

Zapier

Webhook + HTTP

Kích hoạt cuộc gọi khi lead mới được thêm vào CRM, bảng tính hoặc biểu mẫu của bạn.

Make (Integromat)

Mô-đun HTTP

Xây dựng quy trình trực quan: Biểu mẫu → OutboundCalls → cập nhật Slack/Email/CRM.

n8n

Nút HTTP Request

Tự lưu trữ quy trình tự động hóa. Kết nối cơ sở dữ liệu, bộ lập lịch hoặc hệ thống nhắn tin của bạn.

HubSpot / Salesforce / Pipedrive

CRM

Tự động đưa liên hệ mới vào chiến dịch; đồng bộ tóm tắt cuộc gọi về dưới dạng bản ghi hoạt động.

Backend tùy chỉnh (Node, Python, PHP, Go, Ruby)

Bất kỳ ngôn ngữ nào

REST tiêu chuẩn + token Bearer. Hoạt động với bất kỳ hệ thống nào có thể gửi yêu cầu HTTPS.

Nền tảng no-code (Bubble, Retool, Airtable Automations)

No-code

Kết nối endpoint vào một hành động trong quy trình — không cần SDK.

Các quy trình thực tế bạn có thể xây dựng

Một lead mới điền biểu mẫu Typeform → gọi cho họ trong vòng 30 giây
Booking confirmation in Calendly → AI agent calls 24h before to confirm
Failed Stripe payment → reminder call instead of just an email
Tệp CSV hằng ngày từ CRM của bạn → tác nhân AI gọi từng liên hệ trong giờ làm việc
WhatsApp inbound message → callback from voice agent if requested
Tiến độ chiến dịch dài hạn được đồng bộ vào kho dữ liệu của bạn mỗi 15 phút

Endpoints

Tài khoản

GET/me

Tác nhân AI

GET/agents
GET/agents/:id

Liên hệ

GET/contacts
POST/contacts

Cuộc gọi

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

Chiến dịch

GET/campaigns
GET/campaigns/:id

Các endpoint khác (tạo/cập nhật/xóa tác nhân AI, nhập CSV, điều khiển chiến dịch) đang nằm trong lộ trình. Bạn cần gấp endpoint nào?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

Cấu hình URL webhook cho từng tác nhân AI. Sau mỗi cuộc gọi, OutboundCalls.ai sẽ gửi payload JSON đã ký đến endpoint của bạn bằng phương thức POST, bao gồm:

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

Tất cả payload đều được ký bằng HMAC-SHA256. Hãy xác minh header bằng mã bí mật webhook của tác nhân AI.

Triển khai trong vài phút, không phải vài tuần

Tạo tài khoản, tạo khóa API và kích hoạt cuộc gọi đầu tiên trong chưa đầy 5 phút.