用戶推播
本教學將說明對用戶推播的兩種方式,分別適用於不同的場景。您可以依照需求選擇適合的推播方式。
透過 BotBonnie 的後台,您可以使用網站介面填寫下列資料以進行大範圍的訊息廣播:
- 粉絲頁 或 LINE 官方帳號
- (Messenger 推播時)填寫推播標籤,標示推播內容的種類,必須符合 Facebook 政策。
- 推播的模組
此種推播方式適用於對所有(或是特定用戶族群)廣播訊息,網站的介面會顯示預估觸及人數,方便您預估推播的成效。
當您需要對特定用戶推送個人化訊息時,就需要整合與 BotBonnie 的推播 API。
根據您服務的商業邏輯,可以在適當的時機於您的伺服器呼叫 BotBonnie 推播 API,請不要在客戶端(client side)呼叫 API,以避免您的 API token 遭到竊取。
您可以選擇推送單一特定訊息,或是先在 BotBonnie 後台建立好模組,以模組 ID 來推送。
- 模組訊息:請在
Request body
中以bot_mid
指定模組 ID。
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} |
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 個字元以下 | |
Last modified 2yr ago