サポート

トラブルシューティング · FAQ

よくある問題と対処です。解決しない場合は、お問い合わせページのフォームか sean@okitour.com へご連絡ください。

#ウィジェットが表示されない

インストールコードのプロジェクト ID が正しいか確認してください。
プロジェクトの 許可ドメイン に、サイトのドメイン（www の有無まで）が入っているか確認してください。
CSP（Content-Security-Policy）を使っている場合は、script-src と frame-src に https://app.cliptalk.net を追加してください。
ブラウザの開発者ツールの Console / Network タブでエラーを確認してください。

Content-Security-Policy:
  script-src 'self' https://app.cliptalk.net;
  frame-src https://app.cliptalk.net;
  connect-src 'self' https://app.cliptalk.net wss://app.cliptalk.net;

#AI ボットが返信しない

AI ボットの使用がオンで、保存済みか確認してください（適用まで最大 20 秒）。
Free プランは AI 相談 30 件の体験が終わると、オペレーターへすぐ接続されます。サブスクリプションタブで利用量を確認してください。
オペレーターがすでに参加した相談では、AI は返信しません。

#AI が自社 API を使わない

コネクタが マイ API に接続されているか（スタジオ上部の「AI ボットに接続済み」）確認してください。
オペレーションが使用状態か、説明がお客様の質問と結び付くよう具体的か確認してください。
顧客情報が必要なオペレーションは、本人確認が先に成功している必要があります。本人確認の案内文を入れ、必要な情報を先に伝えてもらうようにしてください。
API 利用ルールに「配送の問い合わせには get_order を使う」のように書くと、より確実です。

#API テストが失敗する

症状	確認すること
`401 / 403`	シークレットの値、認証方式（Bearer かヘッダーか）、ヘッダー名、キーの権限、IP 許可リスト
`404`	Base URL + パスが実際のアドレスと一致するか、/v1 のようなバージョンパスの重複
`bad_json`	ログインページや HTML のエラーページが返っている — パスと認証を確認
`timeout`	API サーバーの応答速度、ファイアウォール
`blocked_address`	社内網のアドレスは使えません。公開アドレスにするか、ゲートウェイを置いてください
`secret_origin_mismatch`	Base URL のドメインを変えたあと、シークレットを再入力

#Cliptalk のスタッフは自社のキーを見られますか？

キーは暗号化して保存され、ダッシュボード・管理画面・API 応答のどこにも表示されません。復号は実際の API 呼び出しの瞬間だけ、サーバーメモリ上で行われます。それでも、ボット専用・最小権限のキーを使うことをおすすめします。

#API の応答データはどこに保存されますか？

API 応答は AI が回答を作っている間だけ使われ、別に保存しません。お客様へ送った返信メッセージと、処理オペレーションの結果要約（AI 処理記録）だけが相談記録に残ります。