Webhook で外部システムに転送する

Webhook 転送とは#

LINE から atlio に届いたイベント（メッセージの受信、友だち追加など）を、指定した URL に転送する機能です。顧客管理システムなど、ほかのシステムと連携するときに使います。

Webhook を設定する#

1. Webhook設定を開く

   設定 を開き、設定メニューの Webhook設定 を選びます。

   1拡大

   ①設定変更

   1

2. Webhook を追加する

   Webhookを追加 を押し、次を入力して 保存 を押します。設定できる Webhook は1つです。登録後は 設定変更 で変更、削除 で削除します。

   項目	内容
   URL	転送先の URL です。https の URL だけを使えます。社内ネットワークなど、外部から届かないアドレスには送れません。
   説明	管理用のメモです（例：CRM連携用）。
   イベント	転送するイベントを選びます。メッセージ受信 (テキスト/画像/ファイル等)・友だち追加 / ブロック解除・ブロック、またはすべてを転送する 全てのイベントを受信 (Raw Pass-through) から選びます。

3. シークレットを控える

   保存すると シークレット が表示されます。この画面で一度だけ表示されるので、受け取り側のシステムに保存してください。

受け取り側の確認方法#

転送は、HTTP の POST で送ります。本文は LINE のイベントの JSON で、次のヘッダーが付きます。

受け取り側では、届いた本文から同じ方法で署名を計算し、X-atlio-Signature と一致することを確認してください。5秒以内に応答しない場合は、失敗として扱われます。