เหตุการณ์การเรียกกลับผ่าน Webhook

สร้างการสนทนาแล้ว

เมื่อผู้ใช้สร้างการสนทนาใหม่สำเร็จผ่าน API ระบบจะส่งเหตุการณ์การเรียกกลับไปยัง Webhook ที่กำหนดไว้สำหรับช่องทาง API เมื่อมีการสร้างการสนทนา

{ "account": { "id": 17629000001207, "name": "1112" }, "additional_attributes": {}, "can_reply": true, "channel": "Channel::Api", "contact_inbox": { "id": 42213404, "contact_id": 42218348, "inbox_id": 523, "source_id": "1d484823-da29-4086-a7ba-d65ad0ebb588", "created_at": "2026-01-21T03:26:49.012Z", "updated_at": "2026-01-21T03:26:49.012Z", "hmac_verified": false, "pubsub_token": "4Urn7N5A974k6C2H7Xeva8Ni" }, "id": 89, "inbox_id": 523, "messages": [], "labels": [], "meta": { "sender": { "additional_attributes": {}, "custom_attributes": {}, "email": "alice@acme.inc", "id": 42218348, "identifier": null, "name": "Test", "phone_number": "+123456789", "thumbnail": "", "blocked": false, "type": "contact" }, "assignee": null, "team": null, "hmac_verified": false, "channel": "Channel::Api" }, "status": "open", "custom_attributes": {}, "snoozed_until": null, "unread_count": 0, "first_reply_created_at": null, "priority": null, "waiting_since": 1768967324, "conversation_category": "chat", "chat_mode": "private_chat", "ticket_info": null, "agent_last_seen_at": 0, "contact_last_seen_at": 0, "last_activity_at": 1768967324, "timestamp": 1768967324, "created_at": 1768967324, "updated_at": 1768967324.268219, "event": "conversation_created" }
              
              {
  "account": {
    "id": 17629000001207,
    "name": "1112"
  },
  "additional_attributes": {},
  "can_reply": true,
  "channel": "Channel::Api",
  "contact_inbox": {
    "id": 42213404,
    "contact_id": 42218348,
    "inbox_id": 523,
    "source_id": "1d484823-da29-4086-a7ba-d65ad0ebb588",
    "created_at": "2026-01-21T03:26:49.012Z",
    "updated_at": "2026-01-21T03:26:49.012Z",
    "hmac_verified": false,
    "pubsub_token": "4Urn7N5A974k6C2H7Xeva8Ni"
  },
  "id": 89,
  "inbox_id": 523,
  "messages": [],
  "labels": [],
  "meta": {
    "sender": {
      "additional_attributes": {},
      "custom_attributes": {},
      "email": "alice@acme.inc",
      "id": 42218348,
      "identifier": null,
      "name": "Test",
      "phone_number": "+123456789",
      "thumbnail": "",
      "blocked": false,
      "type": "contact"
    },
    "assignee": null,
    "team": null,
    "hmac_verified": false,
    "channel": "Channel::Api"
  },
  "status": "open",
  "custom_attributes": {},
  "snoozed_until": null,
  "unread_count": 0,
  "first_reply_created_at": null,
  "priority": null,
  "waiting_since": 1768967324,
  "conversation_category": "chat",
  "chat_mode": "private_chat",
  "ticket_info": null,
  "agent_last_seen_at": 0,
  "contact_last_seen_at": 0,
  "last_activity_at": 1768967324,
  "timestamp": 1768967324,
  "created_at": 1768967324,
  "updated_at": 1768967324.268219,
  "event": "conversation_created"
}

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

พารามิเตอร์ของเหตุการณ์สร้างการสนทนา

