Zoho Writerで受信Webhookをデータソースとして使用する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
概要
Zoho Writerは、受信Webhookをデータ元としてサードパーティアプリ（Fillout、Shopify、またはカスタムアプリなど）から直接項目値を受け取り、ドキュメント生成に利用できます。データを他の場所に保存する必要はありません。これにより、Webhookペイロードを送信できる任意のアプリからリアルタイムでデータを取得し、即座にドキュメントへ反映できます。
前提条件
- 外部アプリでWebhookが有効になっていること
- 対応データ形式
- JSON
- フォームデータ
- URLエンコードデータ
- ドット記法（例：顧客.名前）
- アンダースコア記法（例：customer_name）
- 配列（単一または複数データ）
手順
受信Webhookをデータ元として設定する方法
- Zoho Writerでマージテンプレートを開きます。
- 自動化ペインの「データ元を選択」で、「+データ元を追加」をクリックして開始します。
- 「受信Webhook」を選択します。
- 「受信Webhookから項目を取得」ダイアログが表示されます。
- 「項目を取得」（または以前に取得済みの場合は「項目を更新」）をクリックします。
- WriterがWebhookデータから受信したすべてのキーを「外部アプリからの項目」として一覧表示します。
- マージで使用したい項目を選択します。
- 「インポート」をクリックします。
メモ: このダイアログが完了するまで、選択したWebhook URLを使用して受信Webhook処理でマージを開始できません。
データでマージをトリガーする方法
- 作成した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 WriterのマージテンプレートのWebhook URL。Webhook URLの生成方法はこちらをご参照ください。
手順
- ドキュメント生成を追加したい既存の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を選択した場合は、項目の取得のみに使用され、設定パネルのデータ元としては表示されません。データ元として表示されるのは、主に選択された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での引用と参考文献の追加方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Zoho Writer では、研究論文や卒業論文を作成する際に参照した資料を一覧にするための引用と参考文献リストを追加できます。引用のコピー、編集、削除も行えます。 Zoho Writer で利用できる引用スタイル APA（第7版） MLA（第8版） ...Zoho Writerで画像を挿入する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 画像はコンテンツを視覚的に強化し、アイデアをより効果的に伝えるのに役立ちます。Zoho Writer では、デバイス、オンラインライブラリ、接続済みサービスなど、複数のソースから画像を挿入できます。 前提条件 画像を使用する権利またはライセンスを保有していることを確認します。 ...Zoho ChemStudio拡張機能で化学構造式を挿入する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Zoho Writer で Zoho ChemStudio 拡張機能を使用すると、ChemStudio で作成した化学構造式を画像としてドキュメントに直接挿入できます。これにより、ツールを切り替えることなく、プロフェッショナルなドキュメントを作成できます。 前提条件 Zoho ...Zoho Writerでの画像の配置方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 配置コントロールを使うと、画像をテキストと同じ行に配置したり、ページ上で浮かせて配置したりと、思いどおりの位置に置くことができます。あらかじめ用意されたプリセットや詳細なカスタム設定を使用して、画像をページ、余白、段、または段落に対して揃えることができます。 手順 ...Zoho Writerで記入可能なフォームを共有する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Zoho Writer では、入力可能フォームを Zoho ユーザーと Zoho 以外のユーザーの両方と共有できます。アクセス権限の設定、パスワード保護の有効化、有効期限の設定、必要に応じたアクセスの取り消しによって、受信者のフォームへの操作方法を制御できます。 前提条件 ...