מטא-נתוני שיחה

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

• הזנה דרך API: השתמשו בנקודות הקצה לצירוף נתונים בתכנות לכל שיחה, למשל ממערכת CRM, תמיכה או שרת
• הזנה דרך ווידג’ט/הטמעה: העבירו נתונים כפרמטרי אתחול בטעינה או הזריקו אותם במהלך שיחה פעילה באמצעות JavaScript SDK
• הצגה בלוח הבקרה: נתונים מותאמים מופיעים בפרטי השיחה בתיבת הדואר הנכנס. מפתחות פנימיים מסוננים, ולפרטי קשר שנאספו ולזיכרון פעולות יש תצוגה משלהם
• הכללה בייצוא: הנתונים נכללים בייצוא שיחות מלוח הבקרה וזמינים לניתוח לא מקוון
• שימוש בפעולות AI: אפשר להזריק ערכים ישירות כמצייני מקום {{metadata_<key>}} לתוך פעולות AI. ראו משתני פעולות AI לתיעוד מלא
• זמינות לסוכן כשמותר: הקשר המודל משתמש בתת-קבוצה מסוננת. שמירת מפתח אינה מבטיחה שהמודל יקבל או יזכיר אותו

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

אם הוגדרה בלוח הבקרה סכימת JSON, המטא-נתונים מאומתים מולה.

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

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

• בדיקת תנאי הרצת פעולה. העריכו תנאים מול נתוני דוגמה בלי להריץ פעולה.

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

הקשר המודל והרשאות

בערוצים שבשליטת המבקר, כמו ווידג’ט האתר והטמעה, הקשר המודל מאפשר מפתחות קשר (visitor_name, visitor_email, visitor_phone_number) ומפתחות מתאימים שפעולות פעילות מפנות אליהם או אוספות. ערכים פנימיים ושמורים מסוננים; חלות גם מגבלות הגדרה וגודל. לתוספים אחרים כללי הקשר לפי ערוץ. מפתח מותאם כמו customer_tier או customer_id אינו גלוי אוטומטית למודל רק כי שלחתם אותו.

פעולה יכולה להחליף {{metadata_<key>}} בזמן בניית הבקשה בלי לבקש מה-AI לייצר את הערך. זה אינו הופך מטא-נתונים רגילים לסודיים: ערך מתאים עשוי להיכנס בנפרד להקשר המודל או להופיע בתגובת פעולה. אל תשמרו מפתחות API או סיסמאות במטא-נתונים מותאמים.

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

קבלת מטא-נתונים

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

GET https://app.quickchat.ai/v1/api_core/conversations/{conv_id}/metadata

Shell

curl https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

תגובה 200 OK

{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}

הגדרת מטא-נתונים

יצירה או עדכון של מטא-נתונים לשיחה.

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

POST https://app.quickchat.ai/v1/api_core/conversations/{conv_id}/metadata

גוף הבקשה

פרמטר	תיאור
metadata אובייקט, חובה	נתוני מפתח-ערך לשמירה

Shell

curl -X POST https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "metadata": {"ticket_id": "T-1234", "priority": "high"}
    },
)
data = response.json()

תגובה 200 OK

{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}

---