連携

御社のCRM、カレンダー、ツールを接続します。

3 min read

Finnは、すでにお使いのシステム — CRM、カレンダー、電話プロバイダー、チームのチャット — と連携したときに最も効果を発揮します。このページでは、連携設定をこれまで一度もしたことがない方を前提に、それぞれの手順を説明します。

すべてを設定する必要はありません。 ほとんどのユーザーは、まずカレンダー（Finnが予約を取れるようにするため）と、必要に応じてCRMから始めます。他の連携は、具体的な必要が生じたときに追加してください。

すべての接続は元に戻せます。 接続に使ったのと同じ画面から、いつでも切断できます。プラットフォームがデータを人質に取ることはありません。

連携設定の場所

サイドバー → 設定 → 連携。

利用可能な連携ごとにタイルが表示され、ステータスのラベルが付いています： 未接続、接続済み、要対応。 いずれかのタイルをクリックすると、設定または管理ができます。

CRM

CRMは顧客・連絡先のレコードを保管する場所です。CRMを接続すると、次のことができます：

連絡先を取り込む ため、CSVを手動でアップロードする必要がなくなります。
通話結果を書き戻す ため、営業チームはCRMを離れることなく各通話の内容を確認できます。

HubSpot

設定はほぼクリック操作だけで完了します。所要時間は10分程度です。

設定 → 連携 → HubSpot → 接続。
HubSpotにリダイレクトされます。（未ログインの場合は）ログインし、認証をクリックします。
緑色の「接続済み」バッジが付いた状態でFinnに戻ります。
次に、何をインポートするかを決めます。リストを選択 をクリックし、オーディエンスとして使いたいHubSpotリストにチェックを入れます。
同期スケジュールを設定します — 稼働中のキャンペーンには 15分ごと が適切な初期設定です。更新頻度の低いリストなら毎日で十分です。
フィールドをマッピングします — どのHubSpotプロパティが名前、電話番号、国番号にあたるかをFinnに指定します。任意で、追加のプロパティをカスタムフィールドにマッピングすると、Finnが通話中にそれらを利用できます。

以上です。HubSpotのリストがFinnのオーディエンスとして表示されるようになります。

通話結果をHubSpotに書き戻すには、設定時に 結果同期 を有効にします（後から同じ画面で有効にすることもできます）。完了した各通話はHubSpotのエンゲージメントとして記録され、通話後分析のフィールドはプロパティの更新として反映されます。

Salesforce

全体の流れはHubSpotと同じです。Salesforce固有の注意点がいくつかあります：

本番環境またはSandboxに接続できます。 設定フローでどちらかを選択します。
必要な権限 — 「API Enabled」と、リード・取引先責任者・（使用する場合は）カスタムオブジェクトに対する「読み取り/書き込み」権限を持つユーザーが必要です。たいていのCRM管理者であれば設定できます。
カスタムオブジェクトに対応。 営業プロセスでカスタムオブジェクト（例：「商談オーナーの通話」）を使っている場合は、標準のリード／取引先責任者の代わりにそちらへマッピングできます。

Pipedrive

PipedriveはOAuthではなくAPIトークンを使用します。

Pipedrive側で： 設定 → 個人設定 → API → トークンを生成。
そのトークンをFinn → 設定 → 連携 → Pipedriveに貼り付けます。
以降の設定はHubSpotと同じ手順で進めます。

「自分のCRMが一覧にない」

Webhook 連携（このページの下方）を使えば、HTTPリクエストを受け取れる場所であればどこへでも通話結果を送信できます。または、Zapier／Makeのようなツールで橋渡しすることもできます — 下記のZapierのセクションを参照してください。

カレンダー — 予約を取るために

Finnに予約を取らせたい場合は、カレンダーの接続が必要です。

Google Calendar

設定 → 連携 → Google Calendar → 接続。
Googleにログインし、カレンダーへのアクセス権限を許可します。
どのカレンダーに予約するかを選択します。複数持っている場合が多いため、適切なものを選んでください。
空き状況のルールを設定します:
- 稼働時間 — 予約を受け付ける時間帯
- 予定間のバッファ — 連続する予約の間に確保する最小間隔（例: 10分）
- 1日あたりの最大予定数 — 任意の上限設定
保存します。

