SuperAPI AI 工具集

customer-io

营销与增长

查看项目

更新于 10-16 02:36

技能介绍

用途:面向 Customer.io 行为邮件与消息平台的操作技能,适用于行为邮件、生命周期邮件、触发式消息等场景。

主要能力:通过 Pipelines API(cdp.customer.io)识别或更新用户画像、追踪行为事件以触发自动化活动或旅程;通过 App API(api.customer.io)发送事务性邮件、按条件搜索用户、删除用户、列出分群。

使用方式:两套 API 使用不同凭据。Pipelines API 使用 Basic 认证,值为 base64(site_id:track_api_key),请求体写入 /tmp/cio_request.json 后用 curl 提交,例如识别用户 POST https://cdp.customer.io/v1/identify,追踪事件 POST https://cdp.customer.io/v1/track。App API 使用 Bearer $CUSTOMERIO_APP_TOKEN,例如发送邮件 POST https://api.customer.io/v1/send/email、删除用户 DELETE https://api.customer.io/v1/customers/<person-id>、搜索用户 POST https://api.customer.io/v1/customers、列出分群 GET https://api.customer.io/v1/segments。事务性邮件需替换 <transactional-message-id>,该 ID 可在 Customer.io 的 Journeys > Transactional 模板 URL 或代码示例标签中找到。

排障:请求失败时可运行 zero doctor check-connector --env-name CUSTOMERIO_TRACK_TOKEN 或 zero doctor check-connector --url https://cdp.customer.io/v1/identify --method POST。

限制与约定:userId 应使用稳定唯一标识,用户可改邮箱时不要用邮箱作主 ID;事件名按惯例用 snake_case;限流为每秒 100 请求(公平使用),遇 HTTP 429 应实现指数退避;默认区域用 api.customer.io,EU 区域用 api-eu.customer.io 与 track-eu.customer.io。