# 購物車下單後推播訊息
## 目錄
1. [情境概述](#qing-jing-gai-shu)
2. [取得MantaGO Bot的ID](#qu-de-mantago-bot-de-id)
3. [拿（更新）Token和Secret Key ](#na-geng-xin-token-he-secret-key)
4. [推播訊息](#tui-bo-xun-xi)
1. [推送給Line用戶](#tui-song-te-ding-dui-hua-mo-zu-gei-te-ding-line-yong-hu)
2. [推送給Facebook用戶](#tui-song-wen-zi-gei-te-ding-facebook-yong-hu)
***
## 情境概述
用戶將購物車的商品做下單、並且結帳成功後，傳送後續的訊息給用戶，例如：提醒用戶結帳成功，可以至購物記錄查看商品的最新進度。
***
## 取得MantaGO Bot的ID
MantaGO Bot的ID在後續的API使用，都需要在request query或body之中，作為的botId的value進行帶入。
1. 例如，有下面幾個機器人：
2. 要拿皮卡丘的機器人的Bot ID，點進去皮卡丘的機器人：
3. 取得網址：`https://mantago.cc/chatbot/lNbWoobyg`。
4. 擷取網址內容的`/chatbot/`後的文字：`lNbWoobyg`，這個`lNbWoobyg`就是為皮卡丘的機器人的Bot ID。
***
## 拿（更新）Token和Secret Key
參考 [ru-he-qu-de-token](https://doc.mantago.cc/chang-jian-wen-ti/ru-he-qu-de-token "mention")的方法來取得打API用的Token和Secret Key。
如果API用的Token和Secret Key過期了，會得到以下錯誤：
```javascript
{
"success": false,
"errResponse": {
"message": "Token is invalid or expired",
"code": 1004,
"botId": "MantaGO Bot ID"
}
}
```
可以打換發API Token和Secret Key的API來取得新的API Token和Secret Key。
這裡提供換發API Token和Secret Key的程式碼範例：
```javascript
const axios = require('axios');
const secret = "API Secret Key"
const token = "API Token"
const botId = "MantaGO Bot ID"
const data = { "secret": secret };
const config = {
method: 'post',
url: 'https://mantago.cc/api/openapi/token?botId=botId',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${token}`,
},
data : data
};
async function makeRequest() {
try {
const response = await axios.request(config);
console.log(response.data);
}
catch (error) {
console.log(error);
}
}
makeRequest();
```
***
## 推播訊息
有了MantaGO Bot的ID以及有效的API Token和Secret Key，就可以進行推播。
從 [Broken link](https://doc.mantago.cc/qing-jing-fan-li/broken-reference "mention")的內容，在推播訊息的時候，有以下兩種選擇：
* 推送內容：文字或是特定對話模組。
* 平台用戶：以下將以Line和Facebook為例。
以下提供 『推送對話模組給特定Line用戶』 和 『推送文字給特定Facebook用戶』 兩種範例。
### 推送對話模組給特定Line用戶
傳送對話模組：
1. 進入對話模組取得這個對話模組的ID、拿網址：`https://mantago.cc/intent/YqaQwqdnj/rb2kYmMdW`、擷取最後一個『 / 』之後的文字，此對話模組的ID便是`rb2kYmMdW`。
2. 去打推播的API；推播訊息的程式碼範例：
```javascript
const axios = require('axios');
const secret = "API Secret Key"
const token = "API Token"
const botId = "MantaGO Bot ID"
const lineUUidList = [
"Line user uuid"
]
const data = {
"intentId": "rb2kYmMdW",
"botId": botId,
"clientIds": lineUUidList,
"platform": "line",
"secret": secret
};
const config = {
method: 'post',
url: 'https://mantago.cc/api/openapi/broadcast',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${token}`,
},
data : data
};
async function makeRequest() {
try {
const response = await axios.request(config);
console.log(response.data);
}
catch (error) {
console.log(error);
}
}
makeRequest();
```
3. 推送成功的API Response：
```
{
"success": true,
"message": "Send customer broadcast successfully"
}
```
4. 訊息：
### 推送文字給特定Facebook用戶
推送文字內容 ：『親愛的顧客您好，你已成功下單，可以至消費紀錄查看商品的最新進度』。
1. 去打API，推播訊息的程式碼範例：
```javascript
const axios = require('axios');
const secret = "API Secret Key"
const token = "API Token"
const botId = "MantaGO Bot ID"
const facebookUUidList = [
"Facebook user uuid"
]
const data = {
"message": "親愛的顧客您好，你已成功下單，可以至消費紀錄查看商品的最新進度",
"botId": botId,
"clientIds": facebookUUidList,
"platform": "facebook",
"fbTag": "POST_PURCHASE_UPDATE",
"secret": secret
};
const config = {
method: 'post',
url: 'https://mantago.cc/api/openapi/broadcast',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${token}`,
},
data : data
};
async function makeRequest() {
try {
const response = await axios.request(config);
console.log(response.data);
}
catch (error) {
console.log(error);
}
}
makeRequest();
```
2. 推送成功的API Response：
```
{
"success": true,
"message": "Send customer broadcast successfully"
}
```
3. 訊息：