これで、任意のFinnに「Book Calendar」タスクやワークフローアクションを追加すると、このカレンダーが使用されます。

Microsoft Outlook / Microsoft 365

Googleと同じ手順です。Microsoftで認証し、カレンダーを選び、空き状況を設定します。

Calendly / Cal.com

これらは仕組みが異なり、Google/Outlookのような形でAPI経由の直接予約ができません。代わりにFinnが*「予約リンクをお送りします」*と伝え、URLを記載したSMSまたはメールが送信されます。

動作はしますが、直接予約に比べると自然さに欠けます。選べる場合は、GoogleかOutlookを直接連携することをおすすめします。

電話プロバイダー — 自社の番号を利用する場合

他社（Twilio、Vonage、社内PBXなど）ですでに電話番号を保有している場合、Finn経由でそのまま利用できます。

詳しい手順は電話番号 → 自社番号の持ち込みを参照してください。

対応プロバイダー: Twilio、Plivo、Bandwidth、Vonage、および一般的なSIP準拠キャリア。

Webhook — 自社システムへのデータ送信

Webhookとは、通話終了やデプロイメント終了などのイベント発生時にFinnがデータを送信する、お客様側のURLです。

次のような場合に便利です:

完了した通話をすべてデータウェアハウスに送り、独自の分析を行いたい
特定のイベント発生時にSlackメッセージやメールを送信したい
利用中のCRMや業務アプリが標準対応していないが、HTTPリクエストを受信できる
Zapier/Make/n8nで後続処理を自動化したい

Webhookの設定

設定 → 連携 → Webhook → エンドポイントを追加。
Finnの送信先URLを入力します。
購読するイベントを選択します:
- Call started — 通話開始時に発火
- Call completed — 通話終了時に発火（文字起こしは利用可能、分析は未完了）
- Call analyzed — 通話後の分析完了時に発火（後続の自動化に最も有用）
- Deployment launched — デプロイメントが開始した時に発火
- Deployment completed — デプロイメント終了時に集計指標付きで発火
保存します。Finnが署名シークレットを表示するので、安全な場所にコピーしてください（表示は一度限りです）。
エンドポイント側で署名シークレットを検証し、リクエストが確かにFinnからのものであることを確認してください。

データの形式

各イベントはJSONをURLに送信します。call.analyzedイベントはおおよそ次のような形式です:

{
  "event": "call.analyzed",
  "call": {
    "id": "call_abc123",
    "deployment_id": "deploy_xyz",
    "started_at": "2026-06-15T10:30:00Z",
    "duration_seconds": 142,
    "contact": { "name": "Alice Chen", "phone_number": "+15551234567" },
    "transcript": [ ...turn-by-turn... ],
    "post_call_analysis": {
      "appointment_booked": true,
      "appointment_time": "2026-06-22 14:00"
    },
    "sentiment": "positive"
  }
}

完全なスキーマは開発者向けリファレンスapi.hirefinn.ai/docsに記載されています。

Webhookが動作しない場合

Finn がエンドポイントに到達できない場合（DNS エラー、タイムアウト、5xx レスポンス）、最大 24 時間バックオフしながら再試行します。配信に失敗したものはすべて、エラーメッセージとともに 設定 → 連携 → Webhook → 配信ログ に表示されます。デバッグに便利です。

通話中の Webhook（ライブデータ照会）

もう一つ別の種類の Webhook があります。会話の最中に Finn が呼び出して、ライブデータを照会するものです。

例：顧客が注文について電話をかけてきたとします。Finn は注文状況を知る必要がありますが、その情報は Finn ではなく自社システムにあります。Finn が顧客の電話番号を添えて /lookup エンドポイントを呼び出すと、エンドポイントが { "order_status": "shipped", "tracking": "1Z..."} を返し、Finn はそれを応答に使います。「ご注文は昨日発送されました。追跡番号の末尾は…」

