שיחות תזכורת לתורים

התרחיש

מרפאת שיניים רוצה שכל מי שקבע תור יקבל שיחה 24 עד 48 שעות לפני הביקור. למריה יש ניקוי שיניים ביום חמישי ב-10:30 בבוקר. הסוכן צריך לאשר את התור, או לרשום מועד אחר שנוח לה, כדי שהקבלה תקבע לה תור חדש. מערכת זימון התורים שלכם מוציאה שיחה אחת לכל תור.

הבקשה

קודם קראו את סקירת ה-Voice API כדי להכיר את המפתחות והכותרות. הבקשה הזו משתמשת במפתח voice:call ומתקשרת ממספר הסוכן של המרפאה.

curl -X POST https://api.talktomyagent.io/v1/voice/calls \
  -H "Authorization: Bearer $TTMA_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: appt-48213-reminder-1" \
  -d '{
    "from": "+16475550100",
    "to": "+12025550134",
    "targetName": "Maria",
    "triggeredBy": "scheduling-system",
    "maxDurationSecs": 180,
    "task": {
      "goal": "Confirm the cleaning for Maria on Thursday at 10:30 AM, or note the day and time she would prefer instead.",
      "script": "appointment_confirmation",
      "facts": {
        "patient_name": "Maria",
        "appointment_type": "dental cleaning",
        "appointment_date": "Thursday, November 12",
        "appointment_time": "10:30 AM",
        "provider_name": "Dr. Patel",
        "practice_name": "Riverside Dental",
        "office_phone": "+16475559876"
      },
      "escalation": "If she asks a clinical question, say the office will call her back, and end the call."
    }
  }'

• Idempotency-Key. בנו אותו ממזהה התור וממספר הניסיון, כמו בדוגמה. כך גם ניסיון חוזר אחרי שגיאת רשת לא יחייג למריה פעמיים.
• maxDurationSecs. שלוש דקות מספיקות בהחלט לאישור תור. המינימום הוא 60.
• facts. שלחו תאריכים ושעות בדיוק בניסוח שבו הסוכן צריך לומר אותם. הסוכן אומר רק עובדות ששלחתם.

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

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

קריאת התוצאה

רשמו webhook מסוג call.ended, או שלפו את GET /v1/voice/calls/{callControlId}. השדות השימושיים לתזכורת:

שימו לב

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