核心用法
signup_lead 是一个用于外部 CRM 集成的数据提交技能,通过调用 AgenticCreed 的公开 HTTPS 端点 https://gateway.agenticcreed.ai/signup-leads 创建新的潜在客户记录。使用时需预先配置 AGENTICCREED_API_KEY 环境变量进行身份验证。
参数说明
- 必填项:
email、firstName、lastName—— 构成潜在客户的基本身份标识 - 选填项:
address、dateOfBirth、phoneNumber、whatsAppNumber、jobTitle、dateOfJoining—— 用于完善用户画像,支持 ISO 格式日期
典型工作流
1. 在对话或表单中收集用户信息
2. 调用技能并传入结构化参数
3. 数据经 TLS 加密传输至 AgenticCreed 网关
4. 后端返回确认后可用于后续营销自动化或销售跟进
显著优点
- 标准化集成:直接对接官方 Gateway,无需自行封装 API 客户端
- 字段覆盖全面:同时支持传统联系方式与 WhatsApp 等新兴渠道
- 环境变量认证:API Key 与代码分离,降低硬编码泄露风险
潜在缺点与局限性
- 厂商锁定:数据仅能提交至 AgenticCreed 生态,无法一键切换至其他 CRM
- 单向同步:仅支持创建(POST)操作,无查询、更新或删除能力
- 依赖外部服务:网关可用性与网络延迟直接影响调用成功率
- 字段扩展性受限:固定 schema,无法自定义业务字段
适合人群
- 使用 AgenticCreed 作为核心 CRM 的销售团队
- 需要自动化线索录入的营销自动化场景
- 快速原型验证阶段,希望减少后端开发量的产品团队
常规风险
- 传输层依赖 TLS:虽默认加密,但需确保证书配置正确,防范中间人攻击
- API Key 管理:环境变量若权限配置不当(如容器镜像泄露、日志打印),可导致未授权提交
- 数据合规:收集 PII(生日、地址、电话)需确保符合 GDPR/CCPA 等隐私法规
- 无内置重试机制:网络异常时需调用方自行实现幂等重试,避免重复线索