# ---2.3 Broadcast Api

Broadcast API cho phép gửi block đến bất kỳ khách hàng nào của bot. Bạn cũng có thể gán thuộc tính cho khách hàng khi dùng api này.

Tất cả các truy vấn tới API phát sóng phải được cung cấp qua **POST** , có 2 cách gửi broadcast:

## I. Dùng "messenger\_user\_id" để xác định người nhận

`POST https://ahachat.com/api/bots/<BOT_ID>/users/<USER_ID>/send?ahachat_token=<TOKEN>&ahachat_message_tag=<AHACHAT_MESSAGE_TAG>&ahachat_block_name=<BLOCK_NAME>&<USER_ATTRIBUTE_1>=<VALUE_1>&<USER_ATTRIBUTE_2>=<VALUE_2>`

### Ví dụ

![](https://1430772033-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LRLPusy3tOEvIcKWwr2%2F-MCFPA4bD_X__-PgmwgW%2F-MCFTcq-ucxUmFyRXDfV%2FSelection_133.png?alt=media\&token=66d6ad7c-962b-46b6-a912-e03ed9be3366)

## II. Dùng "số điện thoại" để xác định người nhận

`POST https://ahachat.com/api/bots/<BOT_ID>/phones/send?ahachat_token=<TOKEN>&ahachat_message_tag=<AHACHAT_MESSAGE_TAG>&ahachat_block_name=<BLOCK_NAME>&phone=<USER_PHONE>&<USER_ATTRIBUTE_1>=<VALUE_1>&<USER_ATTRIBUTE_2>=<VALUE_2>`

### Ví dụ

![](https://1430772033-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LRLPusy3tOEvIcKWwr2%2F-MCFPA4bD_X__-PgmwgW%2F-MCFUQZbJlJMUkZ_IZn_%2FSelection_134.png?alt=media\&token=ce3b2138-ca6c-49b7-83e3-645dac64e093)

### **Giải thích các tham số truyền vào**&#x20;

*   **\<BOT\_ID>** — ID của bot bạn muốn gửi tin nhắn từ đó.&#x20;


* **\<MESSENGER\_USER\_ID>** — \{{messenger\_user\_id\}} của khách hàng mà bạn muốn gửi broadcast.\

*   **\<USER\_PHONE>** — Số điện thoại của khách hàng mà bạn muốn gửi broadcast.


*   **\<AHACHAT\_TOKEN>** — Mã token bí mật duy nhất tcho mỗi bot. Bạn có thể tìm và reset lại token này trong menu Cài đặt bất cứ lúc nào.


*   <**AHACHAT\_MESSAGE\_TAG**> — Thẻ tin nhắn cung cấp cho bạn khả năng gửi tin nhắn ngoài 24h, nên dùng mặc định là NON\_PROMOTIONAL\_SUBSCRIPTION. [See the full list of message tags here](https://developers.facebook.com/docs/messenger-platform/send-messages/message-tags).

    **`1.1 Trường hợp dùng thẻ CONFIRMED_EVENT_UPDATE`**\
    &#xNAN;_`Tin nhắn cập nhật cho khách hàng về sự kiện mà họ đã đăng ký, có thể được gửi tới khách hàng bất kỳ lúc nào. Ví dụ:`_\
    _`- Nhắc nhở về một sự kiện hoặc cuộc hẹn`_\
    _`- Xác nhận đặt phòng hoặc tham dự`_\
    _`- Cập nhật lịch trình di chuyển`_**`1.2 Trường hợp dùng thẻ POST_PURCHASE_UPDATE`**_`Tin nhắn cập nhật cho khách hàng về giao dịch mua hàng gần đây, có thể được gửi tới khách hàng bất kỳ lúc nào. Ví dụ:`_\
    _`- Hóa đơn hoặc biên lai`_\
    _`- Tình trạng đơn hàng, vận chuyển`_\
    _`- Thay đổi liên quan đến đơn hàng mà người dùng đã đặt`_**`1.3 Trường hợp dùng thẻ ACCOUNT_UPDATE`**_`Tin nhắn cập nhật cho khách hàng về thay đổi liên quan đến cá nhân, có thể được gửi tới khách hàng bất kỳ lúc nào. Ví dụ:`_\
    _`- Thay đổi trạng thái công việc`_\
    _`- Thay đổi tài khoản thanh toán`_\
    _`- Cảnh báo gian lậ`_



*   **\<AHACHAT\_BLOCK\_NAME>** — Tên block mà bạn muốn gửi đến khách hàng.


* **\<USER\_ATTRIBUTE>=\<VALUE>** — Tên và giá trị của thuộc tính người dùng bạn muốn lưu khi gửi tin nhắn.

{% hint style="info" %}
Ghi chú: Bạn có thể test API online tại [https://resttesttest.com/](https://resttesttest.com/)
{% endhint %}
