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

概要

前提条件

1. 外部アプリでWebhookが有効になっていること
   
2. 対応しているペイロード形式
1. JSON
   
2. フォームデータ
   
3. URLエンコードデータ
   
1. ドット表記（例：customer.name）
   
2. アンダースコア表記（例：customer_name）
   
4. 配列（単一または複数のデータ）
   

手順

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

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

メモ

1. このダイアログを閉じるまで、受信Webhookアクションは、選択したWebhook URLを使用して差し込み処理を開始できません。
   

2. Webhookペイロードを通じて受信したサブフォーム項目は、サブフォーム項目としてではなく、メインの項目リスト内の通常の差し込み項目としてインポートされます。

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

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

6. Webhookを一度実行してサンプルデータを送信します。Zoho Writerがキーを検出し、項目のインポート用に一覧表示します。
   

マッピングの問題を回避するには、今後のWebhook送信が、ペイロードコードセクションに示されている同じペイロード形式に従っていることを確認してください。

新しい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. データが正常に送信され、文書が生成されることを確認するため、アクションを保存してテストします。
   

FAQ

1. Webhookペイロードで差し込みを自動的に開始できますか？
   このフローではできません。Webhook呼び出しを通じて差し込みを自動的に実行する方法については、このページを参照してください。
   
   
2. 選択した項目だけをインポートできますか？
   はい。ダイアログで選択した項目のみが差し込み設定に追加されます。
   
   
3. 同じWebhook URLまたは別のWebhook URLから、後で追加の項目をインポートできますか？
   はい。データソースとして受信Webhookを選択した後、いつでも［項目をインポート］をクリックして追加の項目を取得できます。次のいずれかを使用できます。
1. 同じWebhook URL、または
   
2. 別のWebhook URL
   インポート時に別のWebhook URLを選択した場合、そのURLは項目の取得にのみ使用され、設定パネルにはデータソースとして表示されません。データソースとして表示されるのは、最初に選択したWebhookのみです。

トラブルシューティング

関連記事

1. 受信Webhookを使用して差し込みを実行する方法
   
2. 項目タイプ設定による差し込み項目の表示制御
   
3. Writerの差し込み機能におけるデータソースとその制限の管理