REST API

Full Control

Real-time

Webhook Events

Unlimited

Custom Integrations

Cum Funcționează Webhooks

📤

Outbound Webhooks

Kallina trimite evenimente în timp real către serverul tău:

• call.started
• call.completed
• call.failed
• meeting.scheduled
• transcription.ready

📥

Inbound API

Tu controlezi Kallina prin REST API:

• POST /calls - Trigger new call
• GET /calls/:id - Call status
• POST /contacts - Add contact
• GET /transcriptions - Get data

Webhook Event Example

POST https://your-app.com/webhooks/kallina
Content-Type: application/json

{
  "event": "call.completed",
  "timestamp": "2024-03-15T14:30:00Z",
  "call_id": "call_1a2b3c4d",
  "contact": {
    "phone": "+40721234567",
    "name": "Ion Popescu",
    "email": "ion@example.com"
  },
  "outcome": "interested",
  "duration": 180,
  "transcription": "Bună ziua, sunt Ion...",
  "summary": "Client interesat de produsul X, buget 5000 EUR",
  "next_action": "schedule_demo",
  "metadata": {
    "campaign_id": "summer_2024",
    "lead_score": 85
  }
}

REST API Examples

1. Trigger New Call

curl -X POST https://api.kallina.ai/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+40721234567",
    "campaign_id": "lead_followup",
    "metadata": {
      "lead_id": "12345",
      "source": "facebook_ads"
    }
  }'

2. Get Call Status

curl -X GET https://api.kallina.ai/v1/calls/call_1a2b3c4d \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:
{
  "id": "call_1a2b3c4d",
  "status": "completed",
  "outcome": "interested",
  "duration": 180,
  "recording_url": "https://...",
  "transcription_url": "https://..."
}

3. Bulk Call Creation

curl -X POST https://api.kallina.ai/v1/campaigns/bulk_call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      {"phone": "+40721111111", "name": "Client 1"},
      {"phone": "+40722222222", "name": "Client 2"}
    ],
    "campaign_id": "spring_promo",
    "schedule": "immediate"
  }'

Webhook Events Available

call.started

Kallina a inceput apelul

call.completed

Apelul s-a terminat cu succes

call.failed

Apelul a eșuat (nu răspunde, număr invalid)

meeting.scheduled

O întâlnire a fost programată

transcription.ready

Transcrierea este disponibilă

contact.updated

Un contact a fost actualizat

Security & Authentication

🔑 API Key Authentication

Fiecare request necesită API key în header:

Authorization: Bearer sk_live_...

🔐 Webhook Signature Verification

Fiecare webhook conține signature pentru validare:

X-Kallina-Signature: sha256=...

🌐 IP Whitelisting

Opțional: Restricționează webhook-urile doar de la IP-uri specifice

Use Cases

🏗️ Custom CRM Integration

Ai un CRM custom? Folosește webhooks să salvezi automat toate conversațiile în database-ul tău.

📊 Custom Analytics

Trimite datele în propriul tău analytics system (Mixpanel, Amplitude, custom DB).

🔄 Multi-System Sync

Sincronizează Kallina cu multiple sisteme simultan (CRM + Accounting + Support).

🤖 Custom AI Workflows

Folosește transcription API pentru a alimenta propriile modele AI cu date conversaționale.

Rate Limits

Plan	Requests/min	Burst
Free	10	20
Standard	60	120
Professional	300	600
Enterprise	Custom	Custom

SDKs & Libraries

Node.js / JavaScript

npm install @kallina/sdk

Python

pip install kallina

PHP

composer require kallina/sdk

Începe cu API & Webhooks

Documentație completă pentru developers

API Documentation Webhooks Guide

Webhooks & API