Ce Sunt API & Webhooks?

API-ul Kallina oferă control programatic complet asupra platformei: creează agenți, inițiază apeluri, accesează analytics și gestionează toate resursele prin endpoint-uri REST documentate complet. Arhitectură developer-friendly cu rate limiting generos și response times sub 100ms.

Webhooks-urile trimit notificări real-time către sistemele tale la orice eveniment: apel început/terminat, lead generat, programare creată sau sentiment negativ detectat. Integrare bidirectională completă pentru workflow-uri complexe.

✓REST API - endpoint-uri intuitive și predictibile
✓Real-time webhooks - notificări instant la orice event
✓OpenAPI spec - documentație completă cu examples
✓SDKs oficiale - Node.js, Python, PHP, Go
✓Rate limiting generos - 10,000 requests/min

⚡

Developer API Platform

REST + Webhooks + SDKs

Capabilități API

📞

Call Management

Inițiază, monitorizează și controlează apeluri programatic. Start calls, transfer, end, și accesează status real-time pentru orice conversație.

• POST /calls - initiate call
• GET /calls/:id - status
• PATCH /calls/:id - update
• DELETE /calls/:id - terminate

🤖

Agent Management

Creează, configurează și deploy agenți AI complet prin API. Actualizează prompts, knowledge base și setări în timp real fără interfață.

• POST /agents - create
• GET /agents - list all
• PATCH /agents/:id - update
• POST /agents/:id/deploy

📊

Analytics & Data

Accesează toate datele de analytics: call metrics, transcripts, sentiment scores, lead data și custom events pentru analiză profundă.

• GET /analytics/calls
• GET /transcripts/:id
• GET /leads - export leads
• GET /metrics - KPIs

👥

Contact Management

Gestionează contacte programatic: import bulk, update detalii, segmentare și tag-ging pentru targeting precis în campanii.

• POST /contacts - create
• POST /contacts/bulk - import
• PATCH /contacts/:id
• GET /contacts - filter & search

📅

Scheduling & Calendar

Sincronizare bidirectională cu calendare: creează appointments, check availability, update și cancel programări prin API.

• GET /calendar/slots - available
• POST /appointments - book
• PATCH /appointments/:id
• DELETE /appointments/:id

🔧

Configuration & Settings

Configurare completă a platformei prin API: voice settings, prompts, workflows, integrations și orice parametru disponibil în UI.

• GET /settings - current config
• PATCH /settings - update
• POST /workflows - create
• GET /integrations - list

Webhook Events

Primește notificări real-time la endpoint-ul tău pentru orice eveniment important. Payload JSON complet cu toate detaliile relevante.

📞 Call Events

Notificări pentru lifecycle complet apel: started, ringing, answered, completed, failed. Include duration, transcript și outcome.

• call.started
• call.answered
• call.completed
• call.failed
• call.transferred

🎯 Lead Events

Webhook instant când lead nou este generat, calificat sau convertit. Include scoring, date contact și next actions recomandate.

• lead.created
• lead.qualified
• lead.converted
• lead.updated
• lead.score_changed

📅 Appointment Events

Updates real-time pentru programări: booked, confirmed, rescheduled, cancelled sau no-show. Sincronizare perfect cu CRM-ul tău.

• appointment.booked
• appointment.confirmed
• appointment.rescheduled
• appointment.cancelled
• appointment.no_show

😊 Sentiment Events

Alert instant când sentiment negativ este detectat în conversație. Permite intervenție rapidă pentru salvare relație cu clientul.

• sentiment.negative
• sentiment.positive
• sentiment.changed
• escalation.needed
• customer.frustrated

Exemplu Cod - Inițiere Apel

Node.js / JavaScript

const kallina = require('@kallina/sdk');

const client = new kallina.Client({
  apiKey: process.env.KALLINA_API_KEY
});

// Inițiază apel
const call = await client.calls.create({
  phone_number: '+373 69 123 456',
  agent_id: 'agent_abc123',
  variables: {
    customer_name: 'Ion Popescu',
    product: 'Premium Plan'
  }
});

console.log(`Call started: ${call.id}`);

// Monitor status
const status = await client.calls.get(call.id);
console.log(`Status: ${status.state}`);

Webhook Handler - Express.js

app.post('/webhooks/kallina', (req, res) => {
  const event = req.body;

  switch(event.type) {
    case 'call.completed':
      // Process completed call
      await procesCallData(event.data);
      await syncToCRM(event.data);
      break;

    case 'lead.created':
      // New lead notification
      await notifySalesTeam(event.data);
      break;

    case 'sentiment.negative':
      // Alert pentru sentiment negativ
      await alertManager(event.data);
      break;
  }

  res.json({ received: true });
});

SDKs Oficiale

📗

Node.js

@kallina/sdk

npm install @kallina/sdk

🐍

Python

kallina-sdk

pip install kallina-sdk

🐘

PHP

kallina/kallina-php

composer require kallina

🔵

Go

kallina-go

go get kallina.ai/sdk

Beneficii pentru Dezvoltatori

🚀

Quick Integration

SDKs oficiale și documentație completă pentru setup rapid. De la zero la primul apel în sub 10 minute cu code examples pentru fiecare use case.

⚡

High Performance

Response times sub 100ms, rate limiting generos la 10,000 req/min și 99.9% uptime SLA. Scalare automată pentru orice volum de trafic.

🔒

Enterprise Security

API keys cu scopes granulare, OAuth 2.0 support, webhook signature verification și audit logs complete pentru tracking.

📚

Complete Documentation

OpenAPI 3.0 spec, interactive API explorer, code examples în toate limbile și detailed guides pentru fiecare feature.

🔄

Versioning & Backwards Compatibility

API versioning semantic cu backward compatibility garantat. Upgrade smooth fără breaking changes și deprecation notices clare.

💬

Developer Support

Discord community dedicat, technical support prioritar și direct access la engineering team pentru probleme complexe.

Cazuri de Utilizare

🔗 CRM Integration

"Am integrat Kallina direct în Salesforce. Fiecare apel sincronizat automat, lead-uri create în CRM și activities loggate. Zero manual data entry - totul prin API și webhooks."

Integration: Salesforce CRM

⚙️ Custom Workflow Automation

"Folosim API-ul pentru triggering automat apeluri când lead nou intră în sistem. Webhook la call.completed actualizează status și triggering next step în workflow. Totul automat."

Use Case: Marketing Automation

📊 Custom Analytics Dashboard

"Am construit dashboard custom care pull-uiește date din Kallina API în timp real. Metrics specifice business-ului nostru combinate cu date din alte sisteme pentru insights complete."

Tool: Custom BI Dashboard

Specificații Tehnice

<100ms

Avg response time

10,000

Requests per minute

99.9%

Uptime SLA

Începe să Construiești cu Kallina API

Documentație completă, SDKs oficiale și support dedicat. Primul API call în mai puțin de 10 minute.

Get API Keys View Documentation

Funcționalități Complementare

⚙️

API & Webhooks