通过 Send API 发送互动事务邮件

收据和确认邮件是客户打开最多的邮件。在工作室里设计一次,通过 Send API 从后端发送,每张收据都能询问订单体验并推荐下一件商品。

主题

Your order receipt

收据和确认邮件是客户打开最多的邮件。用和营销活动相同的互动模块,通过 Send API 从后端发送,每张收据都能询问订单体验并推荐下一件商品。

收据在购买后几乎会送到每一位客户手中。这让它成为放一个快速评分、一份补充装或一个下次优惠码的最佳位置,前提是它和普通收据一样容易发送。

设计一次,从后端发送

在工作室里像普通邮件一样搭建收据,加入 {{order_number}} 等合并标签和你想要的模块:

  • 评分:用星级或表情脸问“订单体验如何?”。设置 评分不高于此值时追问,低分时会打开一个询问问题所在的简短问题。
  • 商品:相关商品或补充装,在收据里点 立即购买 即可购买。
  • 优惠券:下次订单可用的优惠码,一点即可复制。
  • 按钮:订单状态、发票或客服。

然后你的后端用邮件的 projectId 和包含该订单数值的 mergeData 对象(最多 100 个字段)调用 POST /api/v1/send。参见 API 参考中的模板。

无论用哪个应用阅读,每位客户都能在收据中评分、购买和点击。

与联系人关联

如果客户已经是你的联系人,收据会关联到他:传入 listId,或让 MailInApp 在你的列表中查找地址。这样他的评分会记入他的活动和互动分数,可以填写联系人字段、开始旅程,会议预约也只需点一下。参见 API 参考。

为生产环境而设计

  • type: "transactional"(默认)也会送达已退订营销邮件的客户,因为他们仍然需要收据。退信的地址会被跳过。参见事务性与营销性对比。
  • Idempotency-Key:用同一个键重试的调用会返回第一次的结果,每位客户只收到一张收据。参见幂等性。
  • 限制:每个 API 密钥有每分钟上限,你的套餐包含每月一定数量的 Send API 调用。最近的调用会列在 开发者 页面上。
  • 无需代码:Zapier 的 Send Transactional Email 操作和 n8n 节点以同样方式发送。
  • 一次性验证码:发送 html 或 text 代替 projectId,邮件会原样发出。

你会收到什么

评分、点击和购买会像任何营销活动一样出现在邮件的 洞察 中,你的 Webhook 会在每条到达时立即转发到你的系统。低分提醒会在客户给订单打低分时通知你,当天就能有人联系客户。

开始使用

在工作室中搭建一张带评分的收据,在 开发者 中创建 API 密钥,再用你的 projectId 和 mergeData 调用 POST /api/v1/send。快速入门会带你完成第一次调用。

典型的构建与发送流程

  1. 1

    在工作室设计收据

    像普通邮件一样搭建,加入评分、商品或优惠券,以及 {{order_number}} 等合并标签。

  2. 2

    创建 API 密钥

    在“开发者”中创建一个带名称的 API 密钥。每次调用都把它作为 Bearer 令牌发送。

  3. 3

    调用 Send API

    你的后端向 /api/v1/send 发送 POST,带上邮件的 projectId 和包含该订单数值的 mergeData 对象。

  4. 4

    查看返回的数据

    评分、点击和购买会出现在邮件的洞察中,你的 Webhook 会在每条到达时立即转发。

常见问题

通过 API 发送的邮件能包含和营销活动相同的互动模块吗?

可以。模板模式会按你指定的工作室邮件生成内容,包含每个模块,与从控制台发送完全相同。

订单数据如何进入邮件?

通过 mergeData:一个最多 100 个字段的扁平对象,只为这一次调用填充邮件中的 {{field}} 合并标签。再传入 listId,如果客户已经是联系人,邮件就会关联到他,他的评分会记入他的活动。

transactional 和 marketing 有什么区别?

type 字段决定检查哪个退订名单。默认的 transactional 也会送达已退订营销邮件的客户,因为他们仍然需要收据。marketing 的行为与营销活动相同。两者都会跳过退信的地址。

Send API 有哪些限制?

每个 API 密钥有每分钟上限,你的套餐包含每月一定数量的 Send API 调用(Free 为 500),每次发送都计入套餐的每月邮件数。使用 Idempotency-Key 请求头,重试的调用会返回第一次的结果,每位客户只收到一张收据。

能通过同一个接口发送自己的 HTML 吗?

可以。发送 html 或 text 代替 projectId,邮件会原样发出。这适合一次性验证码;互动模块请使用模板模式。

在工作室中构建它

从免费套餐开始——每个套餐都包含全部互动模块和完整的降级引擎。