邦妮科技 BotBonnie
Search…
如何使用 JSON 訊息？
BotBonnie 提供特殊的JSON 訊息格式，可以利用此種訊息格式，串接您的服務，由您的伺服器動態提供不同的訊息內容。僅需提供您的
JSON API URL，在呼叫您的 API 時，BotBonnie 會自動帶入以下資料：- 在 Request Body 帶入用戶識別資料
- 在 Request Header 帶入
X-Hub-Signature做安全性驗證
而您的 API 需回傳 BotBonnie 特定訊息 JSON 格式。
1. JSON 訊息範例
2. 用戶識別資料
參數名稱
類型
描述
bot_id
String
機器人的 ID
bot_uid
(deprecated)
String
用戶 ID (加密)
bot_raw_uid
String
用戶 ID (未加密)
bot_pid
String
粉絲頁 ID
bot_channel
Number
渠道代號 （
0：Facebook / 1：LINE）bot_isLinked
(deprecated)
Boolean
用戶目前是否已經帳號連結 （
true / false）3. 取得額外資料
當您的 JSON API 需要使用者的相關資料時，可以在 JSON API 網址中加上相關參數，BotBonnie 會在 Request POST body 中將相關的資訊一併傳送至您的伺服器。
1
https://yourdomian.com?fields=user,userParams
Copied!
您可以在
JSON API URL 上攜帶額外網址參數來獲取 BotBonnie 提供的額外資訊。 目前支援的網址參數類型如下：參數名稱
類型
支援的種類
fieldsString
user: 提供當下的用戶資料 user_params: 提供儲存於 BotBonnie 端的自訂用戶參數範例的 Body 如下：
1
{
2
"bot_id": "bot-xxxxx",
3
"bot_uid": "3xxxxxxxxxxxd",
4
"bot_raw_uid": "2xxxxxxxxxxxx0",
5
"bot_pid": "1234779123812",
6
"bot_channel": 0,
7
"bot_isLinked": true,
8
"user": {
9
"id": "3xxxxxxxxxxxd",
10
"rawId": "2xxxxxxxxxxxx0",
11
"created": 1505360797321,
12
"name": "陳邦妮",
13
"gender": "female",
14
"last_name": "陳",
15
"pic": "https://scontent.xx.fbcdn.net/v/t31.0-1/p960x960/1800025_10202073294786135_45024857_o.jpg?oh=85252db7049dbf99de251175d03a6d46&oe=5A604B50",
16
"locale": "zh_TW",
17
"first_name": "邦妮",
18
"timezone": 8
19
},
20
"userParams": {
21
"input": "你好",
22
...
23
}
24
...
25
}
Copied!
user
所有與用戶相關的資訊
鍵值
數值
必定存在
idBotBonnie 認定之用戶 ID (加密)
ex:
3e69e881732e38b290e39a28b87403bdo
rawIdBotBonnie 認定之用戶 ID (未加密)
ex:
2452158751517100o
createdBotBonnie 建立此用戶的時間，unixtime 以毫秒表示 ex:
1505360797321o
name用戶全名 ex:
陳邦妮
last_name用戶姓氏 ex:
陳
first_name用戶名稱 ex:
邦妮
gender用戶性別
male or female
pic用戶大頭照網址
locale用戶所在地區 ex:
zh_TW
timezone用戶時區 ex:
8
userParams
企業儲存於用戶身上額外的參數
鍵值
數值
必定存在
input觸發此 JsonAPI 的用戶輸入
4. 來源安全性驗證
BotBonnie 會在 Request Header 帶入
X-Hub-Signature 確保來源安全性。X-Hub-Signature 是為了驗證 POST 請求是來自 BotBonnie 伺服器，而不是來自惡意用戶。我們使用 SHA1 將 API Secret 與原始請求做雜湊，您可以在您的伺服器做來源驗證。4.1 如何取得 API Secret ？
API Secret ？BotBonnie 提供每個 bot 專屬的
API Secert。可進入 bot 主控台，點選「設定 > 進階設定」，即可取得此 bot 的 API Secert。4.2 如何驗證 X-Hub-Signature ？
X-Hub-Signature ？假設您有一個基本的伺服器監聽 webhooks 。
1
var express = require('express')
2
var bodyParser = require('body-parser')
3
var crypto = require('crypto')
4
5
// Express error-handling middleware function.
6
// Read more: http://expressjs.com/en/guide/error-handling.html
7
function abortOnError(err, req, res, next) {
8
if (err) {
9
console.log(err)
10
res.status(400).send({ error: "Invalid signature." })
11
} else {
12
next()
13
}
14
}
15
16
var app = express();
17
var listener = app.listen(process.env.PORT ? process.env.PORT : 3000)
18
19
// body-parser is the first Express middleware.
20
app.use(bodyParser.json({ verify: verifyRequest }))
21
22
// Add an error-handling Express middleware function
23
// to prevent returning sensitive information.
24
app.use(abortOnError)
25
26
app.post('/webhook/', function (req, res) {
27
res.status(200).send("done!")
28
})
Copied!
使用
API Secret 與原始請求做驗證。1
// Calculate the X-Hub-Signature header value.
2
function getSignature(buf) {
3
var hmac = crypto.createHmac("sha1", process.env.BOTBONNIE_API_SECRET)
4
hmac.update(buf, "utf-8")
5
return "sha1=" + hmac.digest("hex")
6
}
7
8
// Verify function compatible with body-parser to retrieve the request payload.
9
// Read more: https://github.com/expressjs/body-parser#verify
10
function verifyRequest(req, res, buf, encoding) {
11
var expected = req.headers['x-hub-signature']
12
var calculated = getSignature(buf)
13
console.log("X-Hub-Signature:", expected, "Content:", "-" + buf.toString('utf8') + "-")
14
if (expected !== calculated) {
15
throw new Error("Invalid signature.")
16
} else {
17
console.log("Valid signature!")
18
}
19
}
Copied!
Last modified 1yr ago