サポート API

ウェブサイトのお問い合わせフォーム用の、同一オリジンからの匿名JSON受付です。サイトのOriginヘッダーと、英字・数字・ハイフン・アンダースコアで構成される20～128文字のIdempotency-Keyが必要です。アカウントやセッションは作成しません。受領を通知する前にメッセージと返信先メールアドレスを保存し、サポート処理が設定済みのSlackサポートチャンネルへ送信します。

訪問者が入力したメールアドレスは連絡先情報であり、本人確認の証明にはなりません。同一内容の再試行には再配信せず同じ受領確認を返します。同じキーで本文を変更するとidempotency_mismatchになります。

新規メッセージはクライアントIPごとに毎時10件（IPv6は/64単位）、メールアドレスごとに1日3件、全体で毎時200件までです。すべてのリクエストにはIPごとに毎分120件の共通上限があります。Retry-Afterに従ってください。配信に失敗したメッセージは待機列に残り、配信済みレコードは30日後に期限切れになります。

アクティブなすべてのプロジェクトの可用性と時間。chat_allowed は Standard を含むすべてのアクティブなプロジェクトで true です。human_available は、リクエストに応じて担当者がチャットに参加できる場合に true です（Education、Premium、Enterprise）。Standard と Plus にはドキュメントと AI サポートがあります。staffed は、スタッフが現在対応時間内かどうかを示します。Luna はすべてのプランですぐに回答します。

プロジェクトの会話は最新順で最大100件です。スタッフの未読数は認証されたユーザーまたはエージェントごとにカウントされます。

すべてのプランで利用可能。Luna が最初にすぐ回答します。担当者が参加できる場合（サポートステータスの human_available）は、リクエストすると Luna が一時停止してスタッフが対応します。Standard と Plus では無視され、Luna が回答します。保存または Slack 送信前にスクリーニングされます。

8文字未満または3語未満の開始メッセージは submission_too_short を返します。質問や問題でないものは submission_unclear を返します。スパム、リンク過多のテキスト、プロンプトインジェクション、安全でないテキストは submission_rejected を返します。拒否されたテキストは保持されず Luna に送信されません。問題の詳細は繰り返し表示されません。

ScreenRig 資格情報以外の資格情報形式のテキスト（ベアラートークン、クラウドおよび API キー、秘密鍵）は保存前に [redacted] に置き換えられます。ScreenRig 資格情報は invalid_request を返します。新しい会話は1つの Slack スレッドで開始され、フォローアップはその中に残ります。同じキーのリクエストは24時間リプレイされます。拒否も含みます。

プロジェクト会話のメッセージ、昇順シーケンス、最大100件。古い会話のページネーションは最後のメッセージシーケンスの後に続きます。読み取りはスタッフの未読状態を認識しません。

オープンな会話に顧客メッセージを追加します。フォローアップは最小長がなく、単独で不明瞭として拒否されません（「ありがとう」「はい」）。安全性、プロンプトインジェクション、リンクスパムを検査し、submission_rejectedで拒否し、資格情報形テキストは新しい会話と同様に処理されます。

拒否されたテキストは保持されず、拒否は同じキーで24時間再生されます。

このリーダーのためにシーケンスを通じて単調にメッセージを承認します。会話の last_sequence を超えて承認できません。

このプロジェクトの会話を終了し、保留中のAI返信をキャンセルします。繰り返し可能で履歴を保持します。スタッフはSlackで再開できます。

すべてのプランでのプロジェクトサポートメッセージは再開可能なSSEです。eventはsupport.message、idはプロジェクトサポートシーケンス、dataはSupportMessageです。afterはLast-Event-IDより優先されます。カーソル0は履歴を再生します。スタッフ、顧客、AIメッセージは役割で区別されます。ストリームは資格情報とアクティブなプロジェクトアクセスを再検証します。

スクリーンショットや認証情報は送信されません。