שיחות יוצאות
מתקשרים כשזה עוד משנה. ישר מהמערכות שלכם.
האפליקציה או האוטומציה שלכם מוציאה שיחה דרך ה-Voice API בבקשה אחת: למי להתקשר, מה היעד, אילו עובדות הסוכן רשאי להשתמש בהן ולפי איזה תסריט לפעול. הסוכן מנהל את השיחה מהמספר שלו, והתוצאה והתמלול חוזרים אליכם כשהשיחה מסתיימת.
שיחה מגיעה לאנשים. כשהודעה לא מגיעה.
שיחה קולית מתאימה לרגעים דחופים, חשובים או עדינים מדי בשביל עוד הודעה אוטומטית: מיד אחרי שטופס נשלח, כשמישהו לא הגיע לתור, כשמשלוח נתקע. המערכת שלכם מחליטה מתי שווה להתקשר.
הסוכן נכנס לשיחה מעודכן. הוא יודע למה הוא מתקשר, למי ואילו עובדות כבר מאומתות, כך שהוא לא שואל את האדם על דברים שכבר ידועים לכם.
שיחה לדוגמה, עם נתונים לדוגמה
בקשה אחת. והסוכן מנהל את כל השיחה.
ה-API מחזיר מזהה שיחה מיד, כך שתהליך העבודה שלכם לא נתקע בזמן שהסוכן מדבר.
- 1
המערכת שלכם יוזמת
בקשת
POST /v1/voice/callsאחת עם המספר של הסוכן, המספר שאליו מתקשרים, מי הפעיל את השיחה, ומטרה בשורה אחת או משימה מובנית. - 2
הסוכן מקבל תדריך
המשימה כוללת את היעד, עד 30 עובדות, שם התסריט שהסוכן פועל לפיו וכלל הסלמה אופציונלי.
- 3
שיחה גמישה
הסוכן עונה על שאלות, מאמת פרטים, משתמש בכלים שאישרתם ומסיים בנימוס לפני שהשיחה מגיעה למגבלת האורך.
- 4
התוצאה חוזרת
שולפים את השיחה לפי המזהה, או מקבלים אותה ב-webhook חתום: סטטוס, משך, תמלול, תוצאה והמשימה ששלחתם.
התדריך, כפי שהמערכת שלכם שולחת אותו.
העובדות הן רשימה שטוחה של ערכים שהשרת שלכם בונה מהנתונים שלכם. הסוכן יודע שאלה העובדות המאומתות היחידות. בנו אותן בשרת שלכם, ולעולם אל תעבירו טקסט של מתקשר או משתמש כמו שהוא.
התיעוד המלא של הבקשהPOST https://api.talktomyagent.io/v1/voice/calls
{
"from": "+16475550100",
"to": "+16475550134",
"triggeredBy": "reminder-scheduler",
"targetName": "Maria",
"task": {
"goal": "Confirm Maria's Thursday 10:30 cleaning, or note a preferred new time.",
"script": "appointment_confirmation",
"facts": {
"patient_name": "Maria",
"appointment_date": "Thursday, November 12",
"appointment_time": "10:30 AM"
},
"escalation": "If she has a clinical question, tell her the office will call back and end the call."
}
}בשליטה שלכם. בכל שלב.
התוכנה שלכם מחליטה מי מקבל שיחה, מתי, ומה הסוכן רשאי לעשות. המערכת אוכפת את המגבלות מסביב.
- מפתחות API עם הרשאות מוגדרותהרשאה נפרדת להוצאת שיחות ולקריאתן, ואפשר להגביל מפתח לסוכן אחד. שמרו את המפתחות בשרת שלכם. אפשר להחליף או לבטל מפתח בלי לגעת בסוכן.
- ניסיון חוזר בטוחכל בקשה כוללת מפתח ייחודי לבקשה (idempotency key). ניסיון חוזר עם אותו מפתח בתוך 24 שעות מחזיר את התשובה הראשונה, ולא מוציא שיחה שנייה.
- המספר שלכםהשיחות יוצאות מאחד המספרים הפעילים של הסוכן שלכם.
- מגבלות קצבלכל סוכן: 5 שיחות בשעה לאותו מספר, 30 שיחות בשעה ו-100 ביום.
- מדינות מורשותהפעלת מספר מאשרת את המדינה של אותו מספר וגם את ארצות הברית. מדינות נתמכות נוספות אפשר להוסיף בהגדרות השיחות היוצאות של הסוכן. מספרי פרימיום נחסמים תמיד.
- קיבולת מתוכננתשתי שיחות במקביל לכל סוכן כברירת מחדל, נכנסות ויוצאות יחד, ואפשר להגדיל לפי בקשה.
- תיעוד מלאכל שיחה שיצאה נרשמת, יחד עם מי שהפעיל אותה והמשימה שנשלחה איתה.
השיחות ששווה להתחיל מהן.
כל מדריך מראה מה תסריט טוב לשיחה כזו צריך לכסות.
שאלות.
השרת שלנו יכול להתחיל שיחה?
כן. ה-backend שלכם, או כלי אוטומציה כמו n8n, שולח בקשה מאומתת ל-Voice API ומקבל מיד את מזהה השיחה.
מה אפשר לספר לסוכן על השיחה?
יעד, עד 30 עובדות, התסריט שלפיו לפעול, כלל הסלמה, השם של האדם שאליו מתקשרים, ואם רוצים, גם משפט הפתיחה המדויק. כדאי שהתדריך יהיה ספציפי: איך נראית הצלחה, מה ידוע, ואיפה הסוכן צריך לעצור.
איך מקבלים את התוצאה?
שולפים את השיחה לפי המזהה, או רושמים webhook חתום של call.ended. הרשומה כוללת סטטוס, משך, איך השיחה הסתיימה, את התמלול כששליחת התמלולים מופעלת, האם יש הקלטה זמינה, את המשימה, ואת התוצאה אחרי שהשיחה נבדקה.
מה קורה אם שולחים יותר שיחות ממספר הקווים של הסוכן?
מגבלת השיחות במקביל נבדקת על ידי הסוכן כשהחיוג מתחיל, לא על ידי ה-API: ה-API עדיין מחזיר מזהה שיחה, ושיחה שיוצאת כשכל הקווים תפוסים מנותקת מיד עם תחילת החיוג, לפני שהיא מגיעה לאדם. אל תשלחו בבת אחת יותר שיחות ממספר הקווים של הסוכן.
ה-API בודק רשימות "אל תתקשרו" או שעות מותרות לשיחות?
לא. המערכת שלכם מחליטה למי להתקשר ומתי. כללי ההתקשרות תלויים במיקום שלכם ובמיקום של האדם שאליו אתם מתקשרים. בארצות הברית, למשל, קולות שנוצרו ב-AI נחשבים קולות מלאכותיים לפי ה-TCPA. בדקו מול היועץ המשפטי שלכם. במקומות שבהם החוק מחייב הודעה על הקלטה, הפרויקט שלכם יכול להשמיע הודעה מאושרת בתחילת כל שיחה יוצאת, או שאפשר לשלב אותה במשפט הפתיחה.
איזו שיחה הסוכן שלכם יקבל קודם?
ספרו לנו אילו בקשות הצוות שלכם מקבל שוב ושוב. נציע לכם מאיפה כדאי להתחיל.