SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场sales-typeform

sales-typeform

办公与效率

查看项目

更新于 10-16 04:19

技能介绍

用途

本技能是 Typeform 平台的使用帮助，面向需要搭建或运营 Typeform 表单、问卷、测验、视频表单的用户，提供从建表、提量、集成、嵌入到 API 调用的指引，并帮助排查常见故障。

主要能力

  • 表单/问卷/测验搭建：新建 typeform、题型、逻辑跳转（logic jumps）、设计。
  • 提升回复率：表单完成率、UX 优化、问题流程。
  • 集成：CRM、邮件平台、Zapier、Webhook、API。
  • 网站嵌入：Embed SDK、弹窗（popup）、滑块（slider）、浮层（popover）、隐藏字段（hidden fields）。
  • API 使用：Create API、Responses API、Webhook、以编程方式管理表单。
  • 故障排查：表单不加载、回复缺失、Webhook 失败、额度超限。
  • 套餐选择：价格对比、回复额度、功能差异。
  • 其他：Workflow Builder、视频表单、联系人、分析。

使用方式

技能按步骤引导：

  1. 收集上下文：若存在 references/learnings.md 会先读取；确认用户目标（建表、提量、集成、嵌入、API、排障、选套餐等）与当前套餐。若用户提示已含足够上下文，则跳过此步。
  2. 路由或直接回答：通用问卷/反馈策略路由到 /sales-customer-feedback；完整漏斗架构路由到 /sales-funnel；对接 CRM/邮件等路由到 /sales-integration；提交后邮件营销路由到 /sales-email-marketing；表单提交线索评分路由到 /sales-lead-score；表单之外的结账优化路由到 /sales-checkout。路由时给出确切命令，例如："This is a {problem domain} question — run: /sales-{skill} {user's original question}"。若为 Typeform 专属问题，进入下一步。
  3. 平台参考：读取 references/platform-guide.md 获取完整平台参考（模块、定价、集成、数据模型、工作流）；若涉及 API，另读 references/typeform-api-reference.md。只使用相关章节作答，不整篇倾倒。
  4. 可执行建议：聚焦用户具体情境给出建议。

关键操作要点

  • 回复额度：所有表单共享同一账号额度。可归档旧表单、关闭已完成活动或升级套餐。额度用满 100% 时表单自动转为 Private。
  • 逻辑跳转：谨慎使用，复杂分支是"表单显示错误问题"的首要来源；添加逻辑后逐条路径测试。
  • 嵌入：使用 Embed SDK（@typeform/embed）而非原始 iframe；SDK 处理响应式尺寸、隐藏字段和加载事件。
  • Webhook：必须在 30 秒内返回 2XX。慢端点应立刻确认并异步处理。持续失败后 Webhook 会自动禁用。
  • API 速率限制：每账号每秒 2 次请求，Create 与 Responses API 共用；批量操作需排队。
  • 若发现 references/learnings.md 未覆盖的坑点、变通方法或技巧，可追加到该文件。

适用场景

  • 客户调研、NPS/CSAT 等反馈收集。
  • 线索捕获与营销活动表单。
  • 将表单数据接入 CRM、邮件或自动化工具。
  • 在落地页嵌入表单并传递 UTM 等隐藏字段。
  • 通过 API 程序化管理表单与回复。

限制与注意事项

  • 回复额度按账号共享，非按表单计算；Basic 的 100 条/月是总量。
  • 额度用满后表单自动转 Private，无预警；下一计费周期或升级后自动恢复公开。
  • Webhook 持续失败会自动禁用：24 小时内 100% 失败（300+ 次尝试）或 5 分钟内（100+ 次尝试）会静默禁用。
  • EU 账号使用不同 API 基础 URL：api.eu.typeform.com，而非 api.typeform.com；用错端点会导致认证错误。
  • 速率限制按账号而非按 API key 计算，多个集成共享同一账号会互相限流。
  • Webhook 重试策略因错误码而异：404/410 不重试并立即禁用；429/408/503 每 2-3 分钟重试，持续 10 小时；其他错误指数退避（5 分钟 → 4 小时）。
  • 移除 Typeform 品牌需付费套餐；免费及低阶套餐显示 Typeform 徽标。
  • Python SDK 已弃用，官方 typeform-python-sdk 已归档；应使用 JS SDK（@typeform/api-client）或直接 REST 调用。
  • 上述坑点为基于调研的最佳努力整理，涉及套餐限制功能与集成坑点可能已过时，需复核。

