サポートに連絡
ご連絡の前に、1 分だけヘルプセンターのグループ別 Q&A とトラブルシューティングガイドをご覧ください——多くの問題はそこで解決できます。本当に人が見る必要があれば、以下のいずれかの入口をご利用ください。
入口 1：WeChat
Section titled “入口 1：WeChat”
QR コードはアップロード待ちです。 上の画像は現在プレースホルダーで、正式な QR コードが用意でき次第置き換えます。それまでは下のメールの入口をご利用ください。
スキャンしてグループに参加したら、問題の説明をそのままグループに送ってください（下の「4 つの事項をはっきり書く」を参照）。先に挨拶して返事を待つ必要はありません。
入口 2：メール
Section titled “入口 2：メール”メールの件名は「[形態] 一文で問題」の形をおすすめします。例：「[CLI] tansr init で PAT が無効と表示される」、「[セッションサービス] resume が常に 409」。営業時間内はできるだけ早く返信します。営業時間外のメールは受信順に処理します。
メールクライアントを開きたくない場合は、下に直接入力しても構いません——フォームも同様にメールの形でサポート用メールボックスに届き、送信に成功するとチケット ID が発行されます。送信できない場合は、件名と説明を入れたメールリンクをページに表示します。
どちらの入口が適しているか
Section titled “どちらの入口が適しているか”| 状況 | おすすめ |
|---|---|
| 一文で説明でき、「自分の使い方が間違っているのか」を素早く確認したい | WeChat グループ |
| 診断出力、ログ、トランスクリプトなど長い資料を添付する必要がある | メール |
| 課金、インボイス、アカウントの帰属など本人確認が必要なこと | メール。登録済みのメールアドレスから送ってください |
| セキュリティの脆弱性 | メール。件名を「[セキュリティ]」で始め、グループには送らない |
| ドキュメントの誤りや抜け | メール。ページのアドレスを明記 |
同じ問題は 1 つの入口だけをご利用ください。両側での重複処理を避けるためです。
4 つの事項をはっきり書く
Section titled “4 つの事項をはっきり書く”この 4 つを添えていただければ、ほとんどの問題は 1 往復で特定できます。
- どの形態を、どのバージョンで使っているか。 CLI は
tansr --versionを実行。SDK / セッションサービスはpackage.json内の@tansr/sdk/@tansr/serveのバージョンを確認。モバイルは SDK の座標のバージョンと OS のバージョンを書く。 - 診断出力。 CLI は
tansr doctor --jsonを貼る（キーの値は含まれず、認証情報は指紋の形でだけ現れます）。セッションサービスはGET /readyzのレスポンスと関連する構造化ログの行を貼る。 - エラーコードと完全なメッセージ。 例：
429 plan_concurrency_exceeded、409 resume_unavailable。セッションサービス側ではレスポンスヘッダーx-request-idも添える。モバイルはconnectionStateの変化の並びを添える。 - 再現手順と時刻。 課金に関わる場合は注文番号または請求月、そしてアカウント指紋（
tansr initのサマリーカードに表示される形）。
会話内容を見せる必要があるときは、tansr sessions export <id> でトランスクリプトをエクスポートしてください——キーは自動的に sk-...末尾 4 桁 の形にマスキング済みなので、そのまま添付できます。
送らないでほしいもの
Section titled “送らないでほしいもの”- いかなるキーの値も：個人アクセストークン、アプリキー appkey、モデルプロバイダーの API キー、セッションサービスの Bearer。これらがなくてもトラブルシューティングはできます。誤って送ってしまった場合は、すぐにコンソールでローテーションしてください。
.envファイルの内容。- 実際の顧客データを含む完全なログ。マスキングするか、関連する行だけを抜き出してください。
返信を受け取った後
Section titled “返信を受け取った後”tansr doctor --jsonやあるエンドポイントのレスポンスをもう一度お願いすることがあります。関連付けしやすいように、同じメール / 同じグループメッセージのスレッドで返信してください。- 問題が不具合と確認された場合、修正がどのバージョンで公開される見込みかをお知らせします。公開後はリリースノート（CLI）、SDK リリースノート、セッションサービスリリースノートで確認できます。
- 問題が解決したら、差し支えなければ「解決しました」と一言返信してください。それをもってフォローアップを終了します。
自分で解決できる問題
Section titled “自分で解決できる問題”| 問題 | 行き先 |
|---|---|
| エラーコードの意味、再試行できるか | エラーコード表 · トラブルシューティングガイド |
| PAT / アプリキー / プラン / 残高 / インボイス | アカウントと請求 |
tansr doctor のあるセクションが読めない |
設定と doctor |
| セッションサービスのデプロイ、グレースフルシャットダウン、複数レプリカ | デプロイと認証 |
| モバイルの切断復旧、フォアグラウンド / バックグラウンド、プッシュ | Android 導入ガイド · iOS 導入ガイド |
| データの保存場所、認証情報の置き場所、ローテーション方法 | セキュリティとプライバシー |
セキュリティの問題
Section titled “セキュリティの問題”発見したのがセキュリティの脆弱性（認証情報の漏洩経路、権限昇格、インジェクション面）である場合は、グループには送らず、support@tansr.com に直接メールし、件名を「[セキュリティ]」で始めてください。優先して対応し、修正までコミュニケーションを維持します。
ドキュメントへのフィードバック
Section titled “ドキュメントへのフィードバック”各記事の下部に「このページは役に立ちましたか」があります。ドキュメントの誤りや抜けも、ページのアドレスと問題箇所を直接メールでお知らせください。
このページは役に立ちましたか？
フィードバックありがとうございます。この記事の改善に活かします。