Zalify · 开发者

从终端到独立站,使用 Zalify 高效构建。

面向开发者与 AI 智能体的正式资源入口,覆盖 Zalify CLI、第一方数据追踪及机器可读产品指引。

智能体执行路径

01

zalify brand init

02

zalify brand validate

03

zalify shop create

04

zalify ads report

官方资源

以正式发布的规范为准。

以下资源均已公开发布并支持抓取,同时明确标注 Zalify 产品名称,便于用户、搜索引擎与智能体定位同一权威信息源。

01

CLI

Zalify CLI 命令参考

完整说明品牌、店铺、广告与主题操作所需的命令模型、认证流程、标准执行路径及本地文件规范。

打开 cli.txt

02

集成

Zalify Pixel 实施指南

完成第一方数据追踪、Shopify 集成、访客同意管理,并向支持的广告平台回传转化事件。

查看 Pixel 文档

03

发现

Zalify 智能体与爬虫资源

通过 llms.txt 获取适用场景指引,通过 Markdown 版本读取精简内容,并通过 XML 站点地图发现完整 URL。

打开 llms.txt

04

版本

Zalify CLI 更新日志

CLI 每个已发布版本的重点更新和其他改动,最新版本在前,与 zalify changelog 输出的内容相同。

查看更新日志
事件 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 确认当前支持范围。

联系 Zalify