שיחות הודעה והתראה

התרחיש

לחברת אחסון מתוכננת תחזוקה ביום שבת בלילה. שירותי אחסון האתרים ובסיס הנתונים של דייוויד לא יהיו זמינים בין 2:00 ל-4:00 לפנות בוקר, לפי שעון החוף המזרחי של ארצות הברית (Eastern). החשבון שלו מסומן לקבלת שיחה ולא רק מייל, ולכן מערכת התפעול מוציאה שיחה אחת לכל חשבון מושפע.

הבקשה

על המפתחות והכותרות, ראו את סקירת ה-Voice API.

curl -X POST https://api.talktomyagent.io/v1/voice/calls \
  -H "Authorization: Bearer $TTMA_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: maint-1107-acct-5521-1" \
  -d '{
    "from": "+16475550100",
    "to": "+12025550156",
    "targetName": "David",
    "triggeredBy": "ops-maintenance-notice",
    "maxDurationSecs": 120,
    "firstMessage": "Hi, this is a quick service notice from Example Hosting. Is this David?",
    "task": {
      "goal": "Tell David about the planned maintenance on Saturday night, confirm he heard it, and answer questions from the facts.",
      "script": "service_notice",
      "facts": {
        "customer_name": "David",
        "company_name": "Example Hosting",
        "maintenance_date": "Saturday, November 7",
        "maintenance_window": "2:00 AM to 4:00 AM Eastern",
        "affected_services": "web hosting and database",
        "status_page": "status.example.com",
        "support_email": "support@example.com"
      },
      "escalation": "If he needs the window moved or has a question the facts do not answer, tell him the support team will email him, and note the request."
    }
  }'

• firstMessage קובע את משפט הפתיחה המדויק, עד 500 תווים. השתמשו בו כשהמילים הראשונות חייבות להיות מדויקות, למשל כדי לומר מי מתקשר לפני כל דבר אחר.
• maxDurationSecs. שתי דקות. הודעה צריכה להיות קצרה.
• כתבו את העובדות לאוזן. status.example.com נשמע טוב יותר בקול מכתובת מלאה עם נתיב. כתבו שעות ואזורי זמן במלואם.

מה התסריט מכסה

קריאת התוצאה

בהודעה, השאלה היא אם האדם שמע אותה. מתוך ה-webhook מסוג call.ended או מ-GET /v1/voice/calls/{callControlId}:

• data.outcome.status הוא completed כשההודעה נמסרה ואושרה. dropped פירושו שלא התקיימה שיחה שאפשר להשתמש בה. השדה עדיין יכול להיות null כשה-webhook מגיע. כדי לקבל אותו, שלפו את השיחה מאוחר יותר.
• data.durationSeconds ו-data.endedReason מראים אם מישהו ענה.
• data.transcript הוא התיעוד שלכם של מה שנאמר.

בחשבונות שבהם השיחה לא הושלמה, עברו למייל.

שימו לב

• בתקלה רחבה צריך קצב. כל סוכן מנהל 2 שיחות במקביל כברירת מחדל, ועד 30 שיחות יוצאות בשעה (100 ביום). אירוע שמשפיע על מאות חשבונות דורש תור, סדר עדיפויות, ומייל לכל השאר. אם אתם צריכים יותר קווים, דברו איתנו.
• שלחו רק מה שמותר לשמוע. מי שעונה לטלפון שומע את ההודעה אחרי בדיקת שם. השאירו מספרי חשבון וכל דבר רגיש מחוץ לעובדות.
• יעדים. אפשר להתקשר רק למדינות שברשימת השיחות היוצאות של הסוכן. ברירת המחדל היא ארצות הברית.
• בלי לולאות. חמש שיחות בשעה לאותו מספר הן מגבלה קשיחה. ניסיון אחד וניסיון חוזר אחד הם בדרך כלל הבחירה הנכונה.