name: Omnisend Automation description: “通过Omnisend和Composio自动化电商营销工作流，包括联系人管理、批量操作和订阅者细分” requires: mcp: - rube
Omnisend Automation
自动化电商营销操作——创建和更新联系人，通过游标分页管理订阅者列表，运行批量批处理操作，以及细分受众——所有通过Composio MCP集成进行编排。
工具包文档： composio.dev/toolkits/omnisend
设置
- 通过Composio MCP服务器在
https://rube.app/mcp连接您的Omnisend账户 - 如果没有活动连接，代理将提示您一个认证链接
- 一旦连接，所有
OMNISEND_*工具都可用于执行
核心工作流
1. 创建或更新联系人
通过电子邮件标识符更新或创建联系人，包括订阅状态、个人资料字段和可选欢迎消息。
工具： OMNISEND_CREATE_OR_UPDATE_CONTACT
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
identifiers |
数组 | 是 | 至少一个标识符对象，包含 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 |
整数 | 否 | 每页结果数（默认：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. 批量批处理操作
在单个调用中异步处理多条记录——联系人、产品、订单、事件或类别。
工具： OMNISEND_CREATE_BATCH
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
method |
字符串 | 是 | POST 或 PUT |
endpoint |
字符串 | 是 | 目标：contacts、orders、products、events、categories |
items |
数组 | 是 | 每个操作的负载对象数组 |
eventID |
字符串 | 条件性 | 当端点是 events 时必需 |
使用批处理操作以避免在处理大数据集时受到速率限制。
已知陷阱
| 陷阱 | 详情 |
|---|---|
| 标识符必需 | OMNISEND_CREATE_OR_UPDATE_CONTACT 要求 identifiers 数组中至少有一个标识符——仅支持 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 |
联系人、产品、订单、事件的批量异步操作 |
由 Composio 提供支持