כלים מובנים

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

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

end_call#

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

כתבו בהנחיה את התנאי ואת כל ברכת הפרידה הנדרשת:

When the caller confirms they need nothing else, say goodbye and end the call.

לשיחה שהסתיימה על ידי המודל יש end_reason: "ai_hangup", כולל שיחה שמסתיימת לאחר אזהרת מגבלת זמן השיחה. השיחה מסתיימת עם max_duration רק אם מגבלת הזמן מושגת קודם, ועם balance_exhausted כאשר היתרה מראש מתרוקנת.

transfer_call#

מעביר מתקשר טלפוני למספר קבוע שמספק המודל. העברה ללא תיווך מתבצעת מיידית. העברה חמה מסוננת מתקשרת באופן פרטי ליעד לפני חיבור הצדדים. העברה חמה דורשת מספר VoIP מיובא ומאומת שיכול לבצע שיחות יוצאות.

הציבו בהנחיה את מספר היעד ואת תנאי הניתוב המדויק:

If the caller asks for billing, transfer them to +15551234567.

בהעברה מוצלחת ללא תיווך הערך הוא end_reason: "ai_transfer"; בהעברה חמה שהושלמה הערך הוא end_reason: "ai_warm_transfer". ניסיון העברה חמה שנכשל מחזיר את השליטה לסוכן, ולכן סיום השיחה בהמשך קובע את סיבת הסיום שלה. בהפעלות שאינן טלפוניות, בקשת העברה מסיימת את ההפעלה במקום זאת.

עיינו ב-העברת שיחות להגדרה בלוח הבקרה וב-API, ניתוב, סינון, טיפול בכשלים, מגבלות ובדיקות.

send_keypad_input#

שולח ספרות DTMF (לוח מקשים טלפוני) 0–9, * ו-# לקו טלפון. המודל משתמש בו כדי לנווט ב-IVR, התפריט האוטומטי שמבקש מהמתקשרים ללחוץ על מקשים. הוא זמין כברירת מחדל ואין לו הגדרת סוכן.

ציינו למודל באילו תפריטים מותר לו לנווט ומאיפה מגיעים הערכים המבוקשים. אל תבקשו ממנו לנחש אפשרויות תפריט:

Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.

הפלטפורמה מסירה תווים שאינם נתמכים ושולחת ספרות תקפות לפי הסדר. אם לא נותרו ספרות תקפות או שהשיחה אינה יכולה לשלוח קלט מלוח המקשים, הכשל מוחזר לסוכן כדי שיוכל להתאושש.

no_response#

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

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

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

Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.

פעולה זו אינה מסיימת את השיחה.

wait_on_hold#

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

If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.

אל תנחו את הסוכן להשתמש בו עבור הודעת "אנא המתן" של IVR. ההמתנה נמשכת עד 15 דקות כברירת מחדל. עבור שיחות יוצאות רגילות, POST /v1/call מקבל את max_hold_seconds כמספר שלם חיובי; ‏Realtime מוטבע מגביל את max_hold_seconds ל-10–900 שניות. אם האדם חוזר, הסוכן ממשיך בלי לשנות את סיבת סיום השיחה. אם המגבלה פגה, הפלטפורמה מסיימת את השיחה עם end_reason: "ai_hangup".

search_knowledge_base#

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

Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.

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

play_sound#

מנגן את צליל ההתראה שהוגדר לסוכן לאחר כל דיבור באותו תור. בלוח הבקרה, הגדירו את מתקדם → צליל כלי כ-צלצול, דינג, או צפצוף, ולאחר מכן פרסמו את הסוכן. האפשרות ללא מסירה את הכלי.

עם Agents API, הגדירו את play_sound_asset כ- "chime", "ding", או "beep", ולאחר מכן פרסמו. הגדירו אותו כ-"" כדי להשבית את הכלי.

After confirming that an appointment was saved, say "You're all set" and play
the notification sound.

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

send_email#

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

