用戶推播

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

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:

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 個字元以下