Skip to main content

トラブルシューティング

よくある問題、その意味、そして解決方法。

5 min read

問題が発生したときは、まずこのページを確認してください。症状は気づく場所ごとに分類されています。該当するセクションから始めてください。

まず落ち着いてください。 多くの問題はバグではなく設定に起因します。プラットフォームは重要なものを壊せない設計になっています。デプロイメントを一時停止し、問題を修正して、再開してください。厄介な問題でも、無駄になったテスト通話の費用程度で済むのがほとんどです。

該当する問題が見つからない場合: デプロイメントID、通話ID（該当する場合）、および期待した動作と実際の動作を記載して [email protected] までメールしてください。表示に関する問題はスクリーンショットも添付してください。

テスト通話

「テスト通話がかかってこない」

考えられる原因確認すべき点
電話番号の形式が誤っている国番号を含めてください。米国: +15551234567、インド: +919876543210。プラットフォームは発信前に「テスト形式: …」のプレビューを表示します。
トライアルクレジットの使い切り設定 → プランと請求 → 使用状況。新規アカウントには $25 のクレジットが付与されます。
番号がグローバル抑制リストに登録されている設定 → コンプライアンス → 発信拒否リスト で番号を検索してください。
キャリアによる拒否一部のキャリア（特に国際）は新しい番号からの発信をブロックします。別の発信元番号をお試しください。
端末側の迷惑電話ブロックApple/Google の迷惑電話フィルタが通知なくブロックする場合があります。別の発信元番号をお試しください。

「テスト通話はつながったが、Finn が無言・動作がおかしい」

考えられる原因確認すべき点
ウェルカムメッセージが defined に設定されているがフィールドが空Finn を編集 → ウェルカムメッセージ → フィールドにテキストを入力するか、dynamic に切り替えてください
音声が正しく割り当てられていないFinn を編集 → 音声 → 選択し直してください。一部の音声はリージョンの一致が必要です。
LLM サービスの設定ミス（上級）Finn を編集 → AI サービス設定 → デフォルトにリセット
Finn 側のマイク権限の問題再読み込みして再試行してください。解消しない場合はサポートへご連絡ください。

Finn の作成・編集

「Finn を保存できない — 保存ボタンがグレーアウトしている」

考えられる原因確認すべき点
必須フィールドが空赤いラベルを探してください。通常は名前、音声、言語です。
ワークフローの検証エラーワークフロータブを使用している場合、赤い枠線のノードを確認してください。
ブラウザセッションの期限切れ再読み込みし、ログインし直して再試行してください。編集内容は下書きとして自動保存されます。

「Finn が書いたスクリプトどおりに動きません。」

考えられる原因対処方法
Identity フィールドが曖昧すぎる具体的に書く。「あなたは AI アシスタントです」より「あなたは Maya、親しみやすい受付担当です」のほうが効果的。
ガードレールが他の多数の指示に埋もれている重要なガードレールは専用のフィールド（Style & Guardrails）に移す。
フィールド間で指示が矛盾しているIdentity・Style・Welcome・Workflow に矛盾がないか確認する。
ナレッジベースに矛盾する情報があるサンプル通話の Data Extractor Sidebar で Knowledge タブを開き、何が取得されたか確認する。KB から矛盾を取り除く。
構造が必要な場面で自由形式を使っている順序が厳密に決まったフローがある場合は、代わりに Workflows を使う。

「Finn がよく喋りすぎる／喋らなすぎる。」

症状対処
喋りすぎるResponse Guidelines に追加：「詳細を求められない限り、応答は2文以内に収めてください。」
短すぎるResponse Guidelines に追加：「必要に応じて例を挙げ、完全な回答をしてください。」
発信者の話に割り込むSettings → Call Settings → Interruption Sensitivity を調整する（低いほど辛抱강く待つ）
不自然に長い沈黙があるmax_idle_duration を短くする（例：10秒ではなく5秒）

「Finn が同じ質問を二度繰り返します。」

