mcpField
M
managing-contacts

managing-contacts

github.com/mailtrap营销与增长1152 次安装今天更新
代码仓库

关于 managing-contacts

面向使用 Mailtrap 管理营销联系人的技能，适用于维护活动受众和同步 CRM 或数据平台。它涵盖联系人、列表、细分、字段、事件及批量导入，并区分营销筛选与发送抑制名单。

主要功能

  1. 01创建、更新和删除联系人
  2. 02批量导入与导出联系人
  3. 03管理列表、细分和自定义字段
  4. 04为联系人记录自定义事件
  5. 05说明营销筛选与发送抑制的区别

适用场景

  1. 01维护营销活动受众名单
  2. 02将 CRM 或数据库同步到 Mailtrap
  3. 03清理联系人并导入 CSV 数据
  4. 04更新字段或触发自动化事件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mailtrap/mailtrap-skills --skill managing-contacts

安装后在 Claude Code 中输入/managing-contacts确认已加载。

详细介绍

管理 Mailtrap 联系人

概述

**生成 API 请求正文前：**请查看 Contacts OpenAPI 规范，了解当前字段名称、必需参数和嵌套结构。

联系人构成营销数据库，包括用于营销活动受众及相关工作流的列表、细分、自定义字段和导入功能。Contacts API 可自动创建和更新联系人，并可用于 CRM 或 CDP 同步（通过你的代码，或 Zapier、Make、n8n 等工具——请参阅导入联系人）。

抑制项（硬退信、垃圾邮件投诉、发送侧退订）位于发送产品中，会阻止这些地址在你的邮件流中接收邮件。这与营销筛选条件（细分、列表成员资格、同意标记）分开应用，后者用于决定哪些联系人符合营销活动的条件。如需了解发送侧拦截，请参阅抑制项和 skill sending-emails。

相关 skill：authorizing-api-requests（令牌、环境变量、account_id 解析）、sending-emails（实时发送路径）。

适用场景

  • 以编程方式管理联系人（创建、更新、批量导入）
  • 与 CRM 或数据仓库同步
  • 清理联系人列表并导入 CSV
  • 使用自定义字段更新联系人，或触发自定义事件以用于自动化流程
  • 使用细分和自定义字段来构建受众

授权

以下所有端点都需要 Authorization: Bearer $MAILTRAP_API_TOKEN，并且路径中需要 $MAILTRAP_ACCOUNT_ID。有关令牌范围、存储方式以及用于从 GET https://mailtrap.io/api/accounts 解析 $MAILTRAP_ACCOUNT_ID 的单行命令，请参阅 skill authorizing-api-requests。

端点（替换占位符）

操作方法URL参考
创建 / 获取 / 更新 / 删除联系人多种https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts联系人
批量导入（异步任务）POSThttps://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/imports批量导入
联系人列表多种https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/lists联系人列表
自定义字段多种https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/fields联系人字段
自定义事件POSThttps://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/{contact_identifier}/events联系人事件
导出联系人多种https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/exports导出联系人
  • 典型速率限制：每个账户每 60 秒 200 个请求；大量导入时优先使用批量导入。
  • **批量导入限制：**每次导入请求最多 50,000 个联系人（异步任务）；使用 GET .../contacts/imports/{import_id} 轮询导入状态。参见批量导入。

示例（curl）

创建单个联系人（含自定义字段）
curl -X POST "https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts" \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "contact": {
      "email": "[email protected]",
      "fields": {"first_name": "John", "last_name": "Smith", "company": "Example Inc"},
      "list_ids": [1, 2, 3]
    }
  }'
批量导入（联系人数组）
curl -X POST "https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/imports" \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "contacts": [
      {"email": "[email protected]", "fields": {"first_name": "John"}, "list_ids_included": [1, 2]},
      {"email": "[email protected]", "fields": {"first_name": "Jane"}, "list_ids_included": [1]}
    ]
  }'
自定义事件（事件名称 + 载荷）
curl -X POST "https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/{contact_identifier}/events" \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"name": "UserLogin", "params": {"user_id": 101, "is_active": true}}'

概念

  • 列表 — 明确定义的联系人列表。
  • 细分 — 动态分组；参见细分。
  • 自定义字段 — 名、姓或会员等级等属性；参见自定义字段。
  • 自定义事件 — 使用 POST .../events，并通过事件 name 和 params 对象配置自动化。

CRM 和同步

营销活动用例

联系人是营销活动的基础：在此维护干净的列表、同意状态和属性；营销活动的创建和排期是产品功能，相关文档见营销活动。

常见错误

错误修复
逐条创建触发速率限制批量加载时使用 /contacts/imports（每个请求最多 50k），并采用退避策略
将营销联系人视为发送抑制对象在发送流中使用 抑制项 来阻止向收件人发送邮件

评论

支持 Markdown