会話

会話履歴の取得を要求

provider=whatsapp の個人チャットのみで過去の履歴を要求します。whatsapp-protocol は対象外です。account_id は空白やスラッシュ（エンコードされたものを含む）のない単一の空でないパス区間である必要があり、不正な場合は 400 invalid_request です。先に conversation.history を購読してください。利用可能なバッチは data.history.source=on_demand を伴って非同期に届きます。HTTP 202 と status=accepted は受理のみを示し、メッセージの受信や完了を意味しません。request_id は HTTP の調査用で、タスク ID やコールバックの関連付けには使えません。バッチは複数、重複、遅延する場合も、届かない場合もあります。続けて取得するには、受信済みのネイティブコンテンツメッセージのうち id、sent_at、direction が揃った最も古いものを before に使います。合成された type=call の記録を除外し、before に type を追加しないでください。次ページのカーソルや完了状態はありません。空のバッチ、limit 未満の件数、タイムアウトは履歴の終端を意味しません。HTTP タイムアウト後もコールバックが届く可能性があるため、自動再試行はしないでください。400 は invalid_request、provider_invalid_request（合成通話をアンカーにした場合を含む）、グループやチャンネルでは unsupported_conversation_type を返します。他のプロバイダーは 501 unsupported_by_provider です。有効なパスでもアカウントが存在しないか現在のワークスペース外なら 404 account_not_found（numeric_code=20020）、未分類の内部エラーは 500 request_conversation_history_failed（numeric_code=37016）です。