考えられる原因対処
発信者の回答が想定した形式と一致しなかったAsk ノードのパーサーを緩めるか、質問の言い回しを変える
LLM が回答をメモリに保存しなかったResponse Guidelines に追加：「一度回答された質問は、再度尋ねないでください。」
ワークフローのループ不具合ワークフローを開き、Ask ノードに戻るエッジがないか確認する

ナレッジベース

「ドキュメントに書いてあるはずの質問に Finn が答えません。」

考えられる原因確認すること
ドキュメントがまだインデックスされていないKnowledge Base タブ → ステータスを確認。Indexed と表示されるはず。止まっている場合は Re-index Now をクリック。
ドキュメントが画像のみのPDFですスキャンしたPDFはOCR処理されません。先にテキストへ変換してください（Adobeやオンラインの OCR ツールなど）。
ドキュメントが長すぎて、検索が該当箇所を取りこぼすドキュメントを、内容を絞った小さめのファイルに分割します。
質問の言い回しがドキュメントの表現と一致しないサンプル通話で Data Extractor Sidebar → Knowledge タブを開き、何が取得されたかを確認します。誤ったスニペットが返っている場合は、ナレッジベースの意味的なカバー範囲が不足しています。
ファイルが 25 MB の上限を超えている圧縮するか分割します。

「Finn の回答が古い」

考えられる原因対処
古いバージョンのドキュメントがナレッジベースに残っているKnowledge Base → 古いファイルを削除し、新しいファイルをアップロード
Web サイトのインポート内容がキャッシュされたまま古いKnowledge Base → Website Imports → [URL] → Re-crawl Now
クエリ結果のキャッシュ（まれ）Re-index Now をクリックして強制的に更新

デプロイメント

「Launch をクリックしたのに発信されない」

考えられる原因確認する項目
発信可能時間帯の外デプロイメントは、通話相手の現地時間で設定された発信可能時間帯にのみ発信します。発信可能時間が 9〜18 時の設定で午前 8 時（PT）に起動した場合、最初の発信は午前 9 時までは行われません。
オーディエンスが空オーディエンスを開き、行が存在することを確認します。同期の問題で空のままになることがあります。
すべての番号が抑止されているSettings → Compliance → Do Not Call List。誤ってテスト用リストを抑止した場合は、解除してください。
発信元番号が未登録発信者番号の登録がない米国番号は、エラーも出ずに失敗します。Settings → Phone numbers → [Number] → Registration Status を確認してください。
上限額に到達Live Deployments → ヘルスパネルに「Cap reached」と表示されます。上限を引き上げるか、次の期間まで待ちます。
デプロイメントが一時停止中Live Deployments → デプロイメントをクリック → ステータスを確認。

「発信はされるが、全員すぐに切ってしまう」

考えられる原因対処
発信者番号に「SPAM LIKELY」と表示されている発信者番号を登録します。登録がないと、米国のキャリアが迷惑電話として表示するため、応答率が大きく低下します。
ウェルカムメッセージが迷惑電話のように聞こえる冒頭を引き締める。「[会社名]の[名前]です。[相手が予期する用件]の件でご連絡しました」。この「用件」が重要 — 一般的な切り出しは切られる。
不適切な時間帯の発信発信可能時間帯が適用されているか確認する。
リストがコールド（過去の接点なし）これは Finn の問題ではなくリストの問題。コールドリストは応答・継続率が常に低い。

「デプロイメントが一時停止しているが理由が分からない」

Live Deployments → デプロイメントをクリック → 一時停止理由までスクロール。よくある理由：

理由意味
上限額に到達デプロイメント単位で設定した上限に達した。上限を引き上げるかデプロイメントを終了する。
対象リストを消化全連絡先に発信済み（リトライ含む）。デプロイメントを完了するか連絡先を追加する。
バッファ枯渇ディスパッチャーが一時的に処理待ちになった。通常は1分以内に自動復旧する。
手動での一時停止自分かチームメンバーが一時停止した。監査ログを確認する。
キャリア障害通信事業者側の障害。障害が解消すると再開する。
プラン上限に到達プランの月間コール数を使い切った。アップグレードするか次のサイクルまで待つ。

