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

概要

前提条件

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 URLを使用して受信Webhookの操作から差し込みを開始することはできません。
   

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

よくある質問

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

トラブルシューティング

関連記事

1. 受信Webhookを使用して差し込みを実行する方法
   
2. 項目の種類の設定による差し込み項目の表示制御
   
3. Writerの差し込み文書におけるデータ元と上限の管理