用途:帮助构建 Qwilr 与 CRM、其他工具的自动化连接,减少手动复制交易数据到提案的工作。
主要能力:可用原生集成(HubSpot、Salesforce、Pipedrive)自动填充模板并回写接受状态;用 Zapier/Make 做多工具工作流;或直接调用 Qwilr REST API 实现自定义逻辑、高并发与条件化内容。API 基础地址 https://api.qwilr.com/v1,使用 JWT Bearer 认证;关键端点包括 POST /pages、GET /blocks/saved、POST /webhooks。可通过 webhook 订阅 pageFirstViewed、pageViewed、pageAccepted、pagePartiallyAccepted 等事件,并用 GET /pages/{id}?expand=acceptance,metadata 查询状态。
使用方式:先明确要自动化的目标(自动建提案、状态回写、查看通知、完整往返)、所用 CRM 和平台;再据复杂度和成本选择原生集成、Zapier/Make 或直接 API。构建时先 GET /blocks/saved 获取 block id,再用 POST /pages 传入 templateId 或 blocks 数组,替换变量放在顶层 substitutions(仅字符串),用 published(非 isPublished)控制发布,报价区块需放在保存的区块内。
限制:Qwilr API 需 Enterprise 账户开通 API 访问并另付费用,未开通应改用原生集成或 Zapier;substitutions 不做格式化,日期与金额须预先格式化为最终字符串,缺失变量渲染为空;webhook 可能重试,处理逻辑需按事件 ID 幂等;各部分字段名(如 Salesforce __c、HubSpot 内部属性名)需自行核实;令牌应使用环境变量 $QWILR_TOKEN,不得硬编码。上线前应先用 published: false 与测试数据端到端验证。