Field Type Required Description
account Object No ข้อมูลบัญชีโปรเจกต์
id Number No ID โปรเจกต์
name String No ชื่อโปรเจกต์
additional_attributes Object No แอททริบิวต์เพิ่มเติม
can_reply Boolean No สามารถตอบกลับได้หรือไม่
channel String No ประเภทช่องทาง เช่น api, email เป็นต้น
contact_inbox Object No ข้อมูลผู้ติดต่อ
id Number No ID ของตาราง contact_inbox ใช้บันทึกความสัมพันธ์ระหว่างผู้ติดต่อกับช่องทาง
contact_id Number No ID ผู้ติดต่อ
inbox_id Number No ID ช่องทาง
source_id String No ID แหล่งที่มาของการสนทนา เช่น user_id ของ Telegram
created_at String No เวลาที่สร้าง
updated_at String No เวลาอัปเดต
hmac_verified Boolean No สถานะการตรวจสอบ HMAC
pubsub_token String No โทเค็นสำหรับเผยแพร่/สมัครรับข้อมูล
id Number No ID การสนทนา
inbox_id Number No ID ช่องทาง
messages Array No รายการข้อความ
labels Array No รายการป้ายกำกับ
meta Object No ข้อมูลเมตา
sender Object No ข้อมูลผู้ส่ง
additional_attributes Object No แอททริบิวต์เพิ่มเติมของผู้ส่ง
custom_attributes Object No แอททริบิวต์กำหนดเองของผู้ส่ง
email String No อีเมลของผู้ส่ง
id Number No ID ภายในของผู้ส่งใน liveDesk
identifier String No ตัวระบุผู้ส่ง
name String No ชื่อผู้ส่ง
phone_number String No หมายเลขโทรศัพท์ของผู้ส่ง
thumbnail String No รูปโปรไฟล์ของผู้ส่ง
blocked Boolean No ผู้ส่งถูกบล็อกหรือไม่
type String No ประเภทผู้ส่ง
assignee Object No ข้อมูลเจ้าหน้าที่บริการลูกค้าที่ได้รับมอบหมาย
team Object No ข้อมูลทีมบริการลูกค้าที่ได้รับมอบหมาย
hmac_verified Boolean No สถานะการตรวจสอบ HMAC
channel String No ประเภทช่องทาง
status String No สถานะการสนทนา เช่น open, closed เป็นต้น
custom_attributes Object No แอททริบิวต์กำหนดเอง
snoozed_until String No พักการแจ้งเตือนจนถึงเวลาที่กำหนด
unread_count Number No จำนวนข้อความที่ยังไม่ได้อ่าน
first_reply_created_at String No เวลาที่สร้างการตอบกลับครั้งแรก
priority String No ระดับความสำคัญ
waiting_since Number No เวลาเริ่มรอ
conversation_category String No หมวดหมู่การสนทนา
chat_mode String No โหมดแชท
ticket_info Object No ข้อมูลทิกเก็ต
agent_last_seen_at Number No เวลาที่เจ้าหน้าที่เห็นล่าสุด
contact_last_seen_at Number No เวลาที่ผู้ติดต่อเห็นล่าสุด
last_activity_at Number No เวลากิจกรรมล่าสุด
timestamp Number No การประทับเวลา
created_at Number No เวลาที่สร้าง
updated_at Number No เวลาอัปเดต
event String No ประเภทเหตุการณ์

อัปเดตการสนทนาแล้ว

เหตุการณ์นี้จะถูกทริกเกอร์เมื่อมีการอัปเดตแอททริบิวต์ใด ๆ ในการสนทนา

