---

name: sendgrid-automation description: "通过 Composio 的 SendGrid 工具包自动化 SendGrid 邮件投递工作流，包括营销活动（Single Sends）、联系人和列表管理、发件人身份设置以及邮件分析。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 SendGrid 自动化

通过 Composio 的 SendGrid 工具包自动化 SendGrid 邮件投递工作流，包括营销活动（Single Sends）、联系人和列表管理、发件人身份设置以及邮件分析。

前置条件

• 必须连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit sendgrid 建立活跃的 SendGrid 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在你的客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应来验证 Rube MCP 可用
2. 使用 toolkit sendgrid 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，按照返回的认证链接完成 SendGrid API 密钥认证
4. 在运行任何工作流之前确认连接状态显示为 ACTIVE

核心工作流

1. 创建和发送营销活动（Single Sends）

使用场景：用户想要创建并向联系人列表或分组发送营销邮件活动。

工具调用顺序：

1. SENDGRID_RETRIEVE_ALL_LISTS - 列出可用的营销列表作为目标 [前置条件]
2. SENDGRID_CREATE_A_LIST - 如需要则创建新列表 [可选]
3. SENDGRID_ADD_OR_UPDATE_A_CONTACT - 将联系人添加到列表 [可选]
4. SENDGRID_GET_ALL_SENDER_IDENTITIES - 获取已验证的发件人 ID [前置条件]
5. SENDGRID_CREATE_SINGLE_SEND - 创建包含内容、发件人和收件人的活动 [必需]

SENDGRID_CREATE_SINGLE_SEND 关键参数：

• name：活动名称（必需）
• email__config__subject：邮件主题行
• email__config__html__content：HTML 正文内容
• email__config__plain__content：纯文本版本
• email__config__sender__id：已验证的发件人身份 ID
• email__config__design__id：用于预构建设计，替代 html_content
• send__to__list__ids：要发送到的列表 UUID 数组
• send__to__segment__ids：分组 UUID 数组
• send__to__all：设为 true 发送给所有联系人
• email__config__suppression__group__id 或 email__config__custom__unsubscribe__url：合规性要求必须提供其一

注意事项：

• 在 CREATE 时设置 send_at 不会安排发送；它只是预填充 UI 日期；需要单独使用 Schedule 端点
• send_at: "now" 仅在 Schedule 端点有效，不适用于 CREATE
• 必须提供 suppression_group_id 或 custom_unsubscribe_url 以满足退订合规要求
• 发件人必须在使用前验证；使用 SENDGRID_GET_ALL_SENDER_IDENTITIES 检查
• 嵌套参数使用双下划线表示法（如 email__config__subject）

2. 管理联系人和列表

使用场景：用户想要创建联系人列表、添加/更新联系人、搜索联系人或从列表中移除联系人。

工具调用顺序：

1. SENDGRID_RETRIEVE_ALL_LISTS - 列出所有营销列表 [必需]
2. SENDGRID_CREATE_A_LIST - 创建新的联系人列表 [可选]
3. SENDGRID_GET_A_LIST_BY_ID - 获取列表详情和示例联系人 [可选]
4. SENDGRID_ADD_OR_UPDATE_A_CONTACT - 插入/更新联系人并关联列表 [必需]
5. SENDGRID_GET_CONTACTS_BY_EMAILS - 通过邮箱查找联系人 [可选]
6. SENDGRID_GET_CONTACTS_BY_IDENTIFIERS - 通过邮箱、电话或外部 ID 查找联系人 [可选]
7. SENDGRID_GET_LIST_CONTACT_COUNT - 操作后验证联系人数量 [可选]
8. SENDGRID_REMOVE_CONTACTS_FROM_A_LIST - 从列表中移除联系人但不删除 [可选]
9. SENDGRID_REMOVE_LIST_AND_OPTIONAL_CONTACTS - 删除整个列表 [可选]
10. SENDGRID_IMPORT_CONTACTS - 从 CSV 批量导入 [可选]

SENDGRID_ADD_OR_UPDATE_A_CONTACT 关键参数：

• contacts：联系人对象数组（最多 30,000 个或 6MB），每个至少包含一个标识符：email、phone_number_id、external_id 或 anonymous_id（必需）
• list_ids：要关联联系人的列表 UUID 字符串数组

注意事项：

• SENDGRID_ADD_OR_UPDATE_A_CONTACT 是异步的；返回 202 和 job_id；联系人可能需要 10-30 秒才能显示
• 列表 ID 是 UUID（如 "ca7a3796-e8a8-4029-9ccb-df8937940562"），不是整数
• 列表名称必须唯一；重复名称会导致 400 错误
• SENDGRID_ADD_A_SINGLE_RECIPIENT_TO_A_LIST 使用旧版 API；优先使用带 list_ids 的 SENDGRID_ADD_OR_UPDATE_A_CONTACT
• SENDGRID_REMOVE_LIST_AND_OPTIONAL_CONTACTS 不可逆；需要用户明确确认
• 邮箱地址会被 SendGrid 自动转为小写

3. 管理发件人身份

使用场景：用户想要设置或查看用于发送邮件的发件人身份（发件地址）。