关于 kapso-api
用于 Kapso Platform API 操作的技能,涵盖客户接入、生成设置链接、配置电话号码以及检测 WhatsApp 连接。面向将客户设置和号码配置纳入工作流的开发者。
主要功能
- 01创建客户和设置链接
- 02配置电话号码开通
- 03通过 Webhook 或重定向检测 WhatsApp 连接
- 04使用 phone_number_id 作为 WhatsApp 标识
适用场景
- 01为客户开通 WhatsApp
- 02生成客户设置链接
- 03在注册时配置电话号码
- 04检测 WhatsApp 连接是否建立
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ gokapso/ agent-skills --skill kapso-api安装后在 Claude Code 中输入/kapso-api确认已加载。
详细介绍
Kapso 平台 API
适用场景
在执行平台 API 操作时使用此技能:创建客户、生成设置链接、配置电话号码,或检测 WhatsApp 连接。
设置
基础主机:https://api.kapso.ai(脚本会追加 /platform/v1)
认证标头:
X-API-Key: <api_key>
操作指南
为客户开通服务
- 创建客户:
POST /customers - 生成设置链接:
POST /customers/:id/setup_links - 客户完成嵌入式注册
- 使用
phone_number_id发送消息
检测连接
选项 A:项目 Webhook whatsapp.phone_number.created
选项 B:成功重定向 URL 查询参数
同时使用两种方式可获得最佳用户体验和后端可靠性。
配置电话号码
创建设置链接时,设置:
{
"setup_link": {
"provision_phone_number": true,
"phone_number_country_isos": ["US"]
}
}
注意事项
- 平台 API 基础路径:
/platform/v1 - Meta 代理基础路径:
/meta/whatsapp/v24.0(用于消息和模板) - 使用
phone_number_id作为 WhatsApp 的主要标识符
参考资料
- references/platform-api-reference.md - 完整的端点参考
- references/getting-started.md - 初始设置指南
- references/setup-links.md - 设置链接配置
- references/detecting-whatsapp-connection.md - 连接检测方法
相关技能
kapso-automation- 工作流自动化whatsapp-messaging- WhatsApp 消息和模板whatsapp-flows- WhatsApp Flowskapso-ops- 运维和 Webhook
评论
支持 Markdown