POST/api/global-chatbot/demo/poll

デモチャットセッションの新しい非同期で到着したメッセージを照会する（例：マスターAdminで人間のエージェントが引き継いだ場合）— ウィジェットから定期的に呼び出されます。

`POST /api/global-chatbot/demo/poll` は、既存のデモセッションに対する新しいメッセージやステータス変更をポーリングします。リクエストボディには `session_id` と `visitor_id` が含まれます。両方の値は、同じ公開デモ会話から取得したものである必要があります。いずれかのパラメータが欠けている場合、サーバーは `400 PARAMS_REQUIRED` で応答します。 このルートエンドポイントにはユーザー認証は不要で、デモセッションの現在の状態を読み取ります。これは、応答が前のリクエストに対して即時に返ってこない場合や、UI が後から到着したメッセージを表示する必要がある場合に使用されます。ポーリングはメッセージ送信の代替手段ではなく、それ自体が新しい訪問者リクエストを生成することはありません。 クライアントは呼び出しの間に適切な間隔を空ける必要があります。狭い間隔での無限ループは負荷を増大させ、レスポンスの取得を速めることなくレート制限を引き起こす可能性があります。セッションが終了、無効化、または検出不能になった場合、ポーリングを停止し、UI が新しい開始を提案する必要があります。ページが閉じられたり、非表示のタブになったりした場合、永続的なバックグラウンドリクエストが残らないようにしてください。 `session_id` と `visitor_id` は、他の会話に対する一般的な認証情報ではありません。これらは訪問者間で共有してはならず、メッセージと一緒に公開分析ツールに送信してはいけません。デモはテナントの会話や本番環境のインボックスデータから分離されています。 正しいテストでは、デモセッションを開始し、メッセージを送信した後に、同じ識別子を使用してポーリングを呼び出します。さらに、`visitor_id` がないリクエストも検証されます。文書化されたネガティブテストはエラーの証明であり、完全な本番会話が正常に完了したことを示すものではありません。

{"session_id":"<UUID>","visitor_id":"<UUID>"}

{"ok":true,"data":{"messages":[]}}