Tích hợp AntBuddy

1. Tổng quan

Toàn bộ API từ phía Rạng Đông sử dụng method POST.

1.1. Thông tin chung

Base URL:

• Dev: https://rdev.supa.vn
• Prod: https://portal.rangdong.com.vn

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ý

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

3.3.2. Đồng bộ CRM -> Ant

API: https://apiring.antbuddy.com/tickets (POST)

Field	Type	Description	CRM Note
ticketId	string	ID vấn đề
title	string	Tiêu đề
summary	string	Mô tả	= description
priority	string	Mức độ ưu tiên	= ticket.ticketPriority.name
status	string	Trạng thái	= issueStatus.name
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

4. Call Log