Webhookブロックにおけるリクエストタイムアウト

Webhookブロックにおけるリクエストタイムアウト

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


チャットボットが外部サービスと接続する際、Webhookブロックを使用してそのサービスのAPIにリクエストを送信します。では、そのサービスからの応答に時間がかかる場合、チャットボットはどうすべきでしょうか?ずっと待ち続けますか?それとも早くあきらめてしまいますか?

これこそが、Webhookブロック内のリクエストタイムアウト設定が管理する内容です。

この設定により、Webhookが応答を待つ時間をどれだけにするかを決められます。適切に設定することで、外部システムが遅かったり応答しない場合でも、チャットボットのスピードや応答性、ユーザーフレンドリーさを維持できます。


Webhookの詳細はこちら:GCのWebhookブロック紹介 

リクエストタイムアウトとは

リクエストタイムアウトは、Webhookブロック内の設定で、呼び出したAPIからの応答をチャットボットが何秒待つかを決めます。制限時間内に応答が受領できない場合、リクエストは自動的に停止またはタイムアウトします。

このタイムアウト設定がないと、外部APIの遅延時にチャットボットが固まったり、遅くなったり、不安定に感じられることがあります。

動作の仕組み

Webhookブロック内で、タイムアウト期間を設定するオプションがあります。設定可能な範囲は5秒から40秒までです。
適切なタイムアウト値を決めるポイントは次の通りです。
  1. 応答が速く信頼できるAPIには短め(5~10秒)を設定しましょう。例えば、顧客データベースの照会などは通常すぐに応答します。
  2. 遅いAPIの場合は長め(最大40秒)に設定します。たとえば、レポート生成やレガシーシステムからの請求ステータス確認などのバックグラウンド処理を実行する場合です。
設定した時間が経過してもAPIから応答がない場合、リクエストはキャンセルされ、Webhookの処理は失敗と見なされます。このようなタイムアウト時のシナリオにはMultipathを利用し、お詫びメッセージを表示したり、「もう一度試す」ボタンを用意したり、有人エージェントへエスカレーションすることが可能です。
 

リクエストタイムアウトが重要な理由

リクエストタイムアウトの設定は単なる技術的な詳細ではなく、全体的な顧客体験を向上させるためのものです。
その理由は以下の通りです。
  1. 会話の応答性を維持できる。
  2. ボットが長く待ちすぎると、ユーザーが故障や無視されていると感じてしまいます。タイムアウト設定により、ユーザーを待たせ続けることがありません。
  3. リソースの無駄遣いを防げる。
  4. コントロールできる。
  5. 外部システムの信頼性に応じて、ボットがどれだけ待つかを選択できます。
  6. フォールバック経路を実現できる。
  7. タイムアウトが発生した場合でも、会話を適切に誘導可能です。例えば「少し時間がかかったようです。もう一度試しましょうか?」など。

例 使用する Case
例 使用する Case
例えば、Webhookブロックが順番管理システムを呼び出して、最近の購入のステータスを確認するとします。
APIの通常の応答が2秒であれば、タイムアウトを7秒に設定し、余裕を持たせつつも長すぎない設定が可能です。
 
現在:
  1. 応答が7秒以内にあれば、ボットは順番ステータスを表示します。
  2. 7秒以内に応答がない場合、リクエストはタイムアウトとなり、ボットは以下のメッセージを表示できます。
  3. 「申し訳ありません。予想より時間がかかっています。次のご希望は? もう一度試す または 担当者と話す」
ユーザーに状況を伝えることで、フラストレーションを防ぎ、プロフェッショナルな対応が可能となります。

リクエストタイムアウト設定のベストプラクティス


  1. 初期設定のまま移動せず、Webhookが呼び出すシステムの特性を考慮しましょう。
  2. 開発者やバックエンドチームと相談し、平均的な応答時間を把握してください。
  3. 不明な場合はまず10~15秒で開始し、実際の運用やフィードバックに基づいて調整しましょう。
  4. Multipathと組み合わせることでタイムアウト(例:504決済サービスTimeout応答)にも柔軟に対応できます。


Technical メモ:
Technical メモ:
  1. Webhookブロックでは、URLとConnection項目が必須です。リクエストの送信先や認証方法を定義します。
  2. ヘッダー、Queryパラメーター、Request本文などのオプション項目は、呼び出すAPIによって必要となる場合のみ使用してください。
Webhookの詳細はこちら: GCにおけるWebhookブロックの紹介 

    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



              Zoho Campaigns Resources

                Zoho WorkDrive Resources




                  • Desk Community Learning Series


                  • Digest


                  • Functions


                  • Meetups


                  • Kbase


                  • Resources


                  • Glossary


                  • Desk Marketplace


                  • MVP Corner


                  • Word of the Day


                  • Ask the Experts









                                  Resources

                                  Videos

                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                  eBooks

                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                  Webinars

                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                  CRM Tips

                                  Make the most of Zoho CRM with these useful tips.