受信Webhook
概要
受信Webhookの利用開始にあたって
受信Webhookの主な機能
機能 | 説明 |
設定 | 受信Webhookは、Zoho Connectのグループでのみ利用可能です（ネットワークの掲示板や自分のフィードでは利用できません）。 |
対応アプリ | HTTPSを通じてPOSTリクエストを送信できるアプリであれば、受信Webhookを通じてZoho Connectにメッセージを送信可能です。 |
マークダウン（書式設定の記法） 対応 | |
添付ファイル | 1件の投稿に10件までファイルを追加できます。ファイルごとのサイズの上限は、10MBです。 |
受信Webhookによる連携機能を利用できるユーザー
メンバーが作成できるWebhookの上限は、20件です。 管理者が受信Webhookの連携を許可／制限する方法
- ページの右側のメニューの上部に表示されているコンセントのアイコン（［連携］）
をクリックします。
- 表示されたページで左側のメニューから［管理］をクリックします。
- 連携の一覧から［受信Webhook］に移動し、［受信Webhook］の右に表示されている［承認する］／［制限する］をクリックします。
ネットワーク管理者が連携を制限すると、ネットワークのメンバーは、新しいWebhookを設定したり、既存のWebhookを利用したりできなくなります。ページの右側のメニューの上部に表示されているコンセントのアイコン（［連携］）
をクリックします。
連携機能の一覧のページで、［受信Webhook］の項目まで画面をスクロールします。
［設定する］をクリックします。
メッセージの投稿先のグループを選択します。
Webhook名を入力し、必要に応じて、アイコン用の画像をアップロードします。
［保存する］をクリックします。
［カスタム関数］の下に追加された［WebhookのURL］の項目で、受信Webhook用のURLが確認できます。別のアプリからのメッセージは、このURLに対して送信されます。このURLは、受信Webhookの設定において選択したグループに専用のアドレスです。
WebhookのURLをクリップボードにコピーして、POSTリクエストの送信先として利用できるよう保管しておきます。
受信Webhookを利用してメッセージを投稿する方法
Content-type: application/x-www-form-urlencoded
payload-{"message":"<b>Service Request</b><br><br> Your service request has been approved.Kindly contact your administrator to proceed further"}
受信Webhookにより作成されたPOSTリクエストに対する応答（レスポンス）の番号
- {"status":"success","id":"unique id of post/comment created"}
- {"status":"failure","errorCode": "EXTRA_KEY_FOUND","reason":"Extra key found in the JSON parameter payload"}
受信Webhookにおけるカスタム関数
ページの右側のメニューの上部に表示されているコンセントのアイコン（［連携］）をクリックします。
連携機能の一覧のページで、［受信Webhook］の項目まで画面をスクロールします。
［設定する］をクリックして新しいWebhookを設定するか、既存の設定を開きます。
カスタム関数の項目に移動して、［関数を作成する］をクリックします。
表示された画面でコードを入力します。
コードの入力が完了したら、編集画面を閉じて、［保存する］をクリックします。
- params - Map（リクエストで送信されるすべてのパラメーターのキーと値のペア）
- headers - Map（リクエストのすべてのヘッダーのキーと値のペア）
- body - テキスト／文字列（リクエストの本文に記載される内容）
- network - Map（現在のネットワークの詳細についてのキーと値のペア）
- { "createdBy":{"name":"mark","emailId":"mark@zillum.com", "id":"142283" }, "domain":"zillum.com", "name":"zillum Network", "id":"22000000002002", "type":"2", //内部ネットワークの場合は2、外部ネットワークの場合は4を記入します "plan":"2",//無料プランは0、試用版は1、エンタープライズプランは2を記入します "url":"https://connect.zoho.com/portal/intranet" }
カスタム関数用の応答（レスポンス）のステータス番号
- { "customFunctionResponse": {"message": {"userMessage": []},"output": {"payload":{"message": "Testing Content","linkUrl": "https://connect.zoho.com/portal/intranet"}},"status": "success"},
"status": "success",
"id": "3000000577088" }
{ "customFunctionResponse": {"message": {"userMessage": []},"output": {"payload":{"message": "Testing Content","value":"Content for test"},"streamId":"3000000577088","messageType":"comment"},"status": "success"},
"status": "failure","errorCode": "1044","reason": "Extra key found in the JSON value" }
{ "customFunctionResponse": {"status": "failure"},
"status": "failure",
"errorCode": "1045",
"reason": "Unable to execute custom function" }
WebhookのURLを保護する方法
ページの右側のメニューの上部に表示されているコンセントのアイコン（［連携］）をクリックします。
［受信Webhook］の項目まで移動します。
URLをもう一度生成したいWebhookを開き、［WebhookのURL］の項目まで画面をスクロールします。
URLの右下に表示されている［もう一度生成する］をクリックします。
Zoho CRM 管理者向けトレーニング
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho コミュニティ オンラインフォーラム
フォーラムをフォローして、Zoho ユーザーによる活用のノウハウやアドバイスを入手。サービスのアップデート情報やユーザー向けイベントの告知について通知を受け取りましょう。
Related Articles
受信Webhookのメッセージ形式
概要 この記事には、受信Webhookのメッセージ形式（パラメーター名や値の指定方法）が記載されています。 受信Webhookの基本的な説明については、こちらをご参照ください。 対応しているパラメーター payload* - JSON messageType - status/event/comment （初期設定の値は「status」です。） streamId - Long commentId - Long attachment - file ...受信Webhookの高度なメッセージ形式
概要 受信Webhookでは、簡単な形式でテキストを投稿することもできますが、より高度な形式を利用することによって、カード、表、ラベル、箇条書き、画像などを含めた投稿を作成できます。 高度な形式を利用する場合、WebhookのURL宛てに送信するJSONのデータには、投稿内容のテキストの他に追加のパラメーターを含める必要があります。また、高度な形式は、コメントの投稿にも対応しています。 受信Webhookを利用してカード形式のメッセージを投稿する方法 ...