Skip to main content

Tích hợp AntBuddy

1. Tổng quan

Toàn bộ API sử dụng method POST.

1.1. Thông tin chung

Base URL:

1.2. Authentication

Phía Rạng Đông sẽ cung cấp Service Account. Service Account bao gồm code và password.

TODO: cung cấp code/password

  • Dev: code / password
  • Prod: code / password

AntBuddy gọi vào API /rpc/portal/service-profile/login để lấy JWT.

{
    "code": "string",
    "password": "string"
}

Response trả về sẽ có dạng:

{
    "token": "string",
    "expiredTime": "0000-00-00T00:00:00"
}

Thời hạn của JWT là 12 tiếng (43200 giây)

2. Customer

3. Ticket

3.1. Khái niệm

  • Ant Ticket tương ứng với CRM Issue
  • CRM Ticket là luồng nội bộ, không liên quan đến Ant Ticket

3.2. Luồng xử lý

AgentAntCRMticketId = nullalt[CRM xử lý][Ant xử lý]ticketId != nullalt[Không tạo CRM Ticket][Tạo CRM Ticket]Tạo ticketTạo CRM IssueXử lý/Đóng vấn đềĐồng bộXử lý/Đóng vấn đềĐồng bộTạo CRM TicketĐồng bộChặn xử lý/đóng trên AntXử lý/Đóng ticketĐồng bộAgentAntCRM

3.3. API

3.3.1. Webhook đồng bộ Ant -> CRM

API: /rpc/crm/ant/issue/webhook

FieldTypeDescriptionNote
idlongID vấn đềNếu create, id = 0
titlestringTiêu đề
descriptionstringMô tả vấn đề
issueStatusIdlongID trạng thái
issueTypeIdlong?ID loại vấn đề
customerIdlong?ID khách hàng
customerDraftstringTên KH nháp
phoneNumberDraftstringSĐT nháp

Nếu có customerId thì không cần customerDraft và phoneNumberDraft

4. Call Log