会話

POST /v1/chat

{
  "message": "有没有 400 美元以内的潜水表？",
  "conversation_id": null,
  "user": {"id": "u_123", "name": "李四", "email": "li@example.com", "ip": "85.214.132.117", "language": null},
  "stream": false
}

• conversation_id を渡さない場合は新しい会話が作成され、レスポンスで返されます。以降のメッセージではそれを含めてください。
• user はあなたのサーバーから直接送信してください（API Key の呼び出し元は信頼できるため）。含まれている場合にのみ注文を照会できます。
• デフォルトの返信言語：user.language（例：de、zh-CN、pt-BR）を渡すとその言語を使用します。そうでなければ user.ip を渡すと、所在地から判断します。どちらも渡さない場合は管理画面のデフォルト言語を使用します。お客様が会話内で言語の変更を希望した場合は、お客様の希望を優先します。
• stream: false の場合は {"conversation_id", "message", "status", "products"} を返します。message が null の場合は、会話が有人対応中で、メッセージが有人対応に引き継がれていることを示します。
• stream: true の場合は SSE を返します。イベントは以下の表を参照してください。

その他の API

会話ステータス：ai（AI が回答）、pending_human（有人対応待ち）、human（有人対応中）、closed（終了済み）。

会話には次の項目もあります：closed_by は誰が終了したか（customer お客様、agent サポート担当者、ai お客様が他に問題がないと示した後に AI が終了）、rating / rating_comment / rated_at はお客様の評価。

会話の終了：Web ウィンドウの上部に「会話を終了」ボタンがあります（二段階確認）。WeChat ミニプログラムでは、お客様が「終了」と送信しても終了します。「ボット設定」で「AI が自動で会話を終了」をオンにしている場合、お客様が他に問題がないことを明確に示すと、AI が別れの挨拶をした後に会話を終了します。終了後、Web ウィンドウではお客様に「満足 / 不満」の評価とメッセージの入力をお願いし、WeChat ではお客様に 1 または 2 の返信をお願いします。その後にお客様がメッセージを送ると新しい会話になります。

有人対応への切り替え後の割り当て：「ボット設定」で割り当て方法を選択します——担当している会話が最も少ないサポート担当者への割り当て（デフォルト）、順番に割り当て、またはサポート担当者が自分で受ける、から選べます。自動割り当ては「オンライン」を選択し、かつ管理画面を開いているサポート担当者にのみ行われ、1 人あたりの同時対応上限があります（「チーム」ページで設定）。割り当てられた担当者が設定時間（デフォルト 2 分）を超えても返信しない場合は、割り当て先を変更します。会話内の assigned_member_id は割り当てられたサポート担当者、assigned_at は割り当て時間、handoff_at は有人対応への切り替え時間です。全員が上限に達している場合、お客様は待機列に並び、Web ウィンドウには前に何人いるかが表示されます。

営業時間とメッセージ：「ボット設定」で営業時間をオンにすると、営業時間外にお客様が有人対応へ切り替えても待機列には並ばず、Web ウィンドウにメッセージフォーム（お名前、メールアドレスまたは電話番号、質問内容）が表示されます。WeChat とオープン API の会話では、AI がお客様にメッセージを残すよう案内します。営業時間内でもサポート担当者がオンラインでない場合も同様です。メッセージからチケットが生成され、サポート担当者が返信すると、元の会話がまだ終了していなければ会話内に送信されます。お客様がメールアドレスを残している場合は、店舗名義でメールも送信されます。あなたのシステムへのみプッシュする場合（有人対応への切り替え方法で「自分のシステムにプッシュ」を選択）は、営業時間は考慮されません。