相关技能

  • /sales-customer-feedback：问卷策略、NPS/CSAT/CES、回复率优化、VoC 项目设计、工具对比。安装：npx skills add sales-skills/sales --skill sales-customer-feedback
  • /sales-funnel：完整漏斗策略，Typeform 表单是数据捕获环节。安装：npx skills add sales-skills/sales --skill sales-funnel
  • /sales-jotform：Jotform 平台帮助，含支付表单、审批流、API 的替代表单构建器。安装：npx skills add sales-skills/sales --skill sales-jotform
  • /sales-integration：通过 Webhook、Zapier/Make 或 API 将 Typeform 接入 CRM、邮件等。安装：npx skills add sales-skills/sales --skill sales-integration
  • /sales-surveymonkey：SurveyMonkey 平台帮助，含分析、收集器、API 的替代问卷工具。安装：npx skills add sales-skills/sales --skill sales-surveymonkey
  • /sales-qualtrics：Qualtrics XM 平台帮助，企业级问卷/体验管理。安装：npx skills add sales-skills/sales --skill sales-qualtrics
  • /sales-do：不确定用哪个技能时的路由器，将任意销售目标匹配到合适技能。安装：npx skills add sales-skills/sales --skill sales-do

示例

  1. 活动中途额度用满：Basic 套餐 100 条/月为所有表单共享。可选升级到 Plus 或 Business、启用自动升级（额度达到时自动提升套餐），或关闭/归档其他消耗额度的活跃 typeform。未来活动应在启动前估算总回复量并选择合适套餐。
  2. Webhook 未送达端点：检查 Typeform 设置中的 Webhook 状态，可能因反复失败被自动禁用；确认端点 30 秒内返回 2XX；先用 webhook.site 等简单端点测试；端点慢则立即返回 200 并异步处理；检查 Webhook URL 格式及服务器是否接受 JSON 正文的 POST 请求。
  3. 嵌入表单并用隐藏字段做线索追踪：使用 Embed SDK（@typeform/embed）而非原始 iframe。在 typeform 中添加隐藏字段（Settings → Hidden Fields → 添加 utm_source、utm_medium、utm_campaign）。嵌入代码中传值：createWidget("formId", { container, hidden: { utm_source: getParam("utm_source"), utm_medium: getParam("utm_medium"), utm_campaign: getParam("utm_campaign") } })。隐藏字段值会出现在每条回复中，可通过 Responses API 获取或经 Webhook 发送到 CRM。

故障排查

  • "表单转 Private 且回复停止"：已达月度回复额度。检查 Settings → Billing → Usage。可选升级套餐、启用自动升级（Settings → Billing → auto-upgrade）或归档不活跃 typeform。账号下所有表单共享同一额度池。下一计费周期开始时表单自动恢复公开。
  • "新回复未触发 Webhook"：检查 Settings → Connect → Webhooks，确认 Webhook 已启用（未因失败被自动禁用）。独立测试端点，须在 30 秒内返回 2XX。端点返回 404/410 会立即禁用 Webhook 且不重试，修复 URL 后重新启用。若使用 EU 数据中心，确保 Typeform 账号区域与 API 端点匹配。
  • "编辑时 Typeform 加载慢或卡顿"：逻辑跳转多的复杂表单会拖慢编辑器，尽量简化分支。大图片/视频附件增加加载时间，上传前压缩图片。清除浏览器缓存并禁用扩展——广告拦截和隐私扩展会干扰 Typeform 编辑器与预览。若为嵌入，使用 Embed SDK 的懒加载，在用户滚动到表单时再加载。