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

התרחיש

חברת תוכנה מחייבת את הלקוחות שלה מדי חודש. החשבונית INV-2026-0547 של בובי, על סך 154.56 דולר אמריקאי, הייתה לתשלום עד 25 באוקטובר ועדיין פתוחה, ומייל התזכורת לא נענה. מערכת החיוב מוציאה שיחת תזכורת אחת. התפקיד של הסוכן הוא להזכיר, לא לנהל משא ומתן: הוא מאשר את היתרה, מקל על התשלום, ורושם מה בובי אומר.

הבקשה

על המפתחות והכותרות, ראו את סקירת ה-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: inv-2026-0547-reminder-1" \
  -d '{
    "from": "+16475550100",
    "to": "+12025550199",
    "targetName": "Bobby",
    "triggeredBy": "billing-overdue-reminder",
    "maxDurationSecs": 180,
    "task": {
      "goal": "After confirming you are speaking with Bobby, remind him that invoice INV-2026-0547 is past due, tell him how to pay, and note what he says.",
      "script": "payment_reminder",
      "facts": {
        "customer_name": "Bobby",
        "company_name": "Example Software",
        "invoice_id": "INV-2026-0547",
        "amount_due": "154.56 US dollars",
        "due_date": "October 25",
        "how_to_pay": "the secure payment link in the invoice email from billing@example.com",
        "billing_email": "billing@example.com"
      },
      "escalation": "If he disputes the charge, asks for different terms, or mentions hardship, do not discuss it further: say the billing team will contact him, email them a one-line summary, and end the call politely."
    }
  }'

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

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

קריאת התוצאה

מתוך ה-webhook מסוג call.ended או מ-GET /v1/voice/calls/{callControlId}:

• data.outcome.status ו-data.outcome.summary: האם התזכורת נמסרה ומה בובי אמר, לרשומת החשבונית. השדה outcome יכול להיות null כשה-webhook מגיע. כדי לקבל אותו, שלפו את השיחה מאוחר יותר.
• data.transcript: תיעוד מדויק של מה שנאמר, שימושי אם תתעורר מחלוקת.
• data.task.facts.invoice_id: מוחזר כמו שהוא, כך שאפשר להתאים את השיחה לחשבונית.

רשימת בדיקה רגולטורית

• הסכמה לשיחה. בארצות הברית, ה-FCC מתייחסת לקולות שנוצרו ב-AI כאל קולות מלאכותיים לפי חוק ה-TCPA. שיחות למספרים ניידים דורשות בדרך כלל הסכמה מוקדמת ומפורשת של הלקוח, ותנאי השירות שלכם לא בהכרח מספקים אותה.
• גבייה עבור אחרים. אם אתם גובים חובות שחייבים לחברה אחרת, חלים כללים פדרליים בארצות הברית (ה-FDCPA ו-Regulation F), ובהם שעות חיוג בין 8:00 ל-21:00 לפי השעה המקומית של הצרכן, מגבלות על תדירות השיחות, הודעות שחובה למסור, ואיסור לדון בחוב עם צדדים שלישיים. מדינות רבות מוסיפות כללים משלהן, וחלק מהם חלים גם על חברות שגובות את החשבוניות של עצמן.
• תדירות. קבעו תקרה, למשל שיחת תזכורת אחת לחשבונית בשבוע, ואכפו אותה במערכת שלכם. ה-API מגביל אתכם רק ל-5 שיחות בשעה למספר אחד.
• הודעה על הקלטה. השיחות מוקלטות כברירת מחדל. במקומות שבהם נדרשת הודעה, הכניסו אותה ל-firstMessage או לפתיחת התסריט.
• בקשות הסרה. רשמו בקשות "אל תתקשרו" מתוך התמלול או התוצאה, וכבדו אותן.