Zoho Writerで受信Webhookをデータソースとして使用する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
概要
Zoho Writerは、受信Webhookをデータ元としてサポートしており、Fillout、Shopify、またはカスタムアプリなどのサードパーティアプリから直接項目値を受領し、データを他の場所に保存することなくドキュメント生成に利用できます。これにより、Webhookペイロードを送信できる任意のアプリからリアルタイムでデータを取得し、即座にドキュメントへ反映することが可能です。
前提条件
- 外部アプリでWebhookが有効になっていること
- 対応データ内容フォーマット
- JSON
- フォームデータ
- URLエンコードデータ
- ドット記法（例：顧客.名前）
- アンダースコア記法（例：customer_name）
- 配列（単一または複数データ）
手順
受信Webhookをデータ元として設定する方法
- Zoho Writerでマージテンプレートを開きます。
- 自動化ペインの「データ元を選択」セクションで、+追加をクリックしてデータ元の追加を開始します。
- 受信Webhookを選択します。
- 受信Webhookから項目を取得するダイアログが開きます。
- 「項目を取得」をクリックします（以前に項目を取得済みの場合は「項目を更新」）。
- WriterはWebhookデータから受領したすべてのキーを外部アプリの項目として一覧表示します。
- マージで使用したい項目を選択します。
- 「インポート」をクリックします。
メモ: このダイアログが完了するまで、受信Webhook処理は選択したWebhook URLを使用してマージを開始できません。
データ内容でマージをトリガーする方法
- 作成済みWebhook URLをコピーします。
- 外部アプリケーションのWebhook / API送信先項目に貼り付けます。
- 外部アプリで、「データ内容コードの使用方法」セクションに表示されているのと同じ形式で項目値を送信します。
- JSONを選択した場合は、表示されているJSON構造で値を渡します。
-
フォームデータ / URLエンコードを選択した場合は、表に表示されているのと同じ項目IDを使って値を渡します。
- Webhookを一度トリガーしてサンプルデータを送信します。Zoho Writerがキーを検出し、項目インポート用に一覧表示します。
メモ: マッピングの問題を回避するため、今後のWebhook送信は「データ内容コード」セクションに表示されている同じデータ内容形式に従ってください。
新規Webhook URLを生成する方法
- Zoho Writerでマージテンプレートを開きます。
- 自動化パネルの「データ元を選択」セクションで、「+ データ元を追加」をクリックして開始します。
- 「受信Webhook」を選択します。
- 「受信Webhookから項目を取得」ダイアログが開きます。
- 「受信Webhook URLを選択」で「新規Webhook URLを生成」を選択します。
- 以下の詳細を入力します：
- Webhook名（必須）
- 説明（任意）
- 作成 & コピーをクリックして、ユニークなWebhook URLを生成します。
このWebhook URLを、項目の値をZoho Writerに送信する外部アプリケーションに貼り付けることができます。
メモ: 複数のWebhook URLを異なるアプリやワークフロー用に生成することができ、必要に応じて後からドロップダウンから選択できます。
既存のZoho FlowまたはZapierワークフローにドキュメント生成を追加する方法
- ドキュメント生成を追加したい既存のZoho FlowまたはZapierワークフローを開きます。
- ドキュメント生成を行いたい箇所（マージデータを提供するカードの隣）にWebhook操作カードを挿入します。
- Webhook操作を設定します：
- 操作イベント：POSTメソッドを選択
- Zoho WriterテンプレートのWebhook URLを貼り付け、必要なデータ項目をフローやZapの前段階からWebhookのデータ内容にマッピングします。データ内容のキーがWriterのマージテンプレートのマージ項目と完全に一致していることを確認してください。
- 操作を保存し、テストしてデータが正常に送信され、ドキュメントが作成されることを確認します。
よくある質問（FAQ）
- Webhookのデータ内容でマージを自動的に開始できますか？
このフローではできません。Webhookコールで自動的にマージをトリガーする場合は、こちらのページをご参照ください。 - 選択済み項目のみをインポートできますか？
はい。ダイアログで選択済みの項目のみがマージ設定に追加されます。 - 同じまたは別のWebhook URLから後で追加項目をインポートできますか？
はい。受信Webhookをデータ元として選択した後は、いつでも「項目をインポート」をクリックして追加項目を取得できます。利用方法は以下の通りです： - 同じWebhook URLを使用
- 別のWebhook URLを使用
インポート時に別のWebhook URLを選択した場合、そのURLは項目の取得のみに使用され、設定パネルのデータ元としては表示されません。データ元として表示されるのは、主に選択したWebhookのみです。
トラブルシューティング
|
症状
|
考えられる原因
|
推奨される解決策
|
|
項目が「取得する項目」をクリックした後に表示されない
|
データの内容が受信されていない
|
外部アプリケーションからテストイベントをトリガーしてください
|
|
一部の期待される項目が表示されない
|
データの内容に入れ子や名前変更されたキーが含まれている
|
データの内容を再度トリガーし、「更新する項目」をクリックしてください
|
|
マージ時に項目が空白で表示される
|
マッピングが完了していない
|
管理項目セクションを確認し、再マッピングしてください
|
|
外部アプリでWebhookが却下された
|
リクエストの種類が誤っている
|
アプリがHTTP POSTでデータの内容を送信していることを確認してください
|
関連記事
Zoho CRM 管理者向けトレーニング
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho Campaigns Resources
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 WriterのためのGDPR
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho WriterにおけるGDPRポリシーについての詳細は、こちらのリンクをご参照ください。Zoho WriterにおけるAI
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zia は、Zoho Writer の AI 搭載ライティングアシスタントであり、さまざまな種類のドキュメントの作成、コンテンツ品質の向上、ドキュメント内容の整合性保護などの機能を備えています。 Zoho Writer における AI 機能の概要は以下のとおりです。 機能 説明 ...Zoho WriterとZoho CRMを接続する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho CRMタブのエントリに対してWriterで新規メールマージドキュメントを作成する Zoho Flowは、クラウドアプリを連携させて業務プロセスを自動化するワークフローを作成できるプラットフォームです。アプリ同士でデータを共有し、自動的に処理が実行されます。 ...Zoho WriterによるHIPAA準拠
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 序章 健康保険の可搬性と説明責任に関する法律で、プライバシールール、セキュリティルール、Breach通知ルール、および健康情報技術の経済的および臨床的健康法（総称して「HIPAA」と称します）は、Covered ...Zoho Writer における暗号化
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 暗号化は、メッセージの内容を保護し、意図した受信者のみがそれを解読できるようにすることを主な目的としています。これは、内容を意図した受信者にのみ解釈可能な特定できないデータに置き換えることで達成されます。この方法で暗号化は、潜在的な盗難からデータを保護します。 ...