בלוח הבקרה, הפעילו את מתקדם → שליחת אימייל, שמרו כתובת נמען, ולאחר מכן פרסמו את הסוכן. עם Agents API, הגדירו גם send_email_enabled: true וגם send_email_recipient שאינו ריק, ולאחר מכן פרסמו. הגדירו בהנחיה את התנאי להפעלה ואת התוכן הנדרש:

When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.

שיחה יכולה לנסות לשלוח עד שלושה אימיילים. כל נושא מוגבל ל-300 תווים וכל גוף הודעה ל-20,000 תווים. תצורה חסרה, תוכן לא תקין, המגבלה לכל שיחה וכשלי מסירה מוחזרים לסוכן. מסירה שנכשלה עדיין משתמשת באחד משלושת הניסיונות.

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

calculate#

מעריך ביטוי חשבוני בדיוק ומחזיר את התוצאה, כך שהסוכן לא מחשב מחירים בראשו. הוא מושבת כברירת מחדל. בלוח הבקרה, הפעילו מתקדם → מחשבון, ואז פרסמו את הסוכן. באמצעות Agents API, הגדירו calculator_enabled: true, ואז פרסמו.

המודל כותב את הביטוי, כגון 2*23.5 + 16.5 + 4, ומקריא את התוצאה בחזרה למתקשר. ביטויים יכולים להשתמש במספרים, +, -, *, / ו- סוגריים. שיחה אחת יכולה לכלול עד 10 ביטויים המופרדים באמצעות ;, כגון סכום ביניים והסכום הכולל עם דמי משלוח, ועד 500 תווים בסך הכול. התוצאות מעוגלות ל-10 ספרות אחרי הנקודה העשרונית. החישוב הוא חשבון עשרוני מדויק, לכן 0.1 + 0.2 מחזיר 0.3. חלוקה באפס וכל דבר אחר בביטוי מוחזרים לסוכן כשגיאה לתיקון. הכלי פועל ב-ThunderPhone ומחזיר תשובה מיידית, ללא משפט מילוי או צליל הקלדה.

הפעילו אותו עבור סוכנים שמוסרים סכומי הזמנה, עמלות או עודף. אין צורך בשינוי ההנחיה.

הערת תאימות#

ההגדרה מתקדם → גילויים שלא ניתנים להפרעה והשדה הישן speak_uninterruptible_enabled נשארים לצורכי תאימות, אך הפעלתם אינה משפיעה. השאירו את ההגדרה כבויה; שום הנחיה אינה יכולה להפעיל כלי זה.

עבור הודעת גילוי נדרשת בפתיחת שיחה, השתמשו בהודעת הסכמה. היא מושמעת מילה במילה לפני שיחה רגילה ואי אפשר להפריע לה. עיינו בחוקי הסכמה להקלטת שיחות.

בדיקה וניטור של כלים מובנים#

השתמשו ב-Talk בדפדפן או בסימולציה כדי לבדוק הנחיות, חיפוש ידע, צלילים ואימייל. סביבות אלה אינן יכולות לשחזר התנהגות של רשת טלפונית. בדקו ניווט במקשי הטלפון והמתנה בשיחת טלפון יוצאת, ובדקו העברה חמה מלאה בשיחה אמיתית באמצעות מספר VoIP מיובא שעומד בתנאים. התמיכה ב-Realtime מוגבלת כפי שמוצג בטבלה לעיל.

שיחות, תמחור ו-webhooks#

לפעולות מובנות אין עמלת כלי לכל שימוש. חיובי שיחה וספק רגילים עדיין חלים; ראו תמחור. השיחות והתוצאות שלהן עשויות להופיע בתמליל שהושלם, אך הן אינן מפיקות telephony.tool או web.tool. אירועים אלה מיועדים לפונקציות המוגדרות על ידיכם. רק ניתוק או העברה שהושלמו משנים את end_reason של השיחה; כשלים אחרים מוחזרים לסוכן. ראו webhooks להשלמה עבור רשומת השיחה.