שיחות

Quickchat AI מתעדת כל שיחה בכל הערוצים. נקודות הקצה מאפשרות להציג רשימות ולקבל שיחות.

Quickchat AI מתעדת ומנתחת אוטומטית כל שיחה של הסוכן בכל הערוצים: ווידג’ט, Slack, WhatsApp, Telegram ועוד. Conversations API מספק גישה תכנותית לנתונים לבניית לוחות בקרה, להזנת מערכות ניתוח, להפעלת תהליכי CRM או לחיבור לכלי הבינה העסקית שלכם.

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

נתוני השיחה זמינים בכמה נקודות קצה:

רשימת שיחות: מידע בסיסי, פרטי מבקר ומצב. ללוחות בקרה, סקירות ושאילתות מסוננות
קבלת פרטי שיחה: מידע מלא, כולל unified_analysis (תובנות AI) ו-client_metadata
קבלת אירועי שיחה: היסטוריית הודעות מלאה, לחיצות קישורים ורשומות יומן
קבלת/הגדרת מטא-נתונים: נתוני מפתח-ערך מותאמים שמצרפים לשיחה (ראו מטא-נתוני שיחה)

רשימת שיחות

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

GET https://app.quickchat.ai/v1/api_core/conversations

פרמטרי שאילתה

פרמטר	תיאור
`limit` מספר שלם	פריטים לדף
`offset` מספר שלם	פריטים לדילוג
`query` מחרוזת	חיפוש לפי מספר הזמנה, UUID או טקסט הודעה
`assignee_type` מחרוזת	`"ai_assistant"`, `"human_operator"` או `"unassigned"`
`source` מחרוזת	`"widget"`, `"slack"`, `"telegram"`, `"whatsapp"` וכו’
`resolution_status` מחרוזת	`"open"` או `"resolved"`
`created_timestamp_start_date` תאריך ושעה	סינון לפי תאריך יצירה (התחלה)
`created_timestamp_end_date` תאריך ושעה	סינון לפי תאריך יצירה (סיום)
`last_message_at_start_date` תאריך ושעה	סינון לפי מועד הודעה אחרונה (התחלה)
`last_message_at_end_date` תאריך ושעה	סינון לפי מועד הודעה אחרונה (סיום)
`most_frequent_language` מחרוזת	סינון לפי שפה שזוהתה
`order` מחרוזת	`"desc"` (ברירת מחדל, החדש תחילה) או `"asc"` (הישן תחילה). סדר עולה מיועד להתקדמות משיחה ידועה, לכן שלבו עם `last_message_at_start_date`

Shell
Python

curl 'https://app.quickchat.ai/v1/api_core/conversations?limit=10&resolution_status=open' \
  -H 'Authorization: Bearer <API_TOKEN>'

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api_core/conversations",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    params={"limit": 10, "resolution_status": "open"},
)
data = response.json()

תגובה 200 OK

{
  "items": [
    {
      "id": "conv-uuid-1234",
      "ord": 42,
      "created_at": "2026-01-15T10:30:00Z",
      "last_message_at": "2026-01-15T10:35:00Z",
      "title": "Return policy question",
      "source": "widget",
      "terminated": false,
      "resolution_status": "open",
      "has_unread_messages": true,
      "supports_inbox_control": true,
      "last_message_content": "What is your return policy?",
      "most_frequent_language": "en",
      "assignee": {
        "type": "ai_assistant"
      },
      "visitor_name": "John",
      "visitor_email": "john@example.com",
      "visitor_phone_number": null,
      "visitor_label": null
    }
  ],
  "offset": 0,
  "limit": 10,
  "count": 42
}

שדה	תיאור
`id` מחרוזת	UUID של השיחה
`ord` מספר שלם	מספר שיחה רציף
`created_at` מחרוזת	מועד יצירת השיחה
`last_message_at` מחרוזת	מועד ההודעה האחרונה
`title` מחרוזת	כותרת שיחה שנוצרה ב-AI
`source` מחרוזת	ערוץ המקור, למשל `"widget"`, `"slack"`, `"whatsapp"`
`terminated` בוליאני	האם השיחה הסתיימה
`resolution_status` מחרוזת	`"open"` או `"resolved"`
`has_unread_messages` בוליאני	האם יש הודעות שלא נקראו
`supports_inbox_control` בוליאני	האם המקור תומך בשליטה מתיבת הדואר הנכנס (שיוך, העברה)
`last_message_content` מחרוזת	תוכן ההודעה האחרונה
`most_frequent_language` מחרוזת	השפה שזוהתה בתדירות הגבוהה ביותר
`assignee` אובייקט	האחראי הנוכחי (`type`: `"ai_assistant"`, `"human_operator"` או `"unassigned"`)
`visitor_name` מחרוזת או null	שם המבקר (מטופס מקדים או מפרופיל הערוץ)
`visitor_email` מחרוזת או null	כתובת הדוא״ל של המבקר
`visitor_phone_number` מחרוזת או null	מספר הטלפון של המבקר
`visitor_label` מחרוזת או null	תווית מותאמת שהוקצתה למבקר

קבלת פרטי שיחה

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

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

Shell
Python

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

import requests

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

תגובה 200 OK

