送信

2020-11-11
2021-02-09

概要

SPALOアシスタントなどのチャットアプリで「送信」すると、登録されたWebhook-URL宛てに送信データが通知されます。

リクエスト方式

  • HTTP Method：POST
  • Content-Type：application/Json
  • 文字コード：UTF-8
  • タイムアウト：5秒

送信オブジェクト

パラメータ型内容
webhookKeystringWebhookのキー（固定値）。エンドポイント保護に利用します。
secretHashstringwebhook 毎の clientSecret の hash値（可変値）。エンドポイント保護に利用します。
eventstringイベント内容
eventTimestringイベント時刻
historyIdnumber履歴ID
botIdnumberボットID
workspaceNamestringワークスペース名
groupNamestringグループ名
botNamestringボット名
senderNamestring送信者名
dataobject送信データ（ボットによって異なります）ボット内の回答タイプ別のデータ構造は、以下を確認してください。

データパラメータ

回答タイプ型入力方法フォーマット・データ例
テキスト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"
  }
}

PAGE TOP