ウェブフック - Zoho People
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
Webhookとは何ですか？
Zoho Peopleでは、WebhookはZoho Peopleからのリアルタイムのデータ転送や通知を自動化し、それを第三者のアプリケーションに対して行うメカニズムです。ユーザがZoho Peopleで操作を行うたびに、指定されたURLにアラートを送信し、すぐに通信を行うことができます。この自動化により、Zoho Peopleと他の第三者アプリケーションとの間のスムーズで効率的な統合を実現します。
Webhookはユーザが定義したHTTPコールバックで、HTTP POSTを介して送信される自動化されたイベント通知として機能します。それらは指定されたURLにメッセージを配信し、事前に設定された条件が満たされるたびに通知します。
Zoho PeopleでのWebhookの動作方法は？
- サービス内のフォームにWebhookを作成し、新規または既存のワークフローに関連付けます。
- ワークフローのトリガーイベントが発生すると、Webhookがアクティブ化され、Zoho Peopleから第三者のアプリケーションに自動的なアラートを送信します。
Webhookの利点
- 柔軟性があり、カスタマイズ可能です。
- 第三者のアプリケーションに即時通知を送信することができます。
- ユーザーは自分のカスタムアプリケーションまたは他の第三者アプリケーションと連携できます。
- リアルタイムのデータ同期が可能です。
- Webhookのリスト、失敗したWebhook、成功したWebhookを提供します。
Webhookのカテゴリー
- Webhook List: Zoho PeopleのWebhookを使用すると、ユーザーが組織 クラウンデータで操作を行うたびに即時に通知を送信し、第三者のアプリケーションと対話することができます。
- 失敗したWebhook: 失敗したWebhookは、Webhookの名前、フォーム名、関連データ、最後の呼び出し時間、再実行操作、応答メッセージなどの詳細とともにリストされます。また、フォーム、Webhookの名前、期間などの設定を使用してWebhookをフィルタリングすることもできます。
- 成功したWebhook: 成功したWebhookは、Webhookの名前、フォーム名、関連データ、最後の呼び出し時間、応答メッセージなどの詳細とともにリストされます。また、フォーム、Webhookの名前、期間などの設定を使用してWebhookをフィルタリングすることもできます。
API
Zoho Peopleは、HRタブを第三者のアプリケーションと統合するためのAPI(Application Programming Interface)を提供しています。Zoho People APIを使用すると、XMLまたはJSON形式の従業員データやフォームデータを抽出し、新たなアプリケーションを開発したり、既存の法人アプリケーションと連携することができます。Zoho People APIはプログラミング言語に依存しないため、Java、.NET、C、C++、PHPなどの任意のプログラミング言語でアプリケーションを開発することができます。
詳細については、ここをクリックしてください。
Webhookの項目
| 項目 名前 | 説明 | データの種類 | 最大 Limit |
| 名前 | Webhookの名前を指定する | テキスト | 英数字(50) |
| 説明 | Webhookの説明を追加する | テキスト | 250文字 |
| 通知先URL | サードパーティアプリケーションまたはZohoアプリケーション（例：Zoho People, Zoho Creator）のAPI URLを指定する | URL | 250文字 |
| メソッド | APIメソッドの種類- POSTまたはGETを選択する。POSTが初期設定の選択方法です | ラジオボタン | - |
| タブ | 'Form'差出人を選択し、データをサードパーティアプリケーションに伝える | ピッキングリスト | - |
| 項目パラメータを追加する | Parameter名と対応するParameter値を指定します。これらは、Webhook通知をサードパーティアプリケーションにトリガーする際に送信されるリクエストパラメータです。 | 文字列 | 3000文字 |
| カスタムパラメータを追加 | Zoho PeopleのParameter名と対応する値をWebhookに指定する。これらもまたWebhookをトリガーする際に送信するリクエストパラメーターです。名前と値は設定した通りです。このキー/値のペアは主に、認証トークン、セキュリティトークンなどを送信するために使用します。 | 文字列 | - |
| URLをプレビューする | サードパーティーアプリケーションに知らせるための完了Webhook URLをプレビューする | テキスト | 読み取り専用 |
Zoho PeopleでWebhookを設定する
Webhookの設定は直感的で簡単です。HTTPのURLを設定し、それをワークフロールールと関連付けることでワークフロープロセスを自動化するだけです。下記の手順に従ってサービスのWebhookを設定してください。
- ホームページより、設定 > サービスを選択 > 自動化 > 処理 > Webhookへ移動します。
- Webhookを追加をクリックします。
- Webhookの設定ページで、以下のように設定します：
- Webhookがイベントの変更を監視する形式をサービス内から選択します。
- Webhookの名前を提供します。
- 通知すべきサードパーティーのURLを指定します。
- Webhookの目的（説明）を入力します。
- POSTまたはGETのどちらかをAPIメソッドとして選択します。これはあなたのニーズに基づきます。
-
必要なクエリパラメータを定義します：
パラメータ名と対応する値を指定します。最大10項目をパラメータとしてユーザー定義の形式（例：XML、JSON等）で追加できます。カスタムパラメータの名前と値を指定します。最大5つのカスタムパラメータを追加できます。
-
保存をクリックします。
Webhookは保存され、ワークフローにタグ付けする準備ができます。
ワークフローにWebhookをマッピングする方法
Webhookをトリガーする処理があるワークフローを作成し、そのWebhookをワークフローに関連付けます。
Webhookをワークフローにマップするには、次の手順に従ってください：
- あなたのホームページから、設定 > サービスを選択 > ワークフロー > ワークフローを追加に移動します。
- 必要なすべての詳細を提供します。ワークフローの設定についての詳細はこちら。
- 処理の下で、Webhookをクリックし、（+）追加アイコンをクリックして、ワークフローに新しいWebhookを追加するか、フォームのために作成された既存のWebhookを選択できます。
- 追加をクリックします。
ワークフローが作成され、トリガー処理に基づいて、Webhookが実行され、通知がサードパーティのアプリケーションに送信されます。
使用例
Webhookを通じて終了フォームの従業員ステータスを変更
このシナリオを考えてみてください - 従業員が退職して、従業員フォームのステータスを'Resigned'（退職）に変更したい。Webhookの導入前は、従業員フォームと終了フォームの両方で手動で変更を更新する必要がありました。現在では、APIを使用してWebhookを設定することで、自動的に終了フォームに通知をPOSTできます。このシナリオに対するWebhookの設定方法については、以下の手順に従ってください。
- 差出人 your homepage, navigate to 設定 > 選択する a サービス > 自動化 > 処理 > Webhookへ進んでください。
- Webhookを追加をクリックしてください。
- Webhook設定ページで、以下のように設定してください：
- リストから従業員フォームを選択してください。
- Webhookの名称を提供してください。
-
第三者のURLを指定して通知してください。
-
説明を入力してください。
-
APIメソッドの種類をPOSTとして選択してください。
-
以下の通りURLクエリパラメータを入力してください。
ユーザー定義形式の場合： パラメータ名を'xmlData'とし、値を以下の説明の通りに設定してください。
<データ><項目名='Employee_ID'>${ZOHO_LINK_ID}<項目名='Interviewer'>${Reporting_To}<項目名='Separation_date'>${Exit_Date}
上記のXML文字列では、'項目'タグがZoho Peopleの項目を、'名前'が項目のラベル名を、'値'タグがプッシュするデータを表します。 -
カスタムパラメータを指定する：パラメータ名に'authtoken'、パラメータ値にauthtokenキーを入力してください。
APIを使用するには、Zoho PeopleのアカウントからZoho Peopleの認証トークンが必要になります。Zoho People APIガイドはここをクリックしてください。 - 保存をクリックしてください。
このWebhookをワークフローにマップし、トリガー処理を定義してください。
Zoho CRM 管理者向けトレーニング
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho WorkDrive Resources
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
Related Articles
Zoho People for Office 365
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Office 365用のZoho Peopleアプリをインストールする 2つのアプリケーション間でデータをシームレスに同期するために、Microsoft Office 365用のZoho Peopleアプリをインストールします。 Office 365用のZoho ...Zoho People for G Suite
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho PeopleとG Suiteの間の同期は、2つのシステム間でスムーズなデータフローを実現します。G SuiteからZoho Peopleアプリをインストールすることで、G SuiteユーザーはZoho Peopleにアクセスできます。 可能性のあるシナリオは2つあります： ...Zoho People 5.0の設定
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 設定機能では何ができますか？ 設定では、組織のHRプロセスを管理するためにZoho Peopleを設定することができます。これには以下が含まれます： Zoho ...Zoho People ホームタブ
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho Peopleのホームタブとは何ですか？ Zoho ...Zoho PeopleとのZoho Cliq統合
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 はじめに この統合の目的は、Zoho PeopleとZoho Cliqをスムーズに接続することです。これは、部署、役割、出席状況、座席情報などの従業員データをZoho Cliqでアクセス可能にし、Zoho Peopleからの承認通知をZoho ...