タスクのWebhook

タスクのWebhook

Webhookを設定すると、Zoho Projectsから外部サービスのアプリケーション宛てにインターネットを通じて自動でデータを送信することができます。Webhookは、アプリケーション内で特定の処理が行われた際に別のアプリケーションに対してリアルタイムでデータを送信するための機能です。Webhookの機能の利用することで、Zoho Projectsのタスクに関する実行条件とデータ送信先のURLを設定して、アプリケーション間でのデータの連携処理を自動化することが可能です。Webhookの詳細については、 こちら をご参照ください（英語）。

この機能を利用できるプラン： エンタープライズ プラン

Webhookの機能

  1. タスクの追加／更新に関するデータを他のアプリケーションに自動送信
  2. データの送信を実行するタイミングや条件を設定
  3. データの送信先URLや送信内容をカスタマイズ



Webhookの設定

  1. 画面右上の（設定）アイコン →［タスクの自動化］→［Webhook］ の順に移動します。
  2. ［Webhookを追加する］ をクリックします。
  3. Webhookの追加画面で、必要な値をすべて入力します。
  4. ［保存］ をクリックします。



Webhookの設定項目の一覧


項目名
説明
データの種類
上限
名前

Webhook名を入力します。

テキスト
100文字

連携先URL

連携する外部アプリケーションのURLを入力します（REST APIのURLなど）。
URL
1,000文字

メソッド

APIメソッドの種類（POSTまたはGET）を選択します。初期設定では、GETメソッドが選択されています。
ラジオボタン
   -

タスクのパラメーターの追加


  • パラメーターは、キーと値の組み合わせ、XMLやJSONなどの形式で指定できます。

  • パラメーター名を入力します。パラメーターの値は、標準項目やカスタム項目の値から選択して挿入できます。

  • 設定したパラメーターの名前と値を用いて、Webhookの実行時に外部アプリケーションに対してデータが送信されます。

テキスト
3,000文字

独自のパラメーターの追加


  • Webhookで使用するパラメーター名と値を独自に設定できます。値は、タスクの項目から選択するのではなく、任意の値を指定できます。

  • パラメーターは、キーと値の組み合わせで設定します。この設定は、認証トークンやAPIキーなどを送信する際などによく使用します。

テキスト
3,000文字
リクエストのヘッダーの追加
このキーと値の組み合わせは、HTTPリクエスト内のヘッダーパラメーターを設定するのに使用されます。
テキスト
3,000文字

URLのプレビュー

外部アプリケーションにデータを送信する際の、WebhookのURLのプレビューが表示されます。
表示のみ
表示のみ

メモ：
  1. 1日に実行可能なWebhookの件数には制限があります。
  2. 1日に実行可能なWebhookの件数は、2,000件までです。
  3. Webhookの実行が失敗した回数が1日に10回を超えた場合、該当のWebhookは無効になります。

関連情報：