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

Field Type Description Note
id long ID vấn đề Nếu create, id = 0
title string Tiêu đề
description string Mô tả vấn đề
issueStatusId long ID trạng thái
issueTypeId long? ID loại vấn đề
customerId long? ID khách hàng
customerDraft string Tên KH nháp
phoneNumberDraft string SĐT nháp

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

4. Call Log