文档菜单

Zapier

把 MailInApp 连接到 Zapier 上的数千个应用:把新的潜在客户写进表格、把已预约的会议发到 Slack、商机赢单时在 CRM 中建记录,或在别处发生某件事时把联系人加入 MailInApp。

英文视频

MailInApp 的 Zapier 应用

MailInApp 已上架 Zapier 应用目录:zapier.com/apps/mailinapp/integrations。你可以用 API 密钥连接,并从菜单中选择触发器和操作,无需复制任何 URL:

  • 触发器:每个账户事件对应一个,包括 New Lead、Lead Turned Hot、Meeting Booked、Deal Stage Changed、Form Submitted、Purchase Completed、Journey Completed 和 Response Completed。
  • 操作:Create or Update Contact、Trigger Journey、Create Deal、Update or Move Deal 和 Send Transactional Email。
  • 搜索:Find Contact,可与创建组合成 “Find or Create Contact”。

把 MailInApp 连接到 Zapier

  1. 在 MailInApp 中前往 开发者,点击 创建密钥。用集成的名称命名,例如 “Zapier”。复制以 mia_live_ 开头的密钥,它只会显示一次。如果 创建密钥 被锁定,说明你当前的套餐还不包含 API 密钥。密钥的工作方式见 API 密钥。
  2. 在 Zapier 中新建一个 Zap,选择 MailInApp 作为触发应用或操作应用。
  3. Zapier 要求连接账户时,把密钥粘贴到 API Key 字段。
  4. 选择触发器或操作。列表、旅程、商机和销售管道等菜单会根据你的账户内容自动填充。
  5. 点击 Test trigger 或 Test action,然后开启 Zap。

该密钥拥有整个 MailInApp 账户的权限,请像对待密码一样保管。在 开发者 中吊销它后,Zapier 将断开连接,它设置的触发器也会停止。

在 MailInApp 中开始一个 Zap

你也可以不离开 MailInApp 就开始。在 开发者 页面,API 密钥下方的 Zapier 卡片会显示:

  • 适用于 MailInApp 的现成模板,例如把新的潜在客户添加到 Google Sheets,或把已预约的会议发到 Slack;
  • 一个输入框:用自己的话描述想自动化的事情,Zapier 会建议一个 Zap;
  • 从零开始创建 Zap 的入口;
  • 登录 Zapier 后,你正在使用 MailInApp 的 Zap。

开发者页面上的 Zapier 卡片,显示 MailInApp 的 Zap 模板

选择一个模板,Zapier 会在页面上方打开。登录 Zapier 或创建 Zapier 账户后,Zap 编辑器会打开,模板已经填好。要求连接 MailInApp 时,按上面第 3 步粘贴 API 密钥,然后测试 Zap 并开启它。

卡片里的所有内容都来自 Zapier:模板、登录和编辑器使用的都是 Zapier 自己的文字。MailInApp 不会把你的邮箱地址或其他信息传给 Zapier,登录 Zapier 由你自己完成。

如果你的套餐不包含 API 密钥,卡片会提示你。你仍然可以浏览模板,但升级前 Zap 无法连接。如果卡片提示 Zapier 模板无法加载,可能是浏览器扩展拦截了它们。这时请用卡片中的链接在 Zapier 上打开 MailInApp。

不使用 MailInApp 应用(进阶)

在 Zapier 中使用 MailInApp 并不一定需要这个应用。Zapier 内置的 Webhooks by Zapier 应用可以处理同样的事件。如果你只需要某一封邮件的互动,比如某份调查的每条回答,或者想自己管理 URL,它是合适的选择。

把 MailInApp 事件发送到 Zap

  1. 在 Zapier 中新建一个 Zap,触发应用选 Webhooks by Zapier,事件选 Catch Hook。复制 Zapier 给出的 URL。
  2. 在 MailInApp 中前往 开发者 → Webhook。把 URL 粘贴为 端点 URL,勾选这个 Zap 需要接收的事件,点击 添加 Webhook。如果之后打算验证签名,请保存签名密钥。
  3. 在新的 Webhook 上点击 发送测试,然后在 Zapier 中点击 Test trigger。你会看到示例事件,包括 type 以及 data 中的每个字段,例如联系人的邮箱或商机的阶段。
  4. 添加操作步骤,映射需要的字段,然后开启 Zap。

所有事件的结构都相同:一个 id、一个 type、一个 createdAt 时间和一个 data 对象。Webhook 页面列出了每个事件及其字段。如果同一个 Catch Hook 接收多种事件,请添加一个按 type 过滤的 Filter by Zapier 步骤,或者为每个 Zap 单独创建一个 Webhook。

只需要某一封邮件的互动?请把 Catch Hook URL 粘贴到这封邮件的“洞察 › 设置”中的项目 Webhook 中。

从 Zap 操作 MailInApp

使用 Webhooks by Zapier → Custom Request 操作,在 Authorization: Bearer mia_live_… 请求头中带上 API 密钥,调用 MailInApp API。例如:

  • 添加或更新联系人(在别处填写表单时):POST /api/v1/contacts。
  • 创建商机(潜在客户在其他工具中预约通话时):POST /api/v1/deals。请设置 Idempotency-Key 请求头(例如另一工具中的记录 ID),避免 Zap 重试时创建第二个商机。
  • 把联系人加入触发器为 API 调用的旅程:POST /api/v1/journeys/{id}/trigger。
  • 发送收据或通知:POST /api/v1/send,并指定 "type": "transactional"。不要从 Zap 发送营销邮件:Zap 无法证明收件人已经同意。

投递失败时

Zap 被暂停或删除,或 Zapier 出现故障,都算作投递失败。MailInApp 会在数小时内自动重试。事件本身总是先保存在 MailInApp 中,所以在 MailInApp 这一侧不会丢失任何东西。

获取帮助

  • Zap 不能正常工作,比如某个步骤报错,或触发器在 Zapier 中没有触发:请到 zapier.com/app/get-help 向 Zapier 求助。只有 Zapier 能看到 Zap 的任务历史。
  • MailInApp 本身出了问题,比如无法创建密钥、Webhook 出现投递失败,或事件始终没有到达:请联系 MailInApp 支持。