Lead API Backend

Hướng dẫn dành cho Developer tích hợp Backend như : Node.js, PHP, .Net , Python...

Page : Tương đương 1 domain website. ( eg: abcd.com )

Conversation : Một cuộc hội thoại là một thông tin Khách hàng - Client (client_id), gồm có Tên, email hoặc số điện thoại.

Message : Một tin nhắn hoặc một sự kiện được tạo ra.

Hướng dẫn tạo kênh thu Lead.

1. ĐĂNG NHẬP

• Đăng nhập : https://botbanhang.vn/page

• Chọn "Inbox Pages"

Chọn "Inbox Pages"

2. THIẾT LẬP

Chọn biểu tượng thiết lập

3. TẠO MỚI

Chọn biểu tượng [+] để tạo mới

4. NHẬP THÔNG TIN

Điền thông tin phù hợp như hình dưới với tên miền của bạn.

5. LẤY PAGE_ID

• Chọn website bạn vừa tạo ở cột bên phải.

• Chọn tab "Thiết lập chung" để lấy ID Page như hình bên dưới.

Thông tin ID PAGE

Create or Update Conversation

POST https://chatbox-public.botbanhang.vn/v1/app/conversation/create

Tạo mới hoặc cập nhật cuộc hội thoại.

Request Body

Name	Type	Description
page_id	string	Page ID
client_id	string	Client ID
client_phone	string	Số điện thoại khách hàng
client_name	string	Tên khách hàng
client_avatar	string	Url avatar của khách hàng.
client_email	string	Email của khách hàng.

200 API hợp lệ.

{
    "succes": true,
    "code": 200,
    "data": {
        "client_id": "<ID>"
    }
}

403 API không hợp lệ.

{
    "succes": false,
    "code": 403,
    "message": "<MESSAGE>"
}

Create or Update Message

POST https://chatbox-public.botbanhang.vn/v1/app/message/create

Tạo mới hoặc cập nhật tin nhắn. Limit : 5 Tin nhắn

Request Body

Name	Type	Description
page_id	string	ID của Page
client_id	string	ID của conversation
message_text	string	Nội dung tin nhắn

200 API hợp lệ

{
    "succes": true,
    "code": 200,
    "data": "SUCCESS"
}

403 API không hợp lệ

{
    "succes": false,
    "code": 403,
    "message": "<MESSAGE>"
}