API להקלטות שיחות
כל שיחה שהוקלטה יושבת אצלנו מוכנה. בקשה אחת עם מזהי השיחות, ובחזרה מגיע קישור מוכן להשמעה - להטמיע בכרטיס הלקוח, לצרף לתיק, או לשמור עותק אצלכם.
curl -X POST https://api.exm.co.il/v1/calls/get-recording-urls/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": ["n5c8qVe2b", "hsOKAEwj3Qp"],
"config": { "ttl": 5 }
}'לאן ההקלטה מגיעה
לכרטיס הלקוח ב-CRM
בסוף כל שיחה המערכת מושכת את ההקלטה לפי מזהה השיחה ומצמידה אותה לכרטיס הלקוח. מי שפותח את הכרטיס שומע את השיחה במקום, בלי לעבור אלינו.
לתיק פנייה בתמיכה
נפתחה פנייה או מחלוקת על מה שסוכם? מערכת התמיכה מושכת את ההקלטה של אותה שיחה לפי המזהה ומצרפת אותה לתיק, והנציג שומע בדיוק מה נאמר.
לסנכרון לילי לכלי ניתוח
משימה מתוזמנת מושכת מדי לילה את כל שיחות היום לכלי בקרת האיכות או ניתוח השיחות שלכם - אצווה שלמה בבקשה אחת, בלי להוריד קבצים ביד.
לארכיון שבשליטתכם
תהליך אוטומטי מעתיק כל הקלטה חדשה אל האחסון שלכם, לפי מדיניות התיעוד שלכם - הגיבוי והשמירה במקום אחד ובידיים שלכם.
שלוש דרכים למשוך הקלטה
אותה הקלטה, שלוש דרכים להגיע אליה. בוחרים את זו שמתאימה.
-
לתיעוד המתודה
קישורים לכמה שיחות למפתחים
שולחים רשימת מזהי שיחות ומקבלים בחזרה קישור מוכן להשמעה לכל אחת. הדרך לסנכרן הקלטות אל המערכת שלכם באצווה.
-
לתיעוד המתודה
הורדת קובץ בודד הכי פשוט
מזהה שיחה אחד בכתובת, והקובץ יורד ישר - בלי גוף בקשה. מתאים כשצריך את ההקלטה של שיחה מסוימת ולא של רשימה.
-
איך זה עובד
אוטומטית בכל שיחה Webhook
מחברים אוטומציה, ובכל פעם ששיחה מסתיימת הקישור להקלטה מגיע אליכם לבד ל-webhook - בלי לבקש כלום.
הבקשה והתשובה
שדות הבקשה
| שדה | מה מכניסים |
|---|---|
ids |
רשימת מזהי השיחות שאתם רוצים את ההקלטות שלהן. המזהים כבר אצלכם - מה-webhook של סוף השיחה או מתשובת API השיחות. |
config.ttl |
כמה זמן הקישור בתוקף, בדקות: מספר יוצר קישור זמני (עד 10 דקות), 0 יוצר קישור ציבורי קבוע שאפשר להטמיע. |
התשובה
{
"success": true,
"urls": [
{
"id": "n5c8qVe2b",
"code": 0,
"url": "https://recs.exm.co.il/prv/n5c8qVe2b.mp3?...",
"ttl": 5
},
{
"id": "hsOKAEwj3Qp",
"code": 404
}
]
}וכשמשהו משתבש
{
"success": false,
"error": {
"code": 400,
"message": "Invalid ttl in config"
}
}הקלטה בסוף שיחה
הדרך הנפוצה ביותר לא מבקשת הקלטה בכלל: מגדירים באוטומציה שהקישור יצורף לאירוע, וכששיחה מסתיימת ה-webhook מגיע לשרת שלכם כשהקישור כבר בפנים.
מגדירים את האוטומציה באיזור האישי, בהגדרות של כל קו בנפרד - מספר וירטואלי, נתב שיחות, קו סלולר או סופטפון.
{
"event": "call.ended",
"call_id": "n5c8qVe2b",
"recording": {
"url": "https://recs.exm.co.il/prv/n5c8qVe2b.mp3?...",
"ttl": 5
}
}מה צריך כדי להתחיל
-
הקלטת שיחות פעילה
כדי שיהיה מה למשוך, הקלטת השיחות צריכה להיות פעילה בקו. רק שיחות שהוקלטו מחזירות קובץ - שיחה בלי הקלטה חוזרת ריקה.
-
מפתח API
מפיקים אותו לבד באיזור האישי, בעמוד מפתחות ה-API. מפתח רגיל מגיע להקלטות של החשבון שלכם - בלי הרשאה מיוחדת.
-
מזהי השיחות
מזהה השיחה כבר מגיע אליכם - ב-webhook שנשלח בסוף כל שיחה, ובתשובת API השיחות. משם הוא נכנס ישר לבקשת ההקלטה, בלי להעתיק כלום ביד.
שאלות על API להקלטות
-
מאיפה מגיע מזהה השיחה כדי לבקש הקלטה?
הוא כבר אצלכם: ב-webhook שנשלח בסוף כל שיחה, ובתשובת API השיחות. משם הוא נכנס ישר לבקשת ההקלטה - לא מעתיקים אותו ביד.
-
אפשר למשוך הקלטות של כמה שיחות בבת אחת?
כן. שולחים רשימת מזהי שיחות בבקשה אחת, ובחזרה מגיע קישור נפרד לכל שיחה. אין צורך לבקש אחת-אחת.
-
מה קורה אם לשיחה מסוימת אין הקלטה?
היא חוזרת באותה רשימה עם code של 404, ושאר השיחות שכן הוקלטו חוזרות עם הקישור שלהן. רק שיחה שהוקלטה בפועל מחזירה קובץ.
-
כמה זמן הקישור להקלטה בתוקף?
אתם קובעים: מספר דקות יוצר קישור זמני (עד 10 דקות), והערך 0 יוצר קישור ציבורי קבוע שאפשר להטמיע בכרטיס לקוח או במערכת.
-
צריך הרשאה מיוחדת למפתח כדי למשוך הקלטות?
לא. מפתח API רגיל שמפיקים באיזור האישי מגיע להקלטות של החשבון שלכם, בלי לסמן הרשאה נפרדת.
-
איך מפעילים הקלטת שיחות מלכתחילה?
זה תלוי בשירות: בקווי הסלולר ההקלטה תמיד פעילה. במספר וירטואלי ובנתב שיחות מגדירים אותה - הפעלה או כיבוי - בעמוד ההגדרות של המספר. רק שיחות שהוקלטו זמינות למשיכה דרך ה-API.
-
אפשר לקבל את ההקלטה אוטומטית בלי לתשאל בכל פעם?
כן. מחברים אוטומציה, ובסוף כל שיחה הקישור להקלטה נשלח אליכם לבד ל-webhook - בלי לבקש כלום.
-
אפשר למשוך גם הקלטות של שיחות ישנות?
כן, כל עוד הקלטת השיחות הייתה פעילה באותה תקופה. ההקלטות נשמרות בחשבון וזמינות למשיכה לפי מזהה השיחה.
מוכנים למשוך את ההקלטות?
מפעילים הקלטת שיחות, מפיקים מפתח באיזור האישי, ומושכים כל הקלטה בבקשה אחת.
המפתח מחכה לכם באיזור האישי - ההקלטות במרחק בקשה אחת.
להפעלת הקלטת שיחות למפתחות ה-API שלי לתיעוד המתודה
כבר מקליטים שיחות? המפתח מחכה באיזור האישי.