分析

「通話があったはずなのに分析にはコール数0と表示される」

考えられる原因対処
別のデプロイメントを見ているデプロイメントのドロップダウンを確認 — 別のものを選んでいることが多い
キャッシュが古い「更新」をクリック（「キャッシュ済み」バッジが表示されているときにボタンが出る）
通話が5秒未満だった一部の指標は極端に短い通話を除外する（不応答として扱う）。通話ログ全体を確認する。

「通話後分析の項目が空になっている」

考えられる原因対処
デプロイメント開始後に項目を追加した通話後分析は、項目追加後に完了した通話にのみ実行される。以降の通話には値が入る。
項目の質問が漠然としすぎている書き換える。「興味の度合いは？」より「相手は興味を示しましたか？」の方がよい。
文字起こしが短すぎる通話が5秒しか続かなかった場合、抽出する内容はありません。
LLM抽出エラーまれなケースです。サイドバーで通話の抽出ステータスを確認してください。

「通話の感情分析が正しくないようです。」

感情分析は完璧ではありません。判定ではなく参考指標として扱ってください。誤分類が続く場合は、より具体的な質問（例：「発信者は解決内容に満足していたか？」）を設定したカスタムの通話後フィールドを追加し、そちらを使用してください。

電話番号

「番号を購入したのに使えません。」

考えられる原因確認する項目
コンプライアンス認証が保留中一部の国（インド、フランス、ドイツ）ではKYCが必要です。設定 → 電話番号 → [番号] → コンプライアンスステータス。
発信者番号が未登録（米国）登録が完了するまで、発信は「carrier rejected」で失敗します。
SIPトランクの設定ミス（BYO）設定 → テレフォニーアカウント → トランクをテスト。よくある原因：コーデックの不一致、認証情報の誤り。
番号がFinnに割り当てられていない（着信）設定 → 電話番号 → [番号] → デフォルト着信Finn → 割り当てを行う。

「発信が『carrier rejected』で失敗します。」

原因対処法
発信者番号が未登録（米国／カナダ）設定 → 電話番号 → [番号] → 発信者番号登録
宛先国が送信者認証を必要としている設定 → 電話番号 → コンプライアンスでKYCを実施
発信元番号が音声通話に対応していない音声対応の番号を購入してください。SMS専用番号では発信できません
キャリアが不正な送信者をフィルタリングしている別の発信元番号を試してください。古い番号はキャリアにブラックリスト登録されている場合があります

連携

「CRM同期で新しい連絡先が取り込まれません。」

考えられる原因対処法
同期スケジュールの間隔が長すぎる設定 → 連携 → [CRM] → 15分ごとまたは1時間ごとに設定
CRMトークンの有効期限切れ連携を再認証する
フィルターが新しい連絡先を除外しているオーディエンスのCRMフィルターを開き、条件を確認する
CRM APIのレート制限に達している時間をおいて再試行してください。大量の同期はCRM側の制限に達することがあります。

「Webhookがイベントを受信しません」

考えられる原因確認事項
インターネットからURLに到達できないlocalhostではなく公開URLを使用してください。ローカルでテストする場合はトンネル（ngrok、Cloudflare Tunnel）を使用します。
2xx以外のレスポンスを返しているプラットフォームは200〜299を想定しています。3xx/4xx/5xxは再試行の対象となります。
エンドポイントがタイムアウトしている10秒以内に応答する必要があります。処理に時間がかかる場合は、Webhookをすぐに受け付けて非同期で処理してください。
HMAC署名が一致しない署名の実装が仕様どおりか確認してください — インテグレーション → Webhookを参照。

「カレンダーに予約が表示されません」

