Zoho Writerで受信Webhookをデータ元対象:使用する方法

Zoho Writerで受信Webhookをデータ元対象:使用する方法

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

AIに解説を依頼:ChatGPT| Perplexity| Claude

概要

Zoho Writerでは、受信Webhookをデータ元として使用できます。Fillout、Shopify、カスタムアプリなどの外部アプリから項目の値を直接受信し、別の場所にデータを保存することなく文書の作成に使用できます。Webhookペイロードを送信できるアプリであれば、リアルタイムでデータを取得し、文書にすぐに反映することができます。

前提条件

  1. 外部アプリでWebhookが有効になっていること
  2. 対応するペイロードの書式
    1. JSON
    2. フォームデータ
    3. URLエンコードされたデータ
      1. ドット表記(例:customer.name)
      2. アンダースコア表記(例:customer_name)
    4. 配列(1件または複数件のデータ)

手順

受信Webhookをデータ元として設定する方法

  1. Zoho Writerで差し込み文書テンプレートを開きます。
  2. [自動化]パネルの[データ元の選択]で、[+ データ元を追加]をクリックして開始します。
  3. [受信Webhook]を選択します。
  4. [受信Webhookから項目を取得]ダイアログが開きます。
  5. [項目を取得]をクリックします(すでに項目を取得している場合は[項目を更新])。
  6. Webhookペイロードから受信したすべてのキーが、Writerの[外部アプリの項目]に一覧表示されます。
  7. 差し込みに使用する項目を選択します。
  8. [インポート]をクリックします。


メモ
メモ
  1. このダイアログを閉じるまで、選択したWebhook URLを使用する受信Webhookの操作では、差し込みを開始できません。
  2. Webhookペイロードで受信したセット項目は、セット項目としてではなく、メイン項目の一覧に通常の差し込み項目としてインポートされます。

ペイロードで差し込みを実行する方法

  1. 生成されたWebhook URLをコピーします。
  2. 外部アプリのWebhook/APIの送信先項目に貼り付けます。
  3. 外部アプリから、[使用するペイロードコード]セクションに表示されている書式で項目の値を送信します。
  4. JSONを選択した場合は、表示されているJSON構造で値を渡します。
  5. フォームデータ/URLエンコードを選択した場合は、表に表示されている項目IDを使用して値を渡します。

  6. Webhookを一度実行してサンプルデータを送信します。Zoho Writerがキーを検出し、インポートできる項目として一覧表示します。
情報
  1. 関連付けの問題を避けるため、以降のWebhookの送信では、同じペイロードの書式を使用し、[ペイロードコード]セクションの表示に合わせてください。
  2. CRM、People、Recruitなどの連携テンプレートに渡すペイロードには、`<record_id>`を値とする「id」キーが必須です。

新規Webhook URLを作成する方法

  1. Zoho Writerで差し込み文書テンプレートを開きます。
  2. [自動化]パネルの[データ元の選択]で、[+ データ元を追加]をクリックして開始します。
  3. [受信Webhook]を選択します。
  4. [受信Webhookから項目を取得]ダイアログが開きます。
  5. [受信Webhook URLの選択]で、[新規Webhook URLを作成]を選択します。
  6. 次の詳細を入力します:
    1. Webhookの名前(必須)
    2. 説明(任意)
  7. [作成してコピーする]をクリックして、一意のWebhook URLを作成します。

このWebhook URLを、Zoho Writerに項目の値を送信する外部アプリに貼り付けることができます。

メモメモ
アプリやワークフローに応じて複数のWebhook URLを作成できます。後でドロップダウンから必要なURLを選択できます。

既存のZoho FlowまたはZapierのワークフローに文書の作成を追加する方法

前提条件

  1. Zoho Writerの差し込み文書テンプレートのWebhook URL。Webhook URLの作成手順はこちらをご参照ください。

手順

  1. 文書の作成を追加する、既存のZoho FlowまたはZapierのワークフローを開きます。
  2. 文書を作成する位置(差し込みデータを提供するカードの隣)に、Webhookの操作カードを挿入します。
  3. Webhookの操作を設定します:
    1. 操作イベント:POSTメソッドを選択します。
    2. Zoho WriterのテンプレートのWebhook URLを貼り付け、フローまたはZapの前の手順にある必要なデータ項目をWebhookのペイロードに関連付けます。ペイロード内のキーが、Writerの差し込み文書テンプレートの差し込み項目と完全に一致していることを確認します。
  4. 操作を保存してテストし、データが正常に送信され、文書が作成されることを確認します。

よくある質問

  1. Webhookペイロードで差し込みを自動的に開始できますか?
    このフローではできません。Webhookの呼び出しで差し込みを自動的に実行するには、こちらのページをご参照ください。

  2. 選択した項目だけをインポートできますか?
    はい。ダイアログで選択した項目だけが差し込みの設定に追加されます。

  3. 後で同じWebhook URLや別のWebhook URLから項目を追加でインポートできますか?
    はい。受信Webhookをデータ元として選択した後、いつでも[項目をインポートする]をクリックして項目を追加で取得できます。使用できるURLは次のとおりです:
    1. 同じWebhook URL、または
    2. 別のWebhook URL
      インポート時に別のWebhook URLを選択した場合、そのURLは項目の取得にのみ使用され、設定パネルにデータ元として表示されることはありません。データ元として表示されるのは、メインで選択したWebhookのみです。

トラブルシューティング

症状
考えられる原因
推奨される解決策
[項目を取得]をクリックしても項目が表示されない
ペイロードを受信していない
外部アプリからテストイベントを実行します。
想定していた項目の一部が表示されない
ペイロードに入れ子のキー、または名前が変更されたキーが含まれている
ペイロードを再送信し、[項目を更新]をクリックします。
差し込み時に項目が空白になる
関連付けが完了していない
[項目を管理する]セクションを確認し、再度関連付けます。
外部アプリでWebhookが拒否される
要求の種類が正しくない
アプリがHTTP POSTでペイロードを送信していることを確認します。
  1. 受信Webhookを使用して差し込みを実行する方法
  2. 項目の種類の設定による差し込み項目の表示の制御
  3. Writerの差し込み文書におけるデータ元とその上限の管理