HalloFelix von InsurMagic について
HalloFelix von InsurMagic は、ドイツ、オーストリア、スイスの保険ブローカー向け HalloFelix AI 電話・WhatsApp サービスのリモート MCP サーバーです。接続した AI クライアントから、通話、顧客、キャンペーン、アシスタント、予約、WhatsApp の会話を参照・管理できます。
主な機能
- 01通話とメール記録の参照・更新
- 02顧客、メモ、顧客メモリーの管理
- 03発信キャンペーンの作成と制御
- 04音声、メール、WhatsApp アシスタントの設定
- 05WhatsApp の会話の確認と管理
活用シーン
- 01通話の文字起こし確認とタスク状態の更新
- 02顧客情報と記憶させる事実の記録
- 03発信キャンペーンの開始や調整
- 04WhatsApp 会話の割り当てと返信
MCP 対応
`https://app.hallofelix.de/api/mcp` のリモートサーバーは、通話、顧客、アシスタント、WhatsApp の受信トレイなど、HalloFelix アカウントのデータと操作を MCP クライアントに公開します。OAuth または Bearer トークン認証に対応します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://app.hallofelix.de/api/mcpclaude mcp add --transport http timgutberlet-hallofelix https://app.hallofelix.de/api/mcp{"mcpServers":{"timgutberlet-hallofelix":{"type":"http","url":"https://app.hallofelix.de/api/mcp"}}}Cursor で開く{"servers":{"timgutberlet-hallofelix":{"type":"http","url":"https://app.hallofelix.de/api/mcp"}}}VS Code で開く{"mcpServers":{"timgutberlet-hallofelix":{"type":"http","url":"https://app.hallofelix.de/api/mcp"}}}{"mcpServers":{"timgutberlet-hallofelix":{"serverUrl":"https://app.hallofelix.de/api/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
InsurMagic の HalloFelix – MCP サーバー
ドイツ、オーストリア、スイスの保険ブローカー向け AI 電話・WhatsApp アシスタント、HalloFelix von InsurMagic の公式 Model Context Protocol サーバーです。
Claude、ChatGPT、Cursor、VS Code、または任意の MCP クライアントを HalloFelix アカウントに接続すると、AI エージェントが HalloFelix のウェブアプリで利用できるすべての機能を使えるようになります。通話、メールとそのタスク、顧客(メモ、電話番号、顧客メモリー)、発信キャンペーン、音声・メール・WhatsApp アシスタント、Vorgänge(タスクの種類)、カレンダーと予約の種類、会社の設定、ナレッジドキュメント、統計、WhatsApp の受信トレイ全体に対応しています。
サーバー URL: https://app.hallofelix.de/api/mcp(リモート、Streamable HTTP)
認証
- OAuth(推奨): コネクターに対応するクライアント(Claude.ai、Claude Desktop、ChatGPT、Cursor、VS Code)では、URL を指定するだけです。HalloFelix アカウントにサインインして、アクセスを許可します(アカウントの管理者のみ)。
- API トークン:
Authorization: Bearer <api_access_token>としてトークンを送信します。HalloFelix アプリの Integrationen → API から作成できます。
セットアップ
Claude.ai / Claude Desktop
設定 → コネクター → カスタムコネクターを追加 → URL https://app.hallofelix.de/api/mcp → 接続。
ChatGPT
設定 → アプリとコネクター → 詳細設定 → 開発者モードを有効化 → 作成 → URL https://app.hallofelix.de/api/mcp、認証 OAuth。
Claude Code
claude mcp add --transport http hallofelix https://app.hallofelix.de/api/mcp
その後、/mcp を実行してサインインします。代わりにトークンを使う場合は、--header "Authorization: Bearer <api_access_token>" を追加します。
Cursor
または ~/.cursor/mcp.json に追加します:
{ "mcpServers": { "hallofelix": { "url": "https://app.hallofelix.de/api/mcp" } } }
VS Code(GitHub Copilot)
または code --add-mcp '{"name":"hallofelix","type":"http","url":"https://app.hallofelix.de/api/mcp"}'
Windsurf
~/.codeium/windsurf/mcp_config.json:
{ "mcpServers": { "hallofelix": { "serverUrl": "https://app.hallofelix.de/api/mcp" } } }
OpenAI Codex CLI
codex mcp add hallofelix --url https://app.hallofelix.de/api/mcp
codex mcp login hallofelix
Gemini CLI
~/.gemini/settings.json:
{ "mcpServers": { "hallofelix": { "httpUrl": "https://app.hallofelix.de/api/mcp" } } }
stdio のみをサポートするクライアント
{
"mcpServers": {
"hallofelix": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.hallofelix.de/api/mcp"]
}
}
}
ツール
| ツール | 機能 | アクセス |
|---|---|---|
list_calls | HalloFelix の音声 AI が処理した電話(着信および発信)を、文字起こし、要約、抽出されたデータ項目、タスク(ステータスとダッシュボード上のラベル、担当者名、タスクタイプ)とともに一覧表示します | 読み取り |
get_call | 電話の全記録:文字起こし、要約、要約データ項目、顧客、キャンペーン、アシスタント | 読み取り |
update_call | 電話を評価し、タスクを設定します:ステータス、担当者(チームメンバーを ID、名前、またはメールアドレスで指定)、タスクタイプ(Vorgang を ID または名前で指定) | 書き込み、破壊的操作 |
bulk_update_call_status | 最大 1000 件の電話のタスクステータスを一度に設定します | 書き込み、破壊的操作 |
delete_call | 録音、文字起こし、タスク、メモを含む電話を完全に削除します | 書き込み、破壊的操作 |
start_outbound_call | 実際の電話を開始します:AI 電話アシスタントが顧客の優先電話番号に今すぐ(または scheduled_at に)電話をかけます | 書き込み |
list_call_notes | 電話のタスクに関する内部メモを新しい順に一覧表示します | 読み取り |
add_call_note | 電話のタスクに内部メモを追加します | 書き込み |
list_emails | HalloFelix のメールアシスタントが処理したメールを、要約、顧客、タスク(ステータスとダッシュボード上のラベル、担当者名、タスクタイプ)とともに新しい順に一覧表示します | 読み取り |
get_email | メールの全記録:送信者、宛先、件名、本文、要約、顧客、タスク | 読み取り |
update_email | メールを評価し、タスクを設定します:ステータス、担当者(チームメンバーを ID、名前、またはメールアドレスで指定)、タスクタイプ(Vorgang を ID または名前で指定) | 書き込み、破壊的操作 |
list_email_notes | メールのタスクに関する内部メモを新しい順に一覧表示します | 読み取り |
add_email_note | メールのタスクに内部メモを追加します | 書き込み |
update_note | 電話、メール、または顧客のメモのテキストを変更します | 書き込み、破壊的操作 |
delete_note | 電話、メール、または顧客のメモを完全に削除します | 書き込み、破壊的操作 |
list_customers | 顧客(AI が電話またはチャットでやり取りする連絡先)を、電話番号(タイプとダッシュボード上のラベル)、電話対応(Anrufbehandlung とラベル)、電話件数、最終通話時刻とともに一覧表示します | 読み取り |
get_customer | 顧客の全記録 | 読み取り |
create_customer | 顧客を作成します | 書き込み |
import_customers | 1 回の呼び出しで最大 500 人の顧客を作成します | 書き込み |
update_customer | 顧客情報を編集します:名前、メールアドレス、言語、外部 ID、電話対応、WhatsApp AI の除外設定 | 書き込み、破壊的操作 |
delete_customer | 電話番号、メモ、予約、記憶情報を含む顧客を完全に削除します | 書き込み、破壊的操作 |
add_customer_phone_number | 顧客に電話番号を追加します | 書き込み |
update_customer_phone_number | 顧客の電話番号を優先番号に設定(is_primary: true)し、またはそのタイプを設定します | 書き込み、破壊的操作 |
delete_customer_phone_number | 顧客の電話番号を削除します(最後の番号は削除できません) | 書き込み、破壊的操作 |
list_customer_notes | 顧客に関する内部メモを新しい順に一覧表示します | 読み取り |
add_customer_note | 顧客に内部メモを追加します | 書き込み |
get_customer_memory | 顧客について AI が記憶している内容(車両、住所、好み、連絡可能時間帯、メモ)を、各情報の由来とステータスとともに取得します | 読み取り |
add_customer_memory_fact | 顧客について AI が記憶すべき情報を追加します | 書き込み |
update_customer_memory_fact | 情報(値)を修正するか、却下します(ステータスを「rejected」にすると、CRM の情報も非表示になります) | 書き込み、破壊的操作 |
delete_customer_memory_fact | 記憶情報を完全に削除します(CRM の情報は削除できず、却下のみ可能です) | 書き込み、破壊的操作 |
list_campaigns | 発信キャンペーンを、ステータス(およびダッシュボード上のラベル)、成功率、応答率とともに一覧表示します | 読み取り |
get_campaign | 計算済み統計情報を含むキャンペーンの全記録 | 読み取り |
create_campaign | 発信キャンペーンを作成します | 書き込み |
start_campaign | キャンペーンを開始または再開します:AI が顧客への発信を開始します | 書き込み |
set_campaign_status | キャンペーン実行ステータスを変更します | 書き込み、破壊的操作 |
update_campaign | 下書きキャンペーンを編集します(名前、アシスタント、最初の文、目標、試行回数、再試行間隔、顧客、スケジュール、営業時間。customer_ids は顧客リストを置き換えます)。または、任意のキャンペーンをアーカイブ/アーカイブ解除します | 書き込み、破壊的操作 |
delete_campaign | キャンペーンを完全に削除します(電話記録は残りますが、キャンペーンとの関連付けは解除されます) | 書き込み、破壊的操作 |
list_call_assistants | 音声 AI 電話アシスタントを一覧表示します(ID、名前、電話番号、音声 ID と名前、使用状況) | 読み取り |
get_call_assistant | 電話アシスタントの編集可能な全設定(挨拶、音声、ルーティング、SMS/メール、予約、営業時間、Vorgänge など) | 読み取り |
update_call_assistant | 稼働中の電話アシスタントの設定を変更します | 書き込み、破壊的操作 |
list_voices | ダッシュボードで提供されている、電話アシスタントが使用できる音声を一覧表示します:ID(保存されている call_voice 値)、名前、性別、説明、おすすめまたは新規追加の有無、プレビュー録音 URL | 読み取り |
list_whatsapp_assistants | WhatsApp AI アシスタントを一覧表示します | 読み取り |
get_whatsapp_assistant | WhatsApp AI アシスタントの編集可能な全設定を取得します。AI スケジュール、Vorgänge、引き継ぎ先について、値とともにダッシュボード上の名称を表示します | 読み取り |
update_whatsapp_assistant | 稼働中の WhatsApp アシスタントの設定を変更します | 書き込み、破壊的操作 |
create_call_assistant | 新しい電話アシスタントを作成します | 書き込み |
list_email_assistants | メール AI アシスタントを一覧表示します(ID、名前、使用状況) | 読み取り |
get_email_assistant | メールアシスタントの名前、指示、Vorgänge(task_type_ids と、名前を含む task_types)を取得します | 読み取り |
create_email_assistant | アカウントの既定の Vorgänge を使用してメールアシスタントを作成します | 書き込み |
update_email_assistant | メールアシスタントを変更します | 書き込み、破壊的操作 |
create_whatsapp_assistant | WhatsApp アシスタントを作成します(アシスタント数の上限にカウントされます) | 書き込み |
delete_whatsapp_assistant | マクロ、ドキュメント、ルールを含む WhatsApp アシスタントを完全に削除します。このアシスタントを使用している番号は、別のアシスタントが設定されるまで AI の返信を受け取れません | 書き込み、破壊的操作 |
list_whatsapp_macro_runs | 停止し、人手による対応が必要な WhatsApp アシスタントのマクロ実行を一覧表示します:状態は unknown(ドキュメントが届いたかどうか不明)または failed_terminal(届いていない)です | 読み取り |
resolve_whatsapp_macro_run | マクロ実行を手動で終了します(状態は resolved_manually)。何も送信されません | 書き込み |
retry_whatsapp_macro_run | マクロ実行のドキュメントを WhatsApp 経由で顧客に再送信します | 書き込み |
test_whatsapp_assistant | WhatsApp アシスタントにテストメッセージを送信し、シミュレートされた返信(または実行されるマクロ)を返します | 書き込み |
list_users | WhatsApp チャットの割り当て先にできるチームメンバーを、ID、名前、メールアドレスとともに一覧表示します(ID はチャットの assigned_user_id です) | 読み取り |
get_member_limit | アカウントのサブスクリプションに基づくメンバー上限、課金対象メンバー数、別のメンバーを招待できるかどうかを取得します | 読み取り |
invite_team_member | HalloFelix アカウントにメンバーを追加し、招待メールを送信します(新規ユーザーにはサインインリンクが送信されます) | 書き込み |
remove_team_member | アカウントからメンバーを削除します:アクセス権が失われ、このアカウント内のユーザーごとのデータ(プッシュ通知の登録、既読状態、音声クリップ、Keasy 接続)が削除され、そのメンバーに割り当てられた WhatsApp チャットは未割り当てになります | 書き込み、破壊的操作 |
list_whatsapp_accounts | 接続済みの WhatsApp ビジネス番号(受信トレイ)を、受信トレイ設定とともに一覧表示します | 読み取り |
get_whatsapp_account | 接続済みの WhatsApp ビジネス番号を、受信トレイ設定(AI、既読通知、自動メッセージ、営業時間、AI スケジュール、アシスタント)とともに取得します。既読通知と AI スケジュールのダッシュボード上のラベル、およびアシスタント名も含まれます | 読み取り |
list_whatsapp_conversations | WhatsApp チャットを、ラベル、顧客、割り当て(ユーザー ID と名前)、受信トレイ上のラベルを含むステータス(Offen、Erledigt、KI deaktiviert)、最終メッセージとともに一覧表示します | 読み取り |
get_whatsapp_conversation | WhatsApp チャットを、ラベル、顧客、割り当て(ユーザー ID と名前)、受信トレイ上のラベルを含むステータス、最終メッセージとともに取得します | 読み取り |
update_whatsapp_conversation | チャットの完了(Erledigt)または再開、スヌーズ、割り当て(assigned_user_id にチームメンバーのユーザー ID、フルネーム、名、またはメールアドレスを指定。null の場合はチャットを AI に戻します)、パートナー制御の設定、顧客に対する AI の一時停止、既読/未読の設定、連絡先の命名、顧客の関連付け、または AI が連絡先について読み取るメモの設定を行います | 書き込み、破壊的操作 |
list_whatsapp_messages | WhatsApp チャットのメッセージを古い順に一覧表示します | 読み取り |
send_whatsapp_message | 既存の WhatsApp チャットに、ビジネス名義でメッセージを送信します:テキスト、返信ボタン(1~3 個、タイトルは最大 20 文字)、リスト(1~10 行)、またはテンプレート | 書き込み |
start_whatsapp_conversation | 承認済みテンプレートを電話番号に送信し、必要に応じて連絡先とチャットを作成します(新しいチャットには必ずテンプレートが必要です) | 書き込み |
list_whatsapp_notes | WhatsApp チャットの内部チームメモを一覧表示します(顧客には送信されません) | 読み取り |
add_whatsapp_note | WhatsApp チャットに内部チームメモを追加します | 書き込み |
add_whatsapp_voice_note | WhatsApp チャットに内部音声メモを追加します:公開 HTTPS URL からダウンロードした WebM または Ogg の録音(最大 10 MB、最大 5 分)を保存して文字起こしし、その文字起こしをメモのテキストにします | 書き込み |
list_whatsapp_labels | アカウントの WhatsApp チャットラベルをすべて一覧表示します | 読み取り |
add_whatsapp_conversation_labels | チャットにラベルを追加し、既存のラベルはそのまま保持します | 書き込み |
set_whatsapp_conversation_labels | チャットのラベルをすべて置き換えます(空のリストを指定するとすべて削除されます) | 書き込み、破壊的操作 |
list_whatsapp_templates | WhatsApp 番号のメッセージテンプレートを、Meta による現在の審査ステータスとともに一覧表示します | 読み取り |
get_whatsapp_template | テンプレートと現在の Meta 審査ステータスを取得します | 読み取り |
create_whatsapp_template | テンプレートを作成して Meta に審査を申請します。ステータスが approved になると送信できます | 書き込み |
list_task_types | アシスタントが認識して登録するタスクタイプ(「Vorgänge」)を一覧表示します。独自のタスクタイプと HalloFelix の基本テンプレートが含まれ、名前、説明、指示、絵文字、有効フラグ、編集可能かどうかを表示します(基本テンプレートは先に分離する必要があります) | 読み取り |
get_task_type | タスクタイプ(Vorgang)と、その指示およびフラグを取得します | 読み取り |
create_task_type | 独自のタスクタイプ(Vorgang)を作成します | 書き込み |
update_task_type | タスクタイプを変更します:名前、説明、指示、絵文字(独自または分離済みのタスクタイプのみ)、および/または有効状態 | 書き込み、破壊的操作 |
detach_task_type | 有効な HalloFelix 基本テンプレートを、アシスタントを引き継ぐ独自の編集可能なコピー(「 (Individuell)」)に変換し、基本テンプレートを無効にします | 書き込み |
delete_task_type | 独自または分離済みのタスクタイプを削除し、すべてのアシスタントから取り除きます | 書き込み、破壊的操作 |
list_appointment_types | 電話および WhatsApp アシスタントが予約できる予約タイプ(Termintypen)を、所要時間、前後のバッファ、使用条件とともに一覧表示します | 読み取り |
create_appointment_type | 1 つの電話アシスタントまたは WhatsApp アシスタントに予約タイプを追加します | 書き込み |
update_appointment_type | 予約タイプを変更します | 書き込み、破壊的操作 |
delete_appointment_type | 予約タイプを削除します。アシスタントはそのタイプの予約ができなくなります | 書き込み、破壊的操作 |
list_calendars | アシスタントが空き状況を確認し、予約を書き込む接続済みカレンダー(Google、Microsoft、iCloud など)を一覧表示します | 読み取り |
get_calendar | HalloFelix が予約を書き込んだ予定を含む、接続済みカレンダーを取得します | 読み取り |
update_calendar | HalloFelix 内の接続済みカレンダーの名前を変更します | 書き込み、破壊的操作 |
delete_calendar | カレンダーの接続を解除します:アシスタントはそのカレンダーの確認と予約を停止し、他に使用しているカレンダーがなければプロバイダーとの接続も解除されます(再接続にはダッシュボードが必要です) | 書き込み、破壊的操作 |
list_calendar_events | 接続済みカレンダーの from から to までの予定(ISO-8601、最大 92 日間、最大 200 件)を一覧表示します | 読み取り |
book_calendar_appointment | ビジネスの実際の接続済みカレンダーに予定を予約します(その時間帯が埋まっている場合は 409 slot_taken で失敗します) | 書き込み |
get_account | 会社のプロフィールとアシスタントが使用する所在地、録音設定(save_audio_recording、recording_retention_days)、顧客の記憶機能の切り替え設定を取得します | 読み取り |
update_account | 会社の設定を変更します | 書き込み、破壊的操作 |
get_crm_ai_access | 接続済み CRM 内の顧客データ(契約、損害、Vorgänge、基本データ、健康に関する項目)を WhatsApp AI が参照できるかどうかと、CRM 接続を取得します | 読み取り |
update_crm_ai_access | AI による CRM データへのアクセス設定を変更します | 書き込み、破壊的操作 |
list_documents | アシスタントが回答に使用するナレッジドキュメント(PDF/DOCX)を、ステータス(processing、done、failed)とともに一覧表示します | 読み取り |
delete_document | ナレッジドキュメントを削除します。アシスタントはそのドキュメントを参照して回答できなくなります | 書き込み、破壊的操作 |
upload_document | アシスタントが回答に使用するナレッジドキュメントを追加します:公開 HTTPS URL からダウンロードする、最大 1 MB の PDF または Word(.docx)ファイル | 書き込み |
get_assistant_voice_intro | 電話アシスタントが、読み上げる最初の文の代わりに録音済みの挨拶を再生するかどうかを、ファイル名と 60 分間有効な再生リンクとともに取得します | 読み取り |
upload_assistant_voice_intro | 電話アシスタントが通話開始時に再生する録音済みの挨拶を設定または置き換えます(MP3、WAV、WebM、最大 2 MB)。公開 HTTPS URL からダウンロードします | 書き込み、破壊的操作 |
delete_assistant_voice_intro | 電話アシスタントの録音済みの挨拶を削除します。再びテキストの最初の文を読み上げます | 書き込み、破壊的操作 |
get_campaign_voice_intro | キャンペーンの通話が録音済みの最初の文で始まるかどうかを、ファイル名と 60 分間有効な再生リンクとともに取得します | 読み取り |
upload_campaign_voice_intro | キャンペーンの通話で再生する録音済みの最初の文を設定または置き換えます(MP3、WAV、WebM、最大 2 MB)。公開 HTTPS URL からダウンロードします | 書き込み、破壊的操作 |
delete_campaign_voice_intro | キャンペーンの録音済みの最初の文を削除します。通話では再びテキストの最初の文が使用されます | 書き込み、破壊的操作 |
add_whatsapp_pdf_template | PDF(最大 16 MB、公開 HTTPS URL からダウンロード)を WhatsApp アシスタントに追加します | 書き込み |
delete_whatsapp_pdf_template | WhatsApp アシスタントから PDF を削除し、保存済みファイルを削除します | 書き込み、破壊的操作 |
set_whatsapp_template_header_media | WhatsApp テンプレートの既定のヘッダーファイルを、画像、動画、またはドキュメントのヘッダーとして設定または置き換えます。テンプレートに独自のファイルを指定せずに送信する場合に使用されます:JPEG/PNG は最大 5 MB、MP4/3GPP は最大 16 MB、PDF は最大 16 MB。公開 HTTPS URL からダウンロードします | 書き込み、破壊的操作 |
delete_whatsapp_template_header_media | WhatsApp テンプレートの既定のヘッダーファイルを削除します。以降、テンプレートの送信には独自のファイルが必要です | 書き込み、破壊的操作 |
get_insights | 日付範囲(既定値:過去 30 日間)のダッシュボード KPI を、その前の期間と比較して取得します:電話、通話時間と分数、メール、WhatsApp メッセージ(全件/AI)、日別グラフ、未処理項目、会社の数値、Vorgang の分布 | 読み取り |
get_crm_connection | CRM(Professional Works、blau direkt、arisecur、VEMA、JDC/iCRM)がアカウントに接続されているか、連絡先が最後に同期された日時、ログインに失敗したかどうかを取得します | 読み取り |
search_crm_contacts | 接続済み CRM から HalloFelix が同期した連絡先を、名前、メールアドレス、電話番号で関連度順に検索します | 読み取り |
get_crm_contact | CRM からリアルタイムで読み取った詳細情報を含む、同期済み CRM 連絡先を取得します:敬称、住所、生年月日、電話番号、メールアドレス、ステータス | 読み取り |
list_crm_archive_destinations | CRM からリアルタイムで読み取った連絡先の契約、損害、Vorgänge を一覧表示します。それらの ID は、電話、チャット、ドキュメントの保存先です | 読み取り |
list_crm_contact_files | CRM の連絡先の Kundenakte 内にあるドキュメントをリアルタイムで一覧表示します | 読み取り |
upload_crm_document | ファイル(最大 10 MB、公開 HTTPS URL からダウンロード)を接続済み CRM にアップロードします:連絡先の Kundenakte、および/またはその契約、損害、Vorgänge | 書き込み |
list_customer_crm_contact_matches | 電話番号またはメールアドレスが HalloFelix の顧客と一致する、同期済み CRM 連絡先と、その顧客が関連付けられている連絡先を一覧表示します | 読み取り |
link_customer_crm_contact | 顧客を同期済み CRM 連絡先に関連付けます:顧客の名前、電話番号、メールアドレスは連絡先の情報で上書きされ、アカウント内の別の顧客がその連絡先の電話番号を持つ場合は、この顧客に統合されます(通話、チャット、メモが移動し、その顧客は削除されます) | 書き込み、破壊的操作 |
archive_call_in_crm | 電話の文字起こしを PDF として接続済み CRM に保存します:連絡先の Kundenakte、および/または契約、損害、Vorgänge | 書き込み、破壊的操作 |
archive_whatsapp_chat_in_crm | WhatsApp チャットの選択したメッセージとメモを 1 つの PDF として接続済み CRM に保存します:連絡先の Kundenakte、および/または契約、損害、Vorgänge | 書き込み |
upload_whatsapp_files_to_crm | WhatsApp チャットで送受信したファイル(写真、PDF など)を接続済み CRM にアップロードします:連絡先の Kundenakte、および/または契約、損害、Vorgänge | 書き込み |
get_webhook | API ウェブフックの送信先が設定されているかどうかと、その SHA-256 フィンガープリントを取得します(URL 自体は返されません) | 読み取り |
set_webhook | API ウェブフック URL(公開 HTTPS)を設定します | 書き込み、破壊的操作 |
get_call_enrichment | 通話前の情報補完 URL が設定されているかどうかと、その SHA-256 フィンガープリントを取得します(URL 自体は返されません) | 読み取り |
set_call_enrichment | 通話前の情報補完 URL(公開 HTTPS)を設定または削除(null)します | 書き込み、破壊的操作 |
update_whatsapp_account | WhatsApp 番号の受信トレイ設定を変更します。送信されたフィールドのみが変更されます | 書き込み、破壊的操作 |
list_whatsapp_template_folders | WhatsApp 番号のテンプレートフォルダーを、それぞれのテンプレートとともに一覧表示します | 読み取り |
create_whatsapp_template_folder | テンプレートフォルダーを作成します(HalloFelix 内にのみ存在し、Meta には作成されません) | 書き込み |
rename_whatsapp_template_folder | テンプレートフォルダーの名前を変更します | 書き込み、破壊的操作 |
delete_whatsapp_template_folder | テンプレートフォルダーを削除します。テンプレートは既定のフォルダーに戻ります(テンプレート自体は残ります) | 書き込み、破壊的操作 |
move_whatsapp_template_to_folder | テンプレートを同じ WhatsApp 番号のフォルダーに移動します | 書き込み、破壊的操作 |
list_whatsapp_ai_exclusions | WhatsApp AI が一切返信しない顧客を一覧表示します。その顧客のチャットはチームに引き継がれます | 読み取り |
set_whatsapp_ai_exclusion | excluded=true:すべてのチャットで AI がこの顧客への返信を停止し、チームが対応します。false:その顧客のチャットを AI に戻します | 書き込み、破壊的操作 |
open_whatsapp_conversation | WhatsApp 番号上で、電話番号に対応するチャットを検索または作成します。メッセージは送信しません | 書き込み |
delete_whatsapp_conversation | チャットのメッセージ、メモ、ファイルをすべて含め、チーム全体から完全に削除します | 書き込み、破壊的操作 |
search_whatsapp_messages | すべての WhatsApp チャット(アーカイブ済みも含む)のメッセージを新しい順に検索します:テキスト、キャプション、音声の文字起こし | 読み取り |
react_to_whatsapp_message | 顧客のメッセージに絵文字でリアクションします。顧客にはすぐに表示されます(絵文字に null を指定するとリアクションが削除されます) | 書き込み |
retry_whatsapp_message | 送信に失敗したテキストまたはテンプレートを、失敗から 24 時間以内に顧客への新しいメッセージとして再送信します | 書き込み |
list_scheduled_whatsapp_messages | チャットへの送信が予定されていて、まだ送信されていないテンプレートを、送信予定時刻の早い順に一覧表示します | 読み取り |
schedule_whatsapp_template | 承認済みテンプレートを、将来の指定時刻にチャットへ送信するよう予約します | 書き込み |
cancel_scheduled_whatsapp_message | 送信前の予約済みテンプレートをキャンセルします | 書き込み、破壊的操作 |
send_whatsapp_media | 公開 URL から画像、動画、ドキュメント、音声をチャットに送信します(24 時間以内。WhatsApp のサイズ制限が適用されます) | 書き込み |
list_whatsapp_media | チャットのファイル(送受信の両方)を新しい順に一覧表示します。1 ページあたり 50 件です | 読み取り |
create_whatsapp_label | チャットラベルを作成します(アカウントあたり最大 20 個) | 書き込み |
update_whatsapp_label | ラベルの名前または色を変更します | 書き込み、破壊的操作 |
delete_whatsapp_label | ラベルを削除します。そのラベルが付いていたすべてのチャットからも削除されます | 書き込み、破壊的操作 |
remove_whatsapp_conversation_label | チャットからラベルを 1 つ削除し、他のラベルはそのまま保持します | 書き込み、破壊的操作 |
注意事項
- WhatsAppの自由形式メッセージは、顧客の最後のメッセージから24時間以内のみ送信できます。この期間を過ぎた場合は、承認済みテンプレートを送信してください。
- 通話録音のリンクは署名付きで、60分間有効です。
- REST APIとWebhookの完全なリファレンス:https://app.hallofelix.de/docs/external-api.md
サポート
[email protected] · hallofelix.de · InsurMagic GmbH
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。