用戶推播

本教學將說明對用戶推播的兩種方式，分別適用於不同的場景。您可以依照需求選擇適合的推播方式。

1. 使用 BotBonnie 後台進行推播
透過 BotBonnie 的後台，您可以使用網站介面填寫下列資料以進行大範圍的訊息廣播：
粉絲頁 或 LINE 官方帳號
(Messenger 推播時）填寫推播標籤，標示推播內容的種類，必須符合 Facebook 政策。
推播的模組
此種推播方式適用於對所有（或是特定用戶族群）廣播訊息，網站的介面會顯示預估觸及人數，方便您預估推播的成效。
2. 使用 push API 進行推播
當您需要對特定用戶推送個人化訊息時，就需要整合與 BotBonnie 的推播 API。
根據您服務的商業邏輯，可以在適當的時機於您的伺服器呼叫 BotBonnie 推播 API，請不要在客戶端（client side）呼叫 API，以避免您的 API token 遭到竊取。
訊息內容
您可以選擇推送單一特定訊息，或是先在 BotBonnie 後台建立好模組，以模組 ID 來推送。
特定訊息：單一訊息格式請使用 JSON object，請參閱 JSON 訊息。
模組訊息：請在 Request body 中以 bot_mid 指定模組 ID。
何謂訊息類別（category)？
BotBonnie 透過類別來歸類個人化推播訊息，以便在報表中提供您各種類的訊息數量。若沒有填寫，在報表中會將該訊息統一歸類在未知的類別。
您可以根據您的商業邏輯自行命名分類的名稱，常見的例如：product_arrived、refund...等等。
在您的伺服器呼叫 BotBonnie 推播 API：
POST https://api.botbonnie.com/v1/api/message/push
Request headers
Name
Description
Content-Type
application/json
Authorization
Bearer {API Token}
​如何取得 API Token ？
Request body
Name
Type
Description
Required
bot_id
String
機器人的 ID
o
bot_uid (deprecated)
String
用戶 ID (加密)
與 bot_raw_uid 擇一 
bot_raw_uid
String
用戶 ID (未加密)
與 bot_uid 擇一
bot_pid
String
粉絲頁 ID
o
bot_channel
Number
渠道代號  0：Facebook   1：LINE
o
bot_mid
String
模組 ID
與 message 擇一
message
Object
訊息內容
與 bot_mid 擇一
type
String
推播內容之標籤，可使用之類型如下：
POST_PURCHASE_UPDATE：購買商品更新資訊
CONFIRMED_EVENT_UPDATE：排定活動更新訊息
ACCOUNT_UPDATE：帳號更新
UPDATE：一般更新訊息，僅能在用戶互動後 24 小時內推播
推播渠道為 Facebook 時必填
category
String
訊息類別   限 20 個字元以下
​
​訊息格式請參閱 JSON 訊息​

教學範例 - Previous

帳號綁定

Next - 教學範例

用戶標籤

Last modified 1yr ago

Name	Description
Content-Type	application/json
Authorization	Bearer `{API Token}`

Name	Type	Description	Required
bot_id	String	機器人的 ID	o
bot_uid (deprecated)	String	用戶 ID (加密)	與 bot_raw_uid 擇一
bot_raw_uid	String	用戶 ID (未加密)	與 bot_uid 擇一
bot_pid	String	粉絲頁 ID	o
bot_channel	Number	渠道代號 `0`：Facebook `1`：LINE	o
bot_mid	String	模組 ID	與 message 擇一
message	Object	訊息內容	與 bot_mid 擇一
type	String	推播內容之標籤，可使用之類型如下： `POST_PURCHASE_UPDATE`：購買商品更新資訊 `CONFIRMED_EVENT_UPDATE`：排定活動更新訊息 `ACCOUNT_UPDATE`：帳號更新 `UPDATE`：一般更新訊息，僅能在用戶互動後 24 小時內推播	推播渠道為 Facebook 時必填
category	String	訊息類別限 20 個字元以下