Zapier

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

MailInApp 的 Zapier 应用

MailInApp 官方 Zapier 应用目前正在接受 Zapier 的审核，尚未出现在其应用目录中。上架后，你可以用 API 密钥连接，并从菜单中选择触发器和操作，无需复制任何 URL：

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

应用上架后，本页会链接到它的应用页面。在此之前，下面的方法现在就可以通过 Zapier 内置的 Webhooks by Zapier 应用使用。

把 MailInApp 事件发送到 Zap

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