送信
2020-11-11
2021-02-09
概要
SPALOアシスタントなどのチャットアプリで「送信」すると、登録されたWebhook-URL宛てに送信データが通知されます。
リクエスト方式
- HTTP Method：POST
- Content-Type：application/Json
- 文字コード：UTF-8
- タイムアウト：5秒
送信オブジェクト
| パラメータ | 型 | 内容 |
|---|---|---|
| webhookKey | string | Webhookのキー（固定値）。エンドポイント保護に利用します。 |
| secretHash | string | webhook 毎の clientSecret の hash値（可変値）。エンドポイント保護に利用します。 |
| event | string | イベント内容 |
| eventTime | string | イベント時刻 |
| historyId | number | 履歴ID |
| botId | number | ボットID |
| workspaceName | string | ワークスペース名 |
| groupName | string | グループ名 |
| botName | string | ボット名 |
| senderName | string | 送信者名 |
| data | object | 送信データ（ボットによって異なります）ボット内の回答タイプ別のデータ構造は、以下を確認してください。 |
データパラメータ
| 回答タイプ | 型 | 入力方法 | フォーマット・データ例 |
|---|---|---|---|
| テキスト | string | キーボード入力 | |
| 数字 | string | キーボード入力 | |
| 時間 | string | キーボード入力 | |
| 日付 | string | キーボード入力 | |
| メールアドレス | string | キーボード入力 | |
| ボタン | string | ボタンタップ | |
| 確認ボタン | string | ボタンタップ | |
| 位置情報 | object | 地図画面選択 | |
| 画像 | string | 画像選択 カメラ撮影 | botID_送信者ID_履歴ID_セル番地.jpg ファイル名は、履歴画面からダウンロードした場合と共通です。 |
送信オブジェクトサンプル
{
"webhookKey": "85126C79CBF9FE36BB9D05D0639C70C235C18D37",
"secretHash": "$2y$10$ee1ZuZ6XSxEkzq9egVTLL.OlU7wb/WCgY0ORQyCZpfiDihoPH3rXj",
"event": "RENDER",
"eventTime": "2020-10-16 14:00:00",
"historyId": 738,
"botId": 179,
"workspaceName": "テストワークススペース",
"groupName": "テストグループ",
"botName": "テストボット",
"senderName": "田中太郎",
"data": {
"テキスト": "テストデータです。",
"数字": "12345",
"時間": "12時34分",
"日付": "2020年01月02日",
"メールアドレス": "taro@spalo.jp",
"ボタン": "男",
"確認ボタン": "はい",
"位置情報": {
"address": "〒351-0000 埼玉県和光市新倉１丁目２−３４",
"latitude": 35.79273051148111,
"longitude": 139.60579443722963
},
"画像": "946_46_819_B4.jpg"
}
}