🔑 אימות
כל הקריאות ל-API דורשות מפתח. שלח אותו בheader:
x-api-key: cl_live_YOUR_API_KEY
או כ-Bearer token:
Authorization: Bearer cl_live_YOUR_API_KEY
שיחות (Calls)
סוכנים (Agents)
בסיס ידע (Knowledge Base)
קמפיינים (Campaigns)
Webhooks (Webhooks)
אירועים ויתרה (Events & Balance)
⚡ אירועי Webhook
כשיוצרים webhook, אפשר לבחור אילו אירועים לקבל. הנה כל הסוגים הזמינים:
call.completedשיחה הסתיימה — כולל תמלול, הקלטה, סיכוםcall.startedשיחה התחילהcall.failedשיחה נכשלהcampaign.startedקמפיין התחיל לחייגcampaign.completedקמפיין סיים את כל המספריםcampaign.pausedקמפיין הושההagent.createdסוכן חדש נוצרagent.updatedסוכן עודכן/פורסםcredits.purchasedקרדיטים נרכשוcredits.lowקרדיטים נמוכיםדוגמת payload — call.completed
{
"event": "call.completed",
"timestamp": "2026-04-15T14:30:00Z",
"data": {
"id": "uuid",
"agent_id": "uuid",
"agent_name": "Sales Agent",
"phone_number": "+972501234567",
"direction": "inbound",
"started_at": "2026-04-15T14:25:00Z",
"ended_at": "2026-04-15T14:30:00Z",
"duration_seconds": 300,
"status": "completed",
"summary": "הלקוח התעניין במסלול פרימיום...",
"recording_url": "https://theconversionslab.com/api/recordings/uuid",
"transcript": [
{ "role": "agent", "text": "שלום, כאן..." },
{ "role": "user", "text": "היי, אני מעוניין..." }
]
}
}🔐
אימות Webhook
כל webhook נשלח עם header מסוג X-Webhook-Signature — חתימת HMAC-SHA256 עם ה-signing secret שלך. השתמש בו כדי לוודא שהקריאה מגיעה מ-Conversion Lab.
⏱ הגבלת קריאות
ה-API מוגבל ל-60 קריאות לדקה. חריגה מחזירה 429 Too Many Requests עם header Retry-After.