Fin for Salesは、inbound leadsを評価し、Chili Piper Conciergeを使って代理でミーティングを予約できます。Finが販売準備ができたleadを特定すると、適切な担当者にルーティングし、Messenger内またはメールやSMSのリンク経由でスケジューリング体験を表示します。

開始前に

以下を確認してください：

Chili Piper管理者ロール - セットアップに必要なAPIキーを生成できるのはChili Piper管理者のみです。
有効なConciergeルーター - Chili Piperワークスペースに「web form」タイプのConciergeルーターが少なくとも1つ設定されている必要があります。

ステップ1：Chili PiperのAPIキーを生成する

Chili Piper管理センターにログインします。
資格情報の下にあるAPI Access Tokensに移動します。
Generate Tokenをクリックします。
トークンに名前を付けます（例：「Fin integration」）。
以下の権限を有効にします：
- API：すべての権限
- Concierge：すべての権限
- Logs：すべての権限
- Tenant：読み取り
- Webhook：作成、読み取り、削除
トークンは再表示されない可能性があるため、すぐにコピーしてください。次のステップで必要になります。

ステップ2：IntercomでChili Piperを接続する

Chili Piperを接続するには：

Fin AI Agent > Sales > Train > Integrationsに移動します。
+ Add Calendarをクリックし、Chili Piperを選択します。
ステップ1で生成したAPIキーを貼り付けます。
Connectをクリックします。

キーが必要な権限をすべて持っているか検証されます。不足があればチェックリストで指摘されます。Chili Piperでキーを修正し、再度接続を完了する前に試してください。

接続が完了すると、緑色の確認バナーが表示され、Intercomは自動的にChili Piperのbooking webhookを登録します。

注意：

接続されたChili PiperのAPIキーは、すべての必要な権限（ルーティング、ログ読み取り、webhook管理）を持っている必要があります。セットアップ時に検証されますが、後でキーがChili Piperで変更された場合は、Intercomワークスペースでも更新が必要です。
logs.read権限は、メールやSMSなどMessenger以外のチャネルでのミーティング予約を記録するために必要です。

ステップ3：ルーターを選択する

Fin AI Agent > Sales > Playbook > Book a meetingに移動します。
Select a calendarのドロップダウンからChili Piperを選択します。
リストからルーターを選択します。

これは「web form」タイプで、少なくとも1つのルートにカレンダーが表示されている互換性のあるルーターのみ表示されます。要件を満たさないルーターはリストの下部でグレーアウトされます。グレーアウトされたルーターにカーソルを合わせると選択できない理由が表示されます。

注意：デフォルトでルーターは60日間の担当者の空き状況を確認します。

ステップ4：データフィールドをマッピングする

ルーターを選択した後、IntercomのデータをChili Piperのフォームフィールドにマッピングして、leadsが正しくルーティングされるようにします。

leadのメールアドレスは自動的にマッピングされます。さらに2つのフィールドをマッピングできます：

Intercomフィールド	提供内容
geoip.country_code	2文字の国コード（例：US、GB）
geoip.region	地理的地域（EMEA、NAMER、LATAM、APAC）

これらはChili Piperのweb formトリガーで定義されたフィールド名と一致していることを確認してください。