官方资源
以正式发布的规范为准。
以下资源均已公开发布并支持抓取,同时明确标注 Zalify 产品名称,便于用户、搜索引擎与智能体定位同一权威信息源。
事件 API
发送自定义事件,触发邮件流程。
把网站、应用或后端里发生的事记录到 Zalify,例如测验结果、预约成功,商家即可在 Zalify 中用它开始、筛选和结束流程。事件名无需事先登记。
- 按 customer.externalId、email、phone 的顺序识别客户。新邮箱会新建联系人,但不会添加邮件订阅或同意记录。
- 为每个事件设置 uniqueId(或发送 Idempotency-Key 请求头)。重复发送同一事件会返回首次记录的结果并标记 duplicate: true,不会再次触发,重试是安全的。
- 批量请求每次最多 100 个事件。每个密钥共享每分钟 120 次请求的限额,一次批量请求计为 1 次。
- 发生时间超过一天的事件会被记录,但不会开始或结束流程。记录事件免费,流程只按发出的邮件计费。
- 需要在「设置 → 开发者」中创建勾选了「记录事件」权限的 API 密钥。
curl
curl -X POST https://app.zalify.com/api/v1/events \
-H "Authorization: Bearer $ZALIFY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event": "Quiz Completed",
"customer": { "email": "ada@example.com" },
"properties": { "result": "dry skin", "score": 82 },
"uniqueId": "quiz-session-8f2c"
}'@zalify/sdk 0.5
import { Zalify } from "@zalify/sdk";
const zalify = new Zalify(process.env.ZALIFY_API_KEY);
await zalify.events.track({
event: "Quiz Completed",
customer: { email: "ada@example.com" },
properties: { result: "dry skin", score: 82 },
uniqueId: "quiz-session-8f2c",
});可用范围
以正式文档为支持边界。
Zalify 公开 API 的 OpenAPI 规范发布在 https://app.zalify.com/api/v1/openapi,可读版参考文档见 https://app.zalify.com/api/v1/reference。Zalify MCP 服务已正式发布,地址为 https://app.zalify.com/api/mcp:Claude 等 MCP 应用可通过 Zalify 账号授权连接,查询工作区数据并起草内容。如需对接未公开的 API、Webhook 或合作伙伴集成,请先联系 Zalify 确认当前支持范围。