{ "event": "conversation_updated", "changed_attributes": [ { "updated_at": { "previous_value": "2026-01-21T04:04:56.548Z", "current_value": "2026-01-21T04:04:56.601Z" } }, { "first_reply_created_at": { "previous_value": null, "current_value": "2026-01-21T04:04:56.544Z" } }, { "waiting_since": { "previous_value": "2026-01-21T03:48:44.268Z", "current_value": null } } ] // <...Conversation Attributes> เนื้อหาแอททริบิวต์ของการสนทนา }
              
              {
  "event": "conversation_updated",
  "changed_attributes": [
    {
      "updated_at": {
        "previous_value": "2026-01-21T04:04:56.548Z",
        "current_value": "2026-01-21T04:04:56.601Z"
      }
    },
    {
      "first_reply_created_at": {
        "previous_value": null,
        "current_value": "2026-01-21T04:04:56.544Z"
      }
    },
    {
      "waiting_since": {
        "previous_value": "2026-01-21T03:48:44.268Z",
        "current_value": null
      }
    }
  ]
  // <...Conversation Attributes> เนื้อหาแอททริบิวต์ของการสนทนา
}

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

พารามิเตอร์ของเหตุการณ์อัปเดตการสนทนา

Field Type Required Description
event String No ประเภทเหตุการณ์
changed_attributes Array No รายการแอททริบิวต์ที่มีการเปลี่ยนแปลง
field_name Object No ชื่อฟิลด์ที่เปลี่ยนแปลง
previous_value String No ค่าก่อนการเปลี่ยนแปลง
current_value String No ค่าหลังการเปลี่ยนแปลง

สถานะการสนทนาเปลี่ยนแปลงแล้ว

เหตุการณ์นี้จะถูกทริกเกอร์เมื่อสถานะการสนทนามีการเปลี่ยนแปลง

{ "event": "conversation_status_changed" // <...Conversation Attributes> เนื้อหาแอททริบิวต์ของการสนทนา }
              
              {
  "event": "conversation_status_changed"
  // <...Conversation Attributes> เนื้อหาแอททริบิวต์ของการสนทนา
}

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

สร้างข้อความแล้ว

เหตุการณ์นี้จะถูกทริกเกอร์เมื่อผู้ใช้หรือเจ้าหน้าที่บริการลูกค้าส่งข้อความ

{ "account": { "id": 17629000001207, "name": "1112" }, "additional_attributes": {}, "content_attributes": {}, "content_type": "text", "content": "Hello, what can I help you with?", "conversation": { "account": { "id": 17629000001207, "name": "1112" }, "additional_attributes": {}, "can_reply": true, "channel": "Channel::Api", "contact_inbox": { "id": 42213404, "contact_id": 42218348, "inbox_id": 523, "source_id": "1d484823-da29-4086-a7ba-d65ad0ebb588", "created_at": "2026-01-21T03:26:49.012Z", "updated_at": "2026-01-21T03:26:49.012Z", "hmac_verified": false, "pubsub_token": "4Urn7N5A974k6C2H7Xeva8Ni" }, "id": 89, "inbox_id": 523, "messages": [ { "id": 2187685, "content": "Hello, what can I help you with?", "account_id": 17629000001207, "inbox_id": 523, "conversation_id": 89, "message_type": 1, "created_at": 1768968296, "updated_at": "2026-01-21T04:04:56.544Z", "private": false, "status": "sent", "source_id": null, "content_type": "text", "content_attributes": {}, "sender_type": "User", "sender_id": 41, "external_source_ids": {}, "additional_attributes": {}, "processed_message_content": "Hello, what can I help you with?", "sentiment": {}, "sorting_id": null, "original_message_id": null, "conversation_topic_id": null, "topic_id": null, "conversation": { "assignee_id": null, "unread_count": 0, "last_activity_at": 1768968296, "contact_inbox": { "source_id": "1d484823-da29-4086-a7ba-d65ad0ebb588" } }, "sender": { "id": 41, "name": "support", "available_name": "support", "avatar_url": "", "type": "user", "availability_status": null, "thumbnail": "" } } ], "labels": [], "meta": { "sender": { "additional_attributes": {}, "custom_attributes": {}, "email": "alice@acme.inc", "id": 42218348, "identifier": null, "name": "Test", "phone_number": "+123456789", "thumbnail": "", "blocked": false, "type": "contact" }, "assignee": null, "team": null, "hmac_verified": false, "channel": "Channel::Api" }, "status": "open", "custom_attributes": {}, "snoozed_until": null, "unread_count": 0, "first_reply_created_at": null, "priority": null, "waiting_since": 1768967324, "conversation_category": "chat", "chat_mode": "private_chat", "ticket_info": null, "agent_last_seen_at": 0, "contact_last_seen_at": 0, "last_activity_at": 1768968296, "timestamp": 1768968296, "created_at": 1768967324, "updated_at": 1768968296.5483441 }, "created_at": "2026-01-21T04:04:56.544Z", "id": 2187685, "inbox": { "id": 523, "name": "Test01" }, "message_type": "outgoing", "conversation_topic_id": null, "private": false, "sender": { "id": 41, "name": "support", "email": "support@jiguang.cn", "type": "user", "availability": "online" }, "source_id": null, "user_id": 42213404, "contact_id": 42218348, "participants": null, "event": "message_created" }
              
              {
  "account": {
    "id": 17629000001207,
    "name": "1112"
  },
  "additional_attributes": {},
  "content_attributes": {},
  "content_type": "text",
  "content": "Hello, what can I help you with?",
  "conversation": {
    "account": {
      "id": 17629000001207,
      "name": "1112"
    },
    "additional_attributes": {},
    "can_reply": true,
    "channel": "Channel::Api",
    "contact_inbox": {
      "id": 42213404,
      "contact_id": 42218348,
      "inbox_id": 523,
      "source_id": "1d484823-da29-4086-a7ba-d65ad0ebb588",
      "created_at": "2026-01-21T03:26:49.012Z",
      "updated_at": "2026-01-21T03:26:49.012Z",
      "hmac_verified": false,
      "pubsub_token": "4Urn7N5A974k6C2H7Xeva8Ni"
    },
    "id": 89,
    "inbox_id": 523,
    "messages": [
      {
        "id": 2187685,
        "content": "Hello, what can I help you with?",
        "account_id": 17629000001207,
        "inbox_id": 523,
        "conversation_id": 89,
        "message_type": 1,
        "created_at": 1768968296,
        "updated_at": "2026-01-21T04:04:56.544Z",
        "private": false,
        "status": "sent",
        "source_id": null,
        "content_type": "text",
        "content_attributes": {},
        "sender_type": "User",
        "sender_id": 41,
        "external_source_ids": {},
        "additional_attributes": {},
        "processed_message_content": "Hello, what can I help you with?",
        "sentiment": {},
        "sorting_id": null,
        "original_message_id": null,
        "conversation_topic_id": null,
        "topic_id": null,
        "conversation": {
          "assignee_id": null,
          "unread_count": 0,
          "last_activity_at": 1768968296,
          "contact_inbox": {
            "source_id": "1d484823-da29-4086-a7ba-d65ad0ebb588"
          }
        },
        "sender": {
          "id": 41,
          "name": "support",
          "available_name": "support",
          "avatar_url": "",
          "type": "user",
          "availability_status": null,
          "thumbnail": ""
        }
      }
    ],
    "labels": [],
    "meta": {
      "sender": {
        "additional_attributes": {},
        "custom_attributes": {},
        "email": "alice@acme.inc",
        "id": 42218348,
        "identifier": null,
        "name": "Test",
        "phone_number": "+123456789",
        "thumbnail": "",
        "blocked": false,
        "type": "contact"
      },
      "assignee": null,
      "team": null,
      "hmac_verified": false,
      "channel": "Channel::Api"
    },
    "status": "open",
    "custom_attributes": {},
    "snoozed_until": null,
    "unread_count": 0,
    "first_reply_created_at": null,
    "priority": null,
    "waiting_since": 1768967324,
    "conversation_category": "chat",
    "chat_mode": "private_chat",
    "ticket_info": null,
    "agent_last_seen_at": 0,
    "contact_last_seen_at": 0,
    "last_activity_at": 1768968296,
    "timestamp": 1768968296,
    "created_at": 1768967324,
    "updated_at": 1768968296.5483441
  },
  "created_at": "2026-01-21T04:04:56.544Z",
  "id": 2187685,
  "inbox": {
    "id": 523,
    "name": "Test01"
  },
  "message_type": "outgoing",
  "conversation_topic_id": null,
  "private": false,
  "sender": {
    "id": 41,
    "name": "support",
    "email": "support@jiguang.cn",
    "type": "user",
    "availability": "online"
  },
  "source_id": null,
  "user_id": 42213404,
  "contact_id": 42218348,
  "participants": null,
  "event": "message_created"
}

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

พารามิเตอร์ของเหตุการณ์สร้างข้อความ

Field Type Required Description
account Object No ข้อมูลบัญชี
id Number No ID โปรเจกต์
name String No ชื่อโปรเจกต์
additional_attributes Object No แอททริบิวต์เพิ่มเติม
content_attributes Object No แอททริบิวต์ของเนื้อหา
content_type String No ประเภทเนื้อหา
content String No เนื้อหาข้อความ
conversation Object No ข้อมูลการสนทนา
created_at String No เวลาที่สร้าง
id Number No ID ข้อความ
inbox Object No ข้อมูลช่องทาง
id Number No ID ช่องทาง
name String No ชื่อช่องทาง
message_type String No ประเภทข้อความ
conversation_topic_id String No ID หัวข้อการสนทนา
private Boolean No เป็นแบบส่วนตัวหรือไม่
sender Object No ข้อมูลผู้ส่ง
id Number No ID ผู้ส่ง
name String No ชื่อผู้ส่ง
email String No อีเมลของผู้ส่ง
type String No ประเภทผู้ส่ง
availability String No สถานะความพร้อมใช้งานของผู้ส่ง
source_id String No ID แหล่งที่มา
participants Object No ข้อมูลผู้เข้าร่วม
event String No ประเภทเหตุการณ์

อัปเดตข้อความแล้ว

เหตุการณ์นี้จะถูกทริกเกอร์เมื่อมีการอัปเดตเนื้อหาข้อความในการสนทนา

{ "event": "message_updated" // <...Message Attributes> เนื้อหาแอททริบิวต์ของข้อความ }
              
              {
  "event": "message_updated"
  // <...Message Attributes> เนื้อหาแอททริบิวต์ของข้อความ
}

            
โค้ดนี้โชว์เป็นหน้าต่างลอย
Icon Solid Transparent White Qiyu
ติดต่อฝ่ายขาย