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

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_arrivedrefund...等等。
在您的伺服器呼叫 BotBonnie 推播 API:
1
POST https://api.botbonnie.com/v1/api/message/push
Copied!
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 6mo ago