הגדרות העברה לנציג

העברה לנציג מעבירה שיחות לאנשים כשנדרש יחס אישי. הגדירו אותה דרך ה-API.

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

איך פועלת העברה אוטומטית:

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

שיטות העברה נוספות:

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

ניתוב לפי נושא מאפשר ל-AI לשייך העברה לחבר צוות לפי תיאור הניתוב שלו. כל פרופיל שייך למשתמש אחד ונפרד מקטגוריות הנושאים בתובנות. הגדירו פרופילים דרך routing_profiles בבקשת PUT. שיוך ונמעני דוא״ל הם הגדרות נפרדות.

בדיקות דוגמה אופציונליות

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

קבלת הגדרות העברה

היקף הרשאות: read_all

GET https://app.quickchat.ai/v1/api/human_handoff/configuration

Shell
Python

curl https://app.quickchat.ai/v1/api/human_handoff/configuration \
  -H 'Authorization: Bearer <API_TOKEN>'

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/human_handoff/configuration",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

תגובה 200 OK

התגובה מכילה כמה אובייקטים מקוננים:

settings: הגדרות ההעברה העיקריות:

שדה	תיאור
`is_active` בוליאני	האם העברה לנציג מופעלת
`keywords` מערך מחרוזות	מילות מפתח להפעלה, למשל `["speak to human", "agent"]`
`ai_summary_active` בוליאני	שליחת סיכום שיחה שנוצר ב-AI לנציג בעת העברה
`topic_based_routing_active` בוליאני	האם מופעל ניתוב לפי נושא לנציגים מסוימים (קריאה בלבד, מוגדר דרך פרופילי ניתוב)
`question_message` מחרוזת	הודעה ששואלת אם המבקר רוצה להתחבר לאדם
`confirmation_message` מחרוזת	הודעה אחרי אישור ההעברה (עד 500 תווים)
`confirmation_outside_working_hours_message` מחרוזת	הודעה בבקשת העברה מחוץ לשעות העבודה (עד 500 תווים)
`working_hours_active` בוליאני	הגבלת העברה לשעות העבודה
`timezone` מחרוזת	אזור זמן לשעות העבודה, למשל `"Europe/London"`
`send_email_notification` בוליאני	שליחת התראות דוא״ל לנציגים בהעברה
`emails` מערך מחרוזות	כתובות דוא״ל להתראה

availability: לוח שעות עבודה (מערך חלונות):

שדה	תיאור
`id` מספר שלם	מזהה חלון הזמינות
`day_span` מחרוזת	יום או טווח ימים, למשל `"monday"`, `"monday-friday"`
`start_time` מחרוזת	שעת התחלה בפורמט `"HH:MM"`
`end_time` מחרוזת	שעת סיום בפורמט `"HH:MM"`

generic_guidelines: כללי הפעלה מוגדרים מראש (מערך):

שדה	תיאור
`name` מחרוזת	סוג ההנחיה: `"user_frustration"`, `"customer_support_suggestion"`, `"lack_of_knowledge"`, `"irrelevant_advice"`, `"media_message"`
`description` מחרוזת	תיאור מתי ההנחיה מופעלת
`is_active` בוליאני	האם ההנחיה מופעלת

custom_guidelines: כללי העברה שהגדיר המשתמש (מערך):

שדה	תיאור
`id` מספר שלם	מזהה ההנחיה
`name` מחרוזת	שם מותאם (עד 100 תווים)
`description` מחרוזת	מתי להפעיל העברה (עד 2,000 תווים)
`is_active` בוליאני	האם ההנחיה מופעלת

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

כשה-AI יוזם העברה, הוא יכול לבחור חבר צוות מפרופילי הניתוב הפעילים. אם הבחירה תקינה, השיחה משויכת אליו; אחרת היא נשארת ללא שיוך. גם טריגרים אחרים עשויים להשאיר ללא שיוך. התראות דוא״ל משתמשות ב-settings.send_email_notification וב-settings.emails בנפרד מבחירת הניתוב.

דוגמה: תנו לחבר צוות כספים את התיאור “שאלות חיוב וחשבוניות” ולמהנדס “תמיכה טכנית”. בשאלת חשבונית, ה-AI יכול להעביר לאיש הכספים. רשימת נמעני הדוא״ל אינה משתנה בגלל השיוך.

הגדירו פרופילים תחת פעולות ו־MCP > העברה לנציג > עריכת פעולה > ניתוב לפי נושא, או דרך בקשת PUT.

שדה	תיאור
`user_id` מספר שלם	מזהה המשתמש של חבר הצוות; חייבת להיות לו גישה לסוכן
`routing_description` מחרוזת	השיחות שעליו לטפל בהן (עד 150 תווים; לא ריק כשהפרופיל פעיל)
`is_active` בוליאני	האם פרופיל הניתוב מופעל
`email`, `first_name`, `last_name` מחרוזות	פרטי משתמש שמוחזרים ב-GET; אינם חובה ב-PUT

עדכון הגדרות העברה

היקף הרשאות: write_all

PUT https://app.quickchat.ai/v1/api/human_handoff/configuration

PUT מחליף את כל ההגדרות אטומית. כללו settings, availability, generic_guidelines ו-custom_guidelines. כללו routing_profiles לשימור הניתוב: השמטתו משתמשת ברשימה ריקה ומסירה פרופילים קיימים. לשינוי חלקי, קבלו קודם את ההגדרות ב-GET, שנו את השדות הרצויים ושלחו את האובייקט המלא ב-PUT. כל פרופיל משתמש ב-user_id, routing_description ו-is_active.

Shell
Python

# First, fetch the current configuration
CONFIG=$(curl -s https://app.quickchat.ai/v1/api/human_handoff/configuration \
  -H 'Authorization: Bearer <API_TOKEN>')

# Modify and PUT back (example: enable handoff)
echo "$CONFIG" | jq '.settings.is_active = true' | \
curl -X PUT https://app.quickchat.ai/v1/api/human_handoff/configuration \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d @-

import requests

headers = {"Authorization": "Bearer <API_TOKEN>"}

# Fetch current configuration
config = requests.get(
    url="https://app.quickchat.ai/v1/api/human_handoff/configuration",
    headers=headers,
).json()

# Modify and PUT back
config["settings"]["is_active"] = True

response = requests.put(
    url="https://app.quickchat.ai/v1/api/human_handoff/configuration",
    headers=headers,
    json=config,
)
data = response.json()

תגובה 200 OK: מחזירה את הגדרות ההעברה המעודכנות.

הגדרות העברה לנציג

בדיקות דוגמה אופציונליות

קבלת הגדרות העברה

עדכון הגדרות העברה

צעדים ראשונים

סוכן AI

פעולות

שיחות

ערוצים

האתר שלכם

תמיכה ו-CRM

אפליקציות הודעות

חשבון וחיוב

צעדים ראשונים

הגדרות

מאגר הידע

שיחות