考えられる原因対処方法
選択したカレンダーが誤っている設定 → インテグレーション → カレンダー → 選択中のカレンダーを確認
カレンダープロバイダー側で権限が取り消されたインテグレーションを再認可する
表示していないカレンダーに予約が入った複数のカレンダーを使っている場合、予約はどこかに存在します。「すべてのカレンダー」表示で確認してください。
カレンダーの予定タイトルが分かりにくい予約の既定タイトルは「Appointment via Finn」です。この文字列で検索してください

請求

「請求額が想定より高いです」

設定 → プランと請求 → 使用量 → 異常フラグ。直近30日の平均の2倍を超える項目を確認します。よくある原因:

  • Finnが対応の難しいオーディエンスに対して実行され、長時間の膠着した通話が発生した（limit_call_durationを設定してください）。
  • 上限額を設定せずにデプロイを開始し、想定よりはるかに大きなリストに発信した。
  • プレミアム音声またはプレミアムモデルが有効になっていた（設定 → プラン）。
  • 新しい国が追加された — 国際通話料金は米国の10〜50倍になることがあります。

「無駄になったデプロイの返金を希望します」

デプロイIDと状況の説明を添えて[email protected]までメールしてください。不具合が原因の場合は通常返金されます。設定ミスによる場合は通常返金対象外ですが、個別に判断しますのでご連絡ください。

アカウントとアクセス

「ログインできません」

考えられる原因試すこと
パスワードを忘れたログインページで「パスワードをお忘れですか」をクリック
ログイン失敗が多すぎてアカウントがロックされた15分待ってから再試行してください
メールアドレスが確認されていない迷惑メールフォルダで確認メールを探してください
チームアカウントだが招待されていない管理者に依頼して「設定 → チーム」から招待してもらってください
SSOが機能しない組織がSSOを利用している場合は、メールアドレスとパスワードではなくSSOリンクからログインする必要があります

「アカウントにアクセスできなくなった／2FAデバイスを紛失した」

アカウント所有者であることの証明（請求先メールアドレス、支払い方法の下4桁など）を添えて [email protected] までメールしてください。アクセスの復旧をサポートします。

パフォーマンス／品質

「レイテンシが高すぎる — Finnの応答に時間がかかる」

目標：ユーザーの発話終了からFinnの応答開始まで800ms未満。

原因対処
プレミアム音声を選択している標準音声に切り替える（-100〜200ms）
リージョンが遠いサインアップ時に、通話相手に最も近いリージョンをアカウントに設定する
キャリア側のネットワーク障害通常は一時的 — 数分待つ
入れ子が深い複雑なワークフロー簡素化し、サブフローをまとめる
ナレッジベースが大きく検索が遅い設定 → ナレッジ で再インデックス、またはKBのサイズを縮小

「Finnの話し方が機械的で人間らしくない」

原因対処
標準音声ティアプレミアム音声を試す
言語の不一致音声の主要言語が話している言語と一致しているか確認する
応答ガイドラインが厳しすぎる「応答は1文以内」とすると素っ気なくなります。制限を緩めてください。
ワークフローが硬直したスクリプトを強制している自由形式に切り替えるか、Sayノードの使用を控える

それでも解決しない場合

  1. デプロイを一時停止する — 発信が停止し、以降の費用は発生しません。
  2. 直近の失敗した通話を確認する — Data Extractor サイドバーを開くと全体の状況を確認できます。
  3. Ctrl+F でエラーのキーワードを使ってこのトラブルシューティングページ内を検索してください。
  4. サポートにメールする — デプロイ ID、通話 ID、状況の説明を添えて [email protected] まで。
  5. チャットバブルの Finn を使う — 右下隅にあります。これらのドキュメントで学習済みで、たいていの問題はその場で解決できます。
  6. Enterprise をご利用のお客様 — 専任の CSM が Slack チャンネルにいます。

次へ

Was this page helpful?

Still stuck or have feedback?

Email [email protected] or use the chat bubble in the bottom-right corner — it's a Finn that knows the Academy cold.