Webhookを設定する

kintoneでWebhookを利用すると、kintoneのアプリで特定の操作が行われた際に、その内容を指定した外部サービスに送信することができます。
たとえば、レコードが追加されたときにその内容をチャットサービスに投稿する、といった連携を、プログラムを書くことなく設定することが可能です。
Webhookは、kintoneスタンダードコースでのみ利用できます。

Webhookの仕組み

Webhookの連携先として、多数のサービスとの連携を支援してくれるツールを指定すると、それらが対応しているさまざまなサービスとkintoneを連携することができます。
連携を支援してくれるツールとしては、Zapier、Microsoft Power Automate、IFTTTなどがあります。

画像

Webhookの設定を行うと、kintoneのアプリで以下の操作が行われた際に通知が送信されます。

  • レコードの追加
  • レコードの編集
  • レコードの削除
  • コメントの書き込み
  • プロセス管理のステータスの更新

kintoneで操作を行ったときの通知のパラメーターについては、kintoneの操作で送信されるWebhookの通知内容を参照してください。

設定例

ここではZapierを使って、「kintoneにレコードが追加されたらGmailに通知する」設定例を説明します。

事前準備

Webhookの連携設定を行う前に、次の準備を行ってください。

  • Gmailアカウントの作成
  • kintoneのアプリを作成

準備ができたら、次の設定を行います。

Zapierでトリガーを設定する

  1. ZapierのWebサイトにアクセスし、サインアップします。
    Zapierのアカウントがない場合は、新規作成するか、またはGoogleアカウントなどでサインアップしてください。

  2. ZapierのWebサイトにある[MAKE A ZAP]をクリックします。

  3. 「Name your zap」に任意のタイトルを入力します。

  4. トリガー選択画面で、検索ボックスに「Webhook」と入力し、「Webhooks by Zapier」をクリックします。

  5. トリガーイベントで「Catch Hook」を選択し、[CONTINUE]をクリックします。

  6. Custom Webhook URL が生成されるので、[Copy]をクリックします。
    テキストエディタなどに、URLをペーストしておいてください。

kintoneでWebhookを設定する

  1. kintoneでWebhookの設定画面を開きます。
    レコード一覧画面の右上にあるアプリ設定ボタン 設定ボタン をクリックし、「設定」タブの「カスタマイズ／サービス連携」にある[Webhook]を選択します。

  2. 追加ボタン 画像をクリックします。

  3. 設定するWebhookの説明を入力します。
    入力した説明はWebhookの設定の一覧画面に表示されます。64文字まで入力できます。 画像

  4. Webhook URLに、Zapierでトリガーを設定するの手順6でコピーしたURLをペーストします。 ペーストしたURLの先頭にある「https://」は不要なため、削除します。
    URL欄には最大1,024文字まで入力できます。

  5. 通知を送信する条件では、Webhookの通知を送信する操作を指定します。
    ここでは、「レコードの追加」にチェックを付けます。

  6. 設定したWebhookを有効にするかどうかを選択します。初期設定では有効です。

  7. [保存]をクリックします。

  8. Webhookの設定画面右下の[アプリの設定に戻る]をクリックします。

  9. アプリの設定画面右上の[アプリを更新]をクリックし、[OK]をクリックします。

  10. Zapierで設定したトリガーのテストを行うため、kintoneのアプリに新規でレコード追加します。

  11. ZapierのWebサイトに戻り、[CONTINUE]をクリックして、[Test trigger]をクリックします。

  12. テストが成功したことを確認して、[CONTINUE]をクリックします。
    テストが成功しない場合は、何度か[Test trigger]を試してください。
    それでも失敗する場合、Webhook URLにコピー＆ペーストしたURLに誤りがないかなど、確認してください。

Zapierでアクションの設定をする

  1. Zapierのアクションの設定が表示されるので、Gmailを選択します。

  2. アクションイベントで「Send Email」を選択し、[CONTINUE]をクリックします。

  3. Gmailアカウントを選択し、[CONTINUE]をクリックします。
    Gmailにログインしていない場合は、Gmailへのログイン許可を確認する画面が表示されます。

  4. Gmailに通知される内容を設定します。「To」に受信するGmailアドレスを入力し、Subject、Bodyなど必要な内容を設定します。
    設定後、[CONTINUE]をクリックします。

  5. 設定内容を確認し、[TEST & CONTINUE]をクリックします。

  6. 宛先のGmailにメールが届いたことを確認し、[TURN ON ZAP]をクリックします。

  7. 設定したZapをONにして有効にします。

kintoneのWebhookの設定を変更する

  1. 設定を変更したいWebhookの編集ボタン 編集ボタンをクリックします。
    Webhookの設定変更

  2. Webhookの設定画面右下の[アプリの設定に戻る]をクリックします。

  3. アプリの設定画面右上の[アプリを更新]をクリックし、[OK]をクリックします。

kintoneのWebhookの設定を削除する

  1. 削除したいWebhookの削除ボタン 削除ボタンをクリックして、[削除する]をクリックします。 Webhookの削除
  2. Webhookの設定画面右下の[アプリの設定に戻る]をクリックします。
  3. アプリの設定画面右上の[アプリを更新]をクリックし、[OK]をクリックします。