{
  "id": "conv-uuid-1234",
  "ord": 42,
  "created_at": "2026-01-15T10:30:00Z",
  "last_message_at": "2026-01-15T10:35:00Z",
  "title": "Return policy question",
  "source": "widget",
  "terminated": false,
  "resolution_status": "open",
  "has_unread_messages": true,
  "supports_inbox_control": true,
  "last_message_content": "What is your return policy?",
  "most_frequent_language": "en",
  "assignee": {
    "type": "ai_assistant"
  },
  "url": null,
  "client_metadata": {"userId": 12},
  "last_visitor_message_at": "2026-01-15T10:34:00Z",
  "unified_analysis": {
    "sentiment": "neutral",
    "resolution_status": "open",
    "topic": "Return policy",
    "is_flagged": false,
    "flag_reason": null
  },
  "visitor_name": "John",
  "visitor_email": "john@example.com",
  "visitor_phone_number": null,
  "visitor_label": null
}

תגובת הפרטים כוללת את כל שדות הרשימה, ובנוסף:

שדה	תיאור
`url` מחרוזת או null	כתובת הדף שבו החלה השיחה (ווידג’ט בלבד)
`client_metadata` אובייקט או null	זוגות מפתח-ערך מותאמים שצורפו לשיחה
`last_visitor_message_at` מחרוזת	מועד הודעת המבקר האחרונה
`unified_analysis` אובייקט או null	ניתוח שיחה שנוצר ב-AI (ראו למטה)

שדות unified_analysis:

שדה	תיאור
`sentiment` מחרוזת	רגשות שזיהה AI, למשל `"positive"`, `"neutral"`, `"negative"`
`resolution_status` מחרוזת	מצב הפתרון לפי AI (עשוי להיות שונה מ-`resolution_status` הראשי)
`topic` מחרוזת	נושא השיחה שזיהה AI
`is_flagged` בוליאני	האם ה-AI סימן את השיחה לבדיקה אנושית
`flag_reason` מחרוזת או null	הסיבה לסימון

השדה הראשי resolution_status ("open" או "resolved") הוא המצב הקנוני שנקבע ידנית או בכללי אוטומציה.

unified_analysis.resolution_status מחושב בניתוח AI ועשוי להיות שונה. למשל, ה-AI עשוי לסווג שיחה כפתורה לפי התוכן, כשהמצב הראשי עדיין "open". השתמשו בשדה הראשי לסינון ולתהליכי עבודה, וב-unified_analysis לניתוח ותובנות.

קבלת אירועי שיחה

קבלת כל האירועים (הודעות, קישורים במעקב ויומנים) לשיחה.

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

GET https://app.quickchat.ai/v1/api_core/conversations/{conversation_id}/events/

פרמטרי שאילתה

פרמטר	תיאור
`limit` מספר שלם	פריטים לדף
`offset` מספר שלם	פריטים לדילוג

Shell
Python

curl 'https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/events/?limit=20' \
  -H 'Authorization: Bearer <API_TOKEN>'

import requests

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

תגובה 200 OK

{
  "items": [
    {
      "type": "message",
      "data": {
        "id": "msg-uuid-001",
        "ord": 1,
        "created_at": "2026-01-15T10:30:00Z",
        "content": "Hello! How can I help you today?",
        "author": "ai_assistant",
        "handoff_state": null,
        "message_insights": null,
        "feedback": null,
        "client_metadata": null,
        "sources_generated": [],
        "is_welcome": true,
        "attachments": []
      }
    },
    {
      "type": "message",
      "data": {
        "id": "msg-uuid-002",
        "ord": 2,
        "created_at": "2026-01-15T10:31:00Z",
        "content": "What is your return policy?",
        "author": "visitor",
        "handoff_state": null,
        "message_insights": null,
        "feedback": null,
        "client_metadata": null,
        "sources_generated": [],
        "is_welcome": false,
        "attachments": []
      }
    }
  ],
  "offset": 0,
  "limit": 20,
  "count": 2
}

סוגי אירועים: message, tracked_link, log

סוגי מחברים: ai_assistant, visitor, human_operator

שדה	תיאור
`type` מחרוזת	סוג אירוע: `"message"`, `"tracked_link"` או `"log"`
`data.id` מחרוזת	מזהה ייחודי להודעה
`data.ord` מספר שלם	מספר הודעה רציף
`data.created_at` מחרוזת	מועד האירוע
`data.content` מחרוזת	תוכן ההודעה
`data.author` מחרוזת	`"ai_assistant"`, `"visitor"` או `"human_operator"`
`data.handoff_state` מחרוזת או null	מצב העברה, אם רלוונטי
`data.message_insights` אובייקט או null	תובנות הודעה שנוצרו ב-AI
`data.feedback` אובייקט או null	משוב משתמש על ההודעה
`data.client_metadata` אובייקט או null	מטא-נתונים מותאמים שצורפו להודעה
`data.sources_generated` מערך	מאמרי מאגר ידע שבהם ה-AI השתמש בתשובה
`data.is_welcome` בוליאני	האם זו הודעת פתיחה
`data.attachments` מערך	קבצים מצורפים

שיחות

רשימת שיחות

קבלת פרטי שיחה

קבלת אירועי שיחה

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

סוכן AI

פעולות

שיחות

ערוצים

האתר שלכם

תמיכה ו-CRM

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

חשבון וחיוב

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

הגדרות

מאגר הידע

שיחות