למפתחים

הכול שאפשר לעשות בממשק — אפשר לעשות גם מהקוד

API ציבורי עם אימות במפתח, webhooks חתומים על סיום שיחה, כתיבה חזרה ל-CRM, ושרת MCP שמאפשר לבנות את סביבת העבודה מתוך Claude או ChatGPT.

בקצרה

יש API לסוכן הטלפוני?

כן. יש REST API ציבורי עם אימות במפתח שנשלח בכותרת Authorization, והוא מאפשר להכניס שיחה יוצאת לתור, לקרוא שיחות ותמלולים, ולנהל סוכנים, תסריטי שיחה ומאגר ידע. בסיום כל שיחה נשלח webhook חתום ב-HMAC לכתובת שהגדרתם, כדי שלא תצטרכו לדגום את המערכת בלולאה. אם אתם עובדים מול Salesforce או HubSpot, המערכת יכולה לכתוב את השיחה חזרה כפעילות מקושרת לליד או לאיש הקשר. לכל אלה יש גם שרת MCP מרוחק, שמאפשר ללקוח LLM לבנות ולתפעל את סביבת העבודה בלי לכתוב קוד בכלל. התיעוד המלא, כולל כל שדה בכל מסלול, חי בממשק ה-OpenAPI המקושר מהעמוד הזה.

התיעוד החי

התיעוד נוצר מהקוד עצמו, ולכן הוא תמיד תואם למה שרץ בפועל. שם מסלול, שדה או קוד שגיאה שמופיע שם — זה מה שהשרת מחזיר.

לתיעוד ה-API

https://server.daber.ai/v1/docs

ה-API הציבורי

אימות במפתח לכל בקשה, פורמט snake_case בחוט, והרשאות ברמת המסלול — לכל מפתח יש קבוצת הרשאות מוגדרת, ומפתח שלא הוקצתה לו ההרשאה פשוט לא רואה את המסלול. מפתח מוצג פעם אחת בלבד בזמן היצירה; בצד שלנו נשמר רק גיבוב שלו.

הכנסת שיחה יוצאת לתור, עם שיוך אופציונלי לקמפיין כדי שהתוצאה תתגלגל ל-KPI שלו
קריאה של שיחות: מטא-דאטה, תמלול, סיכום, סנטימנט וסיבת העברה לנציג
ניהול סוכנים ותסריטי שיחה, כולל יצירת עץ שיחה ממסמך תסריט קיים
כתיבה למאגר הידע — ערכים שנוצרים דרך ה-API נכנסים כטיוטה, ואישור בממשק הוא מה שמכניס אותם לשליפה
כל שינוי בהגדרות סוכן או תסריט מקבל גרסה משלו, גם כשהוא הגיע מה-API — ואפשר לחזור אחורה

להכניס שיחה יוצאת לתור

הבקשה המינימלית: מזהה הסוכן ומספר לחיוג. השיחה נכנסת לתור ומטופלת באותו נתיב חיוג שמפעיל את הקמפיינים, כך שאין מסלול שני שמתנהג אחרת.

curl -X POST https://server.daber.ai/v1/calls \
  -H "Authorization: Bearer dbr_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "3f9c1a52-7b41-4f0e-9c8d-2a5b6e7d8f10",
    "phone": "+972501234567"
  }'

התשובה מחזירה מזהה של בקשת השיחה. את התוצאה — נענתה, לא נענתה, מה נאמר ומה סוכם — תקבלו ב-webhook בסיום, ולא בתשובה לבקשה הזו.

Webhooks על סיום שיחה

במקום לדגום את ה-API עד שהשיחה נגמרת, אתם מגדירים כתובת ומקבלים אליה אירוע. כל בקשה נושאת חתימת HMAC-SHA256 מעל חותמת הזמן וגוף ההודעה — אימות החתימה בצד שלכם הוא ההבדל בין נקודת קצה לבין נקודת קצה שכל אחד יכול להזין.

אירועים על מחזור החיים של שיחה שהוזמנה דרך ה-API: נכנסה לתור, הסתיימה, נכשלה
אירוע על סיום שיחה — לכל שיחה קולית שהסתיימה, לא רק לשיחות שהוזמנו דרך ה-API
החתימה נשלחת בכותרת ייעודית וכוללת חותמת זמן, כדי שתוכלו לדחות שידור חוזר ישן
הסוד ניתן לחשיפה ולהחלפה מתוך ההגדרות, ויומן המסירה שומר את הניסיונות האחרונים לכל נקודת קצה

מה שהשיחה מזינה החוצה

שיחה שהסתיימה היא רשומה בשתי מערכות לפחות — שלנו ושלכם. שתי הדרכים לסגור את הפער הזה בלי לכתוב סנכרון ידני.

כתיבה חזרה ל-CRM

אם השיחה לא מופיעה ב-CRM, מבחינת איש המכירות היא לא קרתה. בסיום שיחה המערכת יכולה ליצור פעילות סגורה ב-Salesforce או ב-HubSpot, מקושרת לליד או לאיש הקשר הנכון ומשויכת לבעלים שלו, עם הסיכום והתוצאה. כישלון בכתיבה ל-CRM לעולם לא מפיל את השיחה עצמה — הוא נרשם ומדווח, והשיחה נשארת שלמה אצלנו.

שרת MCP מרוחק

אותו API, חשוף כשרת MCP — כך שאפשר לחבר את סביבת העבודה ללקוח LLM כמו Claude או ChatGPT ולבנות אותה בשיחה: להפוך מסמך תסריט לעץ שיחה, ליצור סוכן, לקשר אליו את התסריט והמודלים, להוסיף ערכים למאגר הידע ולהתחיל שיחת בדיקה. האימות הוא אותו מפתח API, והכלים שנחשפים ללקוח הם רק אלה שההרשאות של אותו מפתח מתירות — לקוח LLM לא מקבל יותר ממה שהמפתח שבידיו מקבל.

מה שכדאי לדעת לפני שמעלים לייצור

מפתח חי הוא סוד לכל דבר: הוא מוצג פעם אחת, ולעולם לא נשלח מדפדפן
יש הגבלת קצב לכל מפתח, וזיהוי של הצפת חיוגים עלול להשעות מפתח אוטומטית — ההשעיה הפיכה מתוך ההגדרות
אימות החתימה של ה-webhook בצד שלכם הוא חובה, לא רשות
הסיכום והסנטימנט נכתבים אחרי סיום השיחה ולא באותו רגע — לכן הם מגיעים ב-webhook ולא בתשובה לבקשת החיוג

התקשרו לסוכן עכשיו

שיחה אמיתית, בעברית. זה בדיוק מה שהלקוחות שלכם ישמעו.

שהסוכן יחזור אליי

השאירו מספר — הסוכן מתקשר תוך פחות מדקה.