外部Webhook受信

予約システムや顧客管理のシステムから届いたデータで、友だちの情報欄を書き換えたり、タグを付けたりする画面です。

外部のサービスに、Lally の受け取り用の URL へデータを送ってもらうと、そのデータで友だちの情報を自動で更新します。たとえば予約システムで予約が確定したら、その友だちに「予約確定」のタグを付ける、といった使い方をします。受け取ったときは、自動応答の「イベント応答」で、トリガーを「外部Webhook受信」にしたルールも動きます。

送る側の設定には、システムの担当者の作業が要ります。この画面で作った URL と「signing secret」を、担当者に渡してください。

• メニュー: 左メニューの「設定」→「外部Webhook受信」
• 見られる人: オーナー・管理者・スタッフ。設定の機能と担当のアカウントの両方が「編集」のスタッフは、設定を作ったり変えたりできます
• 前もって: 左メニューの一番上で、設定するアカウントを選んでおくこと

外部Webhook受信画面の見方

設定は選んでいるアカウントごとに分かれています。

設定の作成の手順

データの使い方を指定する方法

「field mapping JSON」には次の 4 つを書きます。値の場所は $.reservation.status のように、受け取るデータの中の位置で書きます。

例: 予約の状態が「confirmed」になったら、タグを付け、次の来店日を友だち情報欄に入れる

{
  "friendLookup": { "type": "line_user_id", "path": "$.customer.line_user_id" },
  "friendAttributes": [{ "attributeKey": "next_visit_at", "path": "$.reservation.start_at" }],
  "tags": [{ "tagId": "付けたいタグの ID", "path": "$.reservation.status", "equals": "confirmed" }]
}

初めに入っている見本の tag_xxx は仮の ID です。そのまま保存せず、付けたいタグの ID に書き換えてください。

友だちが見つからなかったときは、情報もタグも変わりません。line_user_id で探す設定なら、まだ友だち追加していない人の分を 24 時間取っておき、その間に友だち追加したときに入れます。

送る側にお願いすること

送る側にはデータを JSON で、受け取り用の URL へ POST してもらいます。併せて、次の 3 つのヘッダーを付けてもらいます。

署名が合わないデータや、時刻が古いデータは受け付けません。

使用例：予約システムで予約が確定したら、友だちにタグを付ける

予約が確定した友だちに「予約確定」のタグを付け、自動応答でお礼のメッセージを送れるようにする例です。

困ったとき