Customer.io オートメーション
顧客エンゲージメント運用を自動化します。ターゲットブロードキャストのトリガー、配信メトリクスの取得、オーディエンスセグメントの管理、ニュースレターやトランザクションテンプレートの一覧表示、トリガー実行履歴の検査など、すべて Composio MCP 統合を通じて実行できます。
ツールキットドキュメント: composio.dev/toolkits/customerio
セットアップ
https://rube.app/mcpにある Composio MCP サーバーから Customer.io アカウントを接続します。- アクティブな接続がない場合、エージェントが認証リンクを表示します。
- 接続が完了すると、すべての
CUSTOMERIO_*ツールが実行可能になります。
コアワークフロー
1. ブロードキャストのトリガー
事前設定されたブロードキャストを特定のオーディエンスに対して、パーソナライゼーションデータとともに手動で実行します。
ツール: CUSTOMERIO_TRIGGER_BROADCAST
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
broadcast_id | integer | はい | Customer.io トリガー詳細からのブロードキャスト ID |
ids | array | いいえ | ターゲットとする顧客 ID のリスト |
emails | array | いいえ | ターゲットとするメールアドレスのリスト |
recipients | object | いいえ | and/or/not/segment 演算子を使用した複合フィルター |
per_user_data | array | いいえ | id/email + data を使用したユーザーごとのパーソナライゼーション |
data | object | いいえ | Liquid テンプレートパーソナライゼーション用のグローバルキーバリューデータ |
data_file_url | string | いいえ | 行ごとのユーザーデータを含む JSON ファイルの URL |
email_add_duplicates | boolean | いいえ | 重複受信者を許可する (デフォルト: false) |
email_ignore_missing | boolean | いいえ | メールアドレスのない人をスキップする (デフォルト: false) |
id_ignore_missing | boolean | いいえ | 顧客 ID のない人をスキップする (デフォルト: false) |
重要: recipients、ids、emails、per_user_data、data_file_url のうち、正確に 1 つのオーディエンスオプションを指定してください。レート制限: ブロードキャストあたり 10 秒に 1 リクエスト。
2. メッセージ配信メトリクスの取得
キャンペーン、タイプ、時間枠でフィルタリングしながら、メッセージのページネーション付き配信メトリクスを取得します。
ツール: CUSTOMERIO_GET_MESSAGES
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
type | string | いいえ | メッセージタイプ: email、webhook、twilio、slack、push、in_app |
metric | string | いいえ | メトリクス: attempted、sent、delivered、opened、clicked、converted |
campaign_id | integer | いいえ | キャンペーン ID でフィルター |
newsletter_id | integer | いいえ | ニュースレター ID でフィルター |
action_id | integer | いいえ | アクション ID でフィルター |
start_ts | integer | いいえ | 時間枠の開始 (Unix タイムスタンプ) |
end_ts | integer | いいえ | 時間枠の終了 (Unix タイムスタンプ) |
limit | integer | いいえ | ページあたりの結果数、1～1000 (デフォルト: 50) |
start | string | いいえ | 前回の応答の next 値からのページネーショントークン |
drafts | boolean | いいえ | アクティブ/送信済みメッセージの代わりに下書きメッセージを返す |
3. オーディエンスセグメントの一覧表示
ワークスペース内で定義されたすべてのセグメントを取得し、オーディエンス分析とブロードキャストターゲティングに使用します。
ツール: CUSTOMERIO_GET_SEGMENTS
パラメーターは不要です。すべてのセグメントを ID とメタデータとともに返します。
ブロードキャストでセグメントをターゲットにするには、recipients.segment.id フィルターでセグメント ID を使用します。
4. ニュースレターの一覧表示
追跡と分析のために、すべてのニュースレターメタデータをページネーション付きで取得します。
ツール: CUSTOMERIO_LIST_NEWSLETTERS
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
limit | integer | いいえ | ページあたりの最大件数、1～100 |
sort | string | いいえ | asc (時系列) または desc (逆順) |
start | string | いいえ | 前回の応答の next 値からのページネーションカーソル |
5. トランザクショナルメッセージテンプレートの検出
API 経由で送信するための ID を見つけるために、すべてのトランザクショナルメッセージテンプレートを一覧表示します。
ツール: CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES
パラメーターは不要です。テンプレート ID とトリガー名を返します。
6. ブロードキャストトリガー履歴の検査
ブロードキャストのすべてのトリガー実行を確認し、個々のトリガーの詳細を検査します。
ツール: CUSTOMERIO_GET_TRIGGERS および CUSTOMERIO_GET_TRIGGER
ブロードキャストのすべてのトリガーを一覧表示:
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
broadcast_id | integer | はい | ブロードキャスト/キャンペーン ID |
特定のトリガーを取得:
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
broadcast_id | integer | はい | キャンペーン/ブロードキャスト ID |
trigger_id | string | はい | トリガー識別子 (例: 456 または 5-37) |
既知の落とし穴
| 落とし穴 | 詳細 |
|---|---|
| 相互排他的なオーディエンスパラメーター | CUSTOMERIO_TRIGGER_BROADCAST では、recipients、ids、emails、per_user_data、data_file_url のうち正確に 1 つが必要です。複数指定するとエラーになります。 |
| ブロードキャストのレート制限 | ブロードキャストは、ブロードキャスト ID ごとに 10 秒あたり 1 トリガーリクエストに制限されています。 |
| Unix タイムスタンプ形式 | CUSTOMERIO_GET_MESSAGES の start_ts と end_ts は ISO 文字列ではなく、Unix タイムスタンプでなければなりません。 |
| ページネーショントークン | メッセージとニュースレターでは、start パラメーターによるカーソルベースのページネーションを使用します。前回の応答の next 値をそのまま使用してください。 |
| セグメント ID の解決 | ブロードキャストでセグメントをターゲットにするには、まず CUSTOMERIO_GET_SEGMENTS でセグメント ID を取得し、recipients.segment.id で ID を参照します。 |
クイックリファレンス
| ツールスラッグ | 目的 |
|---|---|
CUSTOMERIO_TRIGGER_BROADCAST | 定義されたオーディエンスにブロードキャストをトリガーする |
CUSTOMERIO_GET_MESSAGES | フィルター付きでメッセージ配信メトリクスを取得する |
CUSTOMERIO_GET_SEGMENTS | すべてのオーディエンスセグメントを一覧表示する |
CUSTOMERIO_GET_SEGMENT_DETAILS | 特定のセグメントの詳細を取得する |
CUSTOMERIO_LIST_NEWSLETTERS | ニュースレターをページネーション付きで一覧表示する |
CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES | トランザクショナルメッセージテンプレートを一覧表示する |
CUSTOMERIO_GET_TRIGGERS | ブロードキャストのすべてのトリガー実行を一覧表示する |
CUSTOMERIO_GET_TRIGGER | 特定のトリガー実行を検査する |
Powered by Composio