設定方法：Finn のワークフローで アクション → Webhook ノードを追加します。URL と送信内容を設定します。レスポンスはワークフロー変数として利用できます。

REST API — プログラムによる制御

自社のコードから Finn を制御したいチームもあります。デプロイメントをプログラムから起動する、通話データを独自ダッシュボードに取り込む、といった用途です。

設定 → 連携 → API キー → 新しいキーを生成。キーをコピーして安全に保管してください。

次に API を使用します：

POST https://api.hirefinn.ai/v1/deployments
Authorization: Bearer your_api_key

{
  "finn_id": "finn_abc",
  "audience_id": "aud_xyz",
  "from_number": "+15551234567"
}

Node、Python、Go、Ruby の公式 SDK を提供しています。詳細なリファレンスは api.hirefinn.ai/docs。

開発者ではなく、この節が難しく感じる場合：使う必要はありません。API でできることはすべてダッシュボードでできます。API はスクリプト化したいチームのためのものです。

Slack — チームチャットで通知を受け取る

運用状況の把握に便利です。*「デプロイメント X が完了しました。結果はこちらです」*といった通知を、全員に Finn へログインさせることなく受け取れます。

設定 → 連携 → Slack → ワークスペースに追加。
Slack で認可します。
通知先のチャンネルを選びます。
通知する内容を選びます：
- デプロイメント開始
- デプロイメント完了（サマリー統計付き）
- デプロイメント失敗
- 毎朝のサマリー
- しきい値アラート（例：「成功率が X を下回った」）

複数のチャンネルを接続できます。チームごとに必要な通知の種類は異なるためです。

Zapier / Make / n8n

ノーコード自動化では、上記の Webhook 連携を任意の自動化ツールのトリガーソースとして使用します。

ネイティブの Zapier アプリも開発中です。早期アクセスは設定 → 連携 → Zapier から申請してください。

SSO（エンタープライズ）

シングルサインオンを使うと、Finn 用の別パスワードではなく、既存の社内 ID（Okta、Azure AD、Google Workspace など）でチームがログインできます。

エンタープライズプランで利用できます。

SAML 2.0 — 主要な ID プロバイダーすべてに対応。
SCIM — ユーザープロビジョニングの自動化。IdP で適切なグループにユーザーを追加すると、自動的に Finn アカウントが作成されます。削除するとアクセス権も失われます。

セットアップは 設定 → セキュリティ → SSO で行います。多くの企業の IT チームは経験があるはずで、手順は標準的なものです。

コンプライアンスとデータレジデンシー

厳密には連携ではありませんが、知っておく価値があります：

GDPR — 完全対応。削除権、エクスポート、EU データレジデンシーに対応。
HIPAA — Enterprise プランのみ、BAA の署名が必要です。
SOC 2 Type II — 取得済み。監査報告書は NDA のもとで提供します。
データレジデンシー — アカウント作成時に US、EU、インドのいずれかのリージョンを選択します。（後から手動移行なしでの変更はできません。サインアップ時に慎重に選んでください。）

詳細は hirefinn.ai/platform/security をご覧ください。

よくある質問

Q: 複数の CRM を同時に同期できますか？ A: できます。CRM 接続はそれぞれ独立しています。オーディエンスごとに異なる CRM から同期できます。

Q: Webhook は発火しているのに、自社システムにデータが届きません。 A: 設定 → 連携 → Webhook → 配信ログ でエラーを確認してください。多いのは SSL 証明書の問題、IP ブロック、エンドポイントが 200 以外を返しているケースです。

Q: 誤って CRM を切断しました。データは失われますか？ A: 失われません。切断は以降の同期を停止するだけです。既存のオーディエンスデータや通話履歴などはそのまま残ります。準備ができたら再接続してください。

Q: 同じアカウントで API とダッシュボードの両方を使えますか？ A: 使えます。多くのチームが自動化には API を、手動操作にはダッシュボードを使っています。どちらも同じ状態を参照します。

次のステップ

ワークフロー → — Finn 内で連携を Action ノードとして使う。
請求 → — プラン別の API・Webhook のクォータ。
コンプライアンス → — 連携が満たすべき要件。

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.