SuperAPI AI 工具集

intercom-ci-integration

部署与运维

查看项目

更新于 10-15 23:26

技能介绍

用途:为 Intercom 集成搭建 GitHub Actions CI/CD 流水线,覆盖自动化测试、密钥配置与 Webhook 校验。

主要能力:提供两个作业的流水线——unit-tests 在每次 push 和 PR 运行,使用完全模拟的 intercom-client,无需令牌;integration-tests 仅在 main 分支 push 时运行,先探测 https://api.intercom.io/me,非 200 即失败。另含 Webhook 签名验证测试(使用 crypto.timingSafeEqual 常量时间比较,无需网络)。

使用方式:前置条件为启用 Actions 的 GitHub 仓库、与生产分离的 Intercom 开发工作区访问令牌、已安装 intercom-client 的 npm/pnpm 项目。CI 仅使用开发令牌,存为加密 secret INTERCOM_DEV_TOKEN,并以 INTERCOM_ACCESS_TOKEN 环境变量暴露给集成作业;Webhook 使用单独的 INTERCOM_WEBHOOK_SECRET。配置命令:gh secret set INTERCOM_DEV_TOKEN --body "dG9rOmRldl90b2tlbl9oZXJl",随后 gh secret list 确认。产出文件包括 .github/workflows/intercom-ci.yml、tests/unit/intercom-service.test.ts、tests/integration/contacts.integration.test.ts 及 Webhook 签名测试。集成测试用 describe.skipIf(!token) 在无令牌时自动跳过,并在 afterAll 清理创建的 contact。

适用场景:为已有仓库添加 Intercom CI、在 CI 中验证 Webhook 处理。

限制:完整工作流 YAML、密钥设置与测试套件位于 references/ 目录;未提供具体版本、价格或平台支持范围等信息。