API Gửi tin nhắn

API: Gửi Tin Nhắn

Giới Thiệu

API này cho phép gửi tin nhắn đến khách hàng thông qua hệ thống chatbox.

Endpoint

POST https://chatbox-public-v2.botbanhang.vn/app/send_message

Header

Tên	Bắt buộc	Mô tả
Authorization	Có	API Key xác thực
Content-Type	Có	application/json

• Để lấy Authorization hãy tới Cài đặt trang -> Nâng cao -> API hoặc vào giao diện quản lý chatbot tới phần cài đặt và copy Mã xác thực API

Body Request

{
    "page_id": "1591257820328477563",
    "client_id": "3172193943399640766",
    "message": {
        "text": "test"
    }
}

Tham Số Body

Tên	Kiểu	Bắt buộc	Mô tả
page_id	String	Có	ID trang cần gửi tin nhắn
client_id	String	Có	ID khách hàng nhận tin nhắn
message	Object	Có	Nội dung tin nhắn
text	String	Có	Tin nhắn văn bản

Response

{
    "status": "success",
    "message": "Message sent successfully",
    "data": {
        "message_id": "1234567890"
    }
}

Mô tả Response

Tên	Kiểu	Mô tả
status	String	Trạng thái API
message	String	Mô tả kết quả
data	Object	Dữ liệu phản hồi
message_id	String	ID của tin nhắn vừa gửi

Cách Sử Dụng

Sử dụng cURL:

curl --location 'https://chatbox-public-v2.botbanhang.vn/app/send_message' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "page_id": "1591257820328477563",
    "client_id": "3172193943399640766",
    "message": {
        "text": "test"
    }
}'

Thay YOUR_API_KEY bằng API Key thực tế.

Lỗi Thường Gặp

Mã Lỗi	Mô tả
401	Authentication failed (Sai API Key)
400	Missing required parameters (Thiếu tham số bắt buộc)
500	Internal Server Error