Omnisend 自動化
Eコマースマーケティング業務を自動化します – コンタクトの作成・更新、カーソルページネーションを使用した購読者リストの管理、バルクバッチ操作の実行、オーディエンスのセグメンテーション – すべてComposio MCP統合を通じて連携します。
ツールキットドキュメント: composio.dev/toolkits/omnisend
セットアップ
- Composio MCPサーバー (
https://rube.app/mcp) でOmnisendアカウントを接続します。 - アクティブな接続がない場合、エージェントが認証リンクを求めます。
- 接続が確立されると、すべての
OMNISEND_*ツールが実行可能になります。
コアワークフロー
1. コンタクトの作成または更新
メール識別子でコンタクトをアップサート（存在しなければ作成、存在すれば更新）し、購読ステータス、プロフィールフィールド、オプションのウェルカムメッセージを指定します。
ツール: OMNISEND_CREATE_OR_UPDATE_CONTACT
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
identifiers | 配列 | はい | 少なくとも1つの識別子オブジェクト。id（メール）、type（email）、オプションでchannels.email.status（subscribed、nonSubscribed、unsubscribed）、およびsendWelcomeMessage（ブール値）を含む |
firstName | 文字列 | いいえ | コンタクトの名 |
lastName | 文字列 | いいえ | コンタクトの姓 |
gender | 文字列 | いいえ | m または f |
birthdate | 文字列 | いいえ | 形式: YYYY-MM-DD |
country | 文字列 | いいえ | 完全な国名 |
countryCode | 文字列 | いいえ | ISO 3166-1 alpha-2コード（例: US） |
city | 文字列 | いいえ | 市区町村名 |
address | 文字列 | いいえ | 番地 |
postalCode | 文字列 | いいえ | 郵便番号 |
2. ページネーションを使用したコンタクト一覧の取得
コンタクトをバッチで取得し、メール、電話番号、ステータス、セグメント、タグでオプションのフィルタリングが可能です。
ツール: OMNISEND_LIST_CONTACTS
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
limit | 整数 | いいえ | 1ページあたりの件数（デフォルト: 100、最大: 250） |
after | 文字列 | いいえ | 次のページへのカーソル（base64エンコードされたContactID） |
before | 文字列 | いいえ | 前のページへのカーソル |
email | 文字列 | いいえ | 完全一致のメールアドレスでフィルタ |
phone | 文字列 | いいえ | 国番号を含む完全な電話番号でフィルタ |
status | 文字列 | いいえ | subscribed、nonSubscribed、unsubscribed のいずれかでフィルタ |
segmentID | 整数 | いいえ | セグメントIDでフィルタ |
tag | 文字列 | いいえ | タグ（例: VIP）でフィルタ |
3. コンタクト詳細の取得
コンタクトIDが既にある場合、単一のコンタクトの完全なプロフィールを取得します。
ツール: OMNISEND_GET_CONTACT
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
contactId | 文字列 | はい | 一意のコンタクト識別子（例: 60e7412b1234567890abcdef） |
4. 既存のコンタクトの更新
レコード全体を上書きせずに、IDでコンタクトの特定のフィールドをパッチ適用します。
ツール: OMNISEND_UPDATE_CONTACT
contactId と更新するフィールドが必要です。まず OMNISEND_LIST_CONTACTS または OMNISEND_GET_CONTACT でコンタクトIDを取得してください。
5. バルクバッチ操作
1回の呼び出しで多数のレコードを非同期に処理します – コンタクト、商品、注文、イベント、カテゴリ。
ツール: OMNISEND_CREATE_BATCH
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
method | 文字列 | はい | POST または PUT |
endpoint | 文字列 | はい | ターゲット: contacts、orders、products、events、categories |
items | 配列 | はい | 各操作のペイロードオブジェクトの配列 |
eventID | 文字列 | 条件付き | エンドポイントが events の場合に必須 |
大規模なデータセットを処理する際のレート制限を回避するには、バッチ操作を使用します。
既知の落とし穴
| 落とし穴 | 詳細 |
|---|---|
| 識別子必須 | OMNISEND_CREATE_OR_UPDATE_CONTACT では、identifiers 配列に少なくとも1つの識別子が必要です – email タイプのみサポートされています |
| カーソルベースのページネーション | OMNISEND_LIST_CONTACTS はページ番号ではなく、base64エンコードされた after/before カーソルを使用します – 不完全なデータを避けるためにカーソルに従ってください |
| コンタクトIDの解決 | OMNISEND_UPDATE_CONTACT には contactId が必要です – まず一覧取得または取得操作で必ず解決してください |
| バッチメソッドの制約 | OMNISEND_CREATE_BATCH は POST または PUT メソッドのみ受け付けます – DELETE や PATCH は使用できません |
| イベントID依存 | イベントをバッチ処理する場合、eventID パラメータが必須です – 省略するとバッチが失敗します |
クイックリファレンス
| ツールスラッグ | 目的 |
|---|---|
OMNISEND_CREATE_OR_UPDATE_CONTACT | メールでコンタクトを作成またはアップサート |
OMNISEND_LIST_CONTACTS | フィルタリングとカーソルページネーションでコンタクトを一覧表示 |
OMNISEND_GET_CONTACT | IDで単一のコンタクトの完全なプロフィールを取得 |
OMNISEND_UPDATE_CONTACT | 既存のコンタクトの特定のフィールドをパッチ適用 |
OMNISEND_CREATE_BATCH | コンタクト、商品、注文、イベントのバルク非同期操作 |
Powered by Composio