ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Demio 集成实战指南:在 marketing-skills 仓库中用 REST API 与 CLI 自动化 Webinar 注册和参与者跟踪

Demio 集成实战指南:在 marketing-skills 仓库中用 REST API 与 CLI 自动化 Webinar 注册和参与者跟踪 AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载本文围绕 marketing-skills 仓库中的 Demio 集成文档 及其配套的零依赖 CLI demio.js 展开系统讲解如何基于 Demio 官方 REST API 完成实时live、自动automated与按需on-demand三类 Webinar 的注册、排期查询、参与者跟踪等核心操作。读完本文你将掌握 API Key API Secret 的认证方式、全部常用端点的请求格式、事件与参与者数据模型、速率限制边界并能直接用仓库自带的demio.jsCLI 在终端里完成从健康检查到批量注册、从查询参与者到触发后续营销流程的完整闭环。Demio 是什么Webinar 平台的集成能力总览Demio 是一个面向营销场景的 Webinar 平台支持实时直播、自动化自动重播和按需点播三种形态内置注册页与参与者行为跟踪能力。在 集成文档 中Demio 的能力矩阵如下IntegrationAvailableNotesAPI✓Events、Registration、Participants、SessionsMCP-Not availableCLI✓demio.jsSDK✓PHP官方、Ruby社区与同一仓库收录的另一款 Webinar 工具 Livestorm 相比工具注册表 给出的定位是Demio 适合营销向 Webinar简单、专注Livestorm 则是完整的活动参与平台。这一区分决定了集成场景的侧重点——Demio 更适合把报名 → 到场 → 跟进这条营销链路程序化。从仓库角度看Demio 属于平台不自带 CLI、由本仓库补足的一类工具tools/clis/demio.js是一个单文件、零依赖的 Node.js 脚本专为 AI Agent 和脚本自动化设计。它没有 MCP Server所以 Agent 直接走 REST API 或调用本地 CLI 是两种主要接入方式。认证方式API Key API Secret 双头认证Demio API 的认证非常直接不需要 OAuth 流程类型API Key API Secret双凭证请求头Api-Key: {key}与Api-Secret: {secret}获取位置Account Settings API需要 Owner 权限官方文档托管在 Apiary 的 Public Demio API 文档所有请求都必须同时携带这两个请求头缺一不可。仓库的 CLI 实现 demio.js 在启动时就会强制校验这两个环境变量const API_KEY process.env.DEMIO_API_KEY const API_SECRET process.env.DEMIO_API_SECRET const BASE_URL https://my.demio.com/api/v1 if (!API_KEY) { console.error(JSON.stringify({ error: DEMIO_API_KEY environment variable required })) process.exit(1) } if (!API_SECRET) { console.error(JSON.stringify({ error: DEMIO_API_SECRET environment variable required })) process.exit(1) }凭证安全约定按照 tools/clis/README.md 的统一安全约定密钥绝不能硬编码进脚本所有 CLI 只从环境变量读取凭证把密钥写入 shell profile~/.bashrc/~/.zshrc或.env文件.env已在 gitignore 中但提交前仍需二次确认任何命令都可以加--dry-run预览请求而不真正发出凭证会被掩码为***快速上手安装并运行 demio CLIdemio.js是零依赖的 Node.js 单文件脚本Node 18使用原生fetch无需npm install。按照 tools/clis/README.md 提供三种运行方式方式一直接运行node tools/clis/demio.js ping方式二软链到全局目录ln -sf $(pwd)/tools/clis/demio.js ~/.local/bin/demio demio ping方式三把整个目录加入 PATHexport PATH$PATH:/path/to/marketingskills/tools/clis运行时先导出两个环境变量export DEMIO_API_KEYyour_api_key export DEMIO_API_SECRETyour_api_secret所有 CLI 遵循统一的命令模式{tool} resource action [options]输出为 JSON 到 stdout方便管道处理tools/clis/README.md# 管道给 jq 提取字段 demio events list --type upcoming | jq .[].name # 保存到文件 demio participants list --date-id 67890 participants.json # 在脚本中继续处理 EMAILS$(demio events list --type all | jq -r .[].name)demio.js内置的 usage 提示在无参数或命令错误时输出如下tools/clis/demio.jsping: ping events: events [list --type upcoming|past|all | get --id id | date --event-id id --date-id id] register: register [create --id event_id --name name --email email --date-id date_id] participants: participants [list --date-id id]常用 Agent 操作六大 REST API 端点详解集成文档tools/integrations/demio.md定义了 7 个常用操作下面逐一给出原始 HTTP 请求与等价的 CLI 命令。1. Ping健康检查验证凭证是否有效、服务是否可达GET https://my.demio.com/api/v1/ping Headers: Api-Key: {API_KEY} Api-Secret: {API_SECRET}CLI 等价命令node tools/clis/demio.js ping2. 列出所有事件GET https://my.demio.com/api/v1/events Headers: Api-Key: {API_KEY} Api-Secret: {API_SECRET}CLI 等价命令events list不传--type时即为全部node tools/clis/demio.js events list3. 按类型筛选事件GET https://my.demio.com/api/v1/events?typeupcoming Headers: Api-Key: {API_KEY} Api-Secret: {API_SECRET}CLI 等价命令node tools/clis/demio.js events list --type upcomingtype参数可取upcoming、past、all详见下文参数章节。4. 获取单个事件详情GET https://my.demio.com/api/v1/event/{event_id} Headers: Api-Key: {API_KEY} Api-Secret: {API_SECRET}CLI 等价命令node tools/clis/demio.js events get --id 12345注意端点路径的单复数差异列表端点是/events复数单个事件端点是/event/{event_id}单数。CLI 源码中的映射完全一致tools/clis/demio.jsevents list走/eventsevents get走/event/${id}。5. 获取事件某个日期的详情GET https://my.demio.com/api/v1/event/{event_id}/date/{date_id} Headers: Api-Key: {API_KEY} Api-Secret: {API_SECRET}CLI 等价命令node tools/clis/demio.js events date --event-id 12345 --date-id 67890CLI 对缺失参数做了显式校验--event-id或--date-id缺失会返回{ error: --event-id required }之类的错误对象tools/clis/demio.js。6. 为事件注册参会者POST https://my.demio.com/api/v1/event/register Headers: Api-Key: {API_KEY} Api-Secret: {API_SECRET} Content-Type: application/json { id: 12345, name: Jane Doe, email: janeexample.com }CLI 等价命令node tools/clis/demio.js register create --id 12345 --name Jane Doe --email janeexample.com7. 为事件指定日期注册参会者POST https://my.demio.com/api/v1/event/register Headers: Api-Key: {API_KEY} Api-Secret: {API_SECRET} Content-Type: application/json { id: 12345, date_id: 67890, name: Jane Doe, email: janeexample.com }CLI 等价命令多一个--date-idnode tools/clis/demio.js register create --id 12345 --date-id 67890 --name Jane Doe --email janeexample.com8. 获取某日期的参与者列表GET https://my.demio.com/api/v1/date/{date_id}/participants Headers: Api-Key: {API_KEY} Api-Secret: {API_SECRET}CLI 等价命令node tools/clis/demio.js participants list --date-id 67890API 模式与数据模型集成文档tools/integrations/demio.md总结了 Demio API 的几个核心特征所有请求都必须携带Api-Key与Api-Secret两个请求头响应均为 JSON 对象注册接口会返回join_link——这是参会者进入直播间的唯一加入链接事件包含多个 dates场次每个场次有独立的date_id——这解释了为什么注册和参与者查询都要以date_id为粒度事件指标Event Metrics字段含义id事件 IDname事件名称date_id场次/日期标识符status事件状态upcoming、past、activetype事件类型live、automated、on-demandregistration_url公开注册页 URL参与者指标Participant Metrics字段含义name参与者姓名email参与者邮箱status出席状态registered、attended、missedattended_minutes参与时长分钟join_link该参与者的唯一加入链接这两组指标正是注册 → 到场 → 跟进营销链路的数据基础status可以区分注册未到missed与真实到场attendedattended_minutes则用来量化参与深度为后续的 SDR 跟进或生命周期邮件提供触发条件。参数详解事件列表筛选参数type用于按时间窗口过滤事件列表upcoming— 即将开始的事件past— 已结束的事件all— 全部事件注册字段字段必填说明id是事件 IDname是注册者姓名email是注册者邮箱date_id否指定场次日期 IDref_url否用于跟踪的推荐/来源 URLCLI 对这组字段的解析在 tools/clis/demio.jsregister create会把--id或--event-id、--name、--email组装为基础 payload若传了--date-id或--ref-url则追加到 payloadconst payload { id, name, email } if (args[date-id]) payload.date_id args[date-id] if (args[ref-url]) payload.ref_url args[ref-url] result await api(POST, /event/register, payload)ref_url字段让 Agent 可以在注册请求里直接埋入渠道归因信息——例如落地页来源、广告 campaign 参数从而把 Webinar 报名转化直接关联到具体渠道这是做 Webinar 漏斗归因的关键钩子。自定义字段Custom Fields自定义字段通过其UID而非显示名传递需要到事件设置里查看可用的自定义字段 UID这条限制对自动化很重要如果直接按显示名传自定义字段注册请求会失败必须在事件配置中先取出 UID再在注册 payload 中按 UID 传值。CLI 源码剖析请求封装、dry-run 与命令分发demio.js的实现很简洁但覆盖了可审计、可预览、可脚本化三个 Agent 场景的关键设计。核心是一个统一的api(method, path, body)封装tools/clis/demio.jsasync function api(method, path, body) { if (args[dry-run]) { return { _dry_run: true, method, url: ${BASE_URL}${path}, headers: { Api-Key: ***, Api-Secret: ***, ... }, body: body || undefined } } const res await fetch(${BASE_URL}${path}, { method, headers: { Api-Key: API_KEY, Api-Secret: API_SECRET, Content-Type: application/json, Accept: application/json, }, body: body ? JSON.stringify(body) : undefined, }) const text await res.text() try { return JSON.parse(text) } catch { return { status: res.status, body: text } } }值得注意的实现细节--dry-run分支命中时不会真正发请求而是返回带_dry_run: true标记的请求快照且请求头中的密钥被掩码为***——这既方便 Agent 审计即将发出的请求也防止日志泄露凭证。容错解析先取原始文本能JSON.parse则返回对象解析失败时返回{ status, body }包裹原始响应保证非 JSON 错误响应如限流或 5xx不会让脚本崩溃。参数解析器parseArgs支持--key value与裸布尔 flag 两种形态并把非 flag 参数收集到_数组作为cmd/subtools/clis/demio.js。统一 JSON 输出最终console.log(JSON.stringify(result, null, 2))带缩进输出便于人类阅读也便于jq继续加工。从源码结构看命令分发是一个switch (cmd)三层结构顶层命令ping/events/register/participants→ 子命令如events下的list/get/date→ 参数校验。未知命令或子命令会返回错误对象并附带完整 usage符合 tools/clis/README.md 定义的仓库级 CLI 规范。速率限制与配额集成文档tools/integrations/demio.md给出的官方限制如下180 requests / 分钟约 3 次/秒Free Trial每天 100 次 API 调用付费套餐每天 5,000 次 API 调用UTC 零点重置需要更高每日配额需联系 Demio 申请超过限制会返回错误响应对 Agent 自动化脚本的意义在于批量注册或批量拉取参与者时需要在循环内做节流例如每批 50 个请求之间 sleep 1~2 秒并把限流错误响应纳入重试逻辑。由于响应是 JSON 错误对象CLI 的容错解析返回{ status, body }恰好能在这种情况下把 HTTP 状态码保留下来供调用方判断。典型应用场景与关联技能集成文档列出的适用场景tools/integrations/demio.md集中在 Webinar 营销漏斗的自动化从落地页或表单自动触发 Webinar 注册对应register create将 Webinar 参会者数据同步进 CRM对应participants list 后续写入为 Webinar 构建自定义注册流程跟踪 Webinar 出席与参与度status、attended_minutes基于出席状态触发跟进序列如missed用户触发重播提醒、attended用户触发转化邮件程序化管理多个 Webinar 场次events list --type upcomingevents date在仓库的技能体系中该集成文档声明了以下相关 Skillstools/integrations/demio.mdwebinar-marketing、lead-generation、event-marketing、content-strategy、lifecycle-marketing。此外仓库的营销参考资料中也能看到 Demio 的身影在 合作营销类型参考 中Demio 以50% 佣金的推广合作模式出现在 病毒式裂变机制参考 中Demio 与 Cometly 一起被用作围绕发布窗口集中发力联盟推广的战术案例——这两处可以视为 Demio 在 Webinar 增长玩法中的延伸应用背景。集成路径速查需求文档/代码说明官方集成指南认证、端点、参数、限流tools/integrations/demio.md本仓库的权威来源CLI 源码请求封装、dry-run、usagetools/clis/demio.js零依赖 Node 18 单文件CLI 安装与通用约定tools/clis/README.md环境变量、软链、PATH、JSON 输出工具注册表Webinar 分类与选型tools/REGISTRY.mdDemio vs Livestorm 定位对比小结Demio 的 REST API 是一套结构非常规整的接口双请求头认证、JSON 响应、注册返回join_link、事件以date_id为场次粒度。配合仓库自带的 demio.js CLIAgent 可以在终端中一条命令完成健康检查、事件查询、参会者注册与参与者跟踪再结合--dry-run审计每次请求、结合ref_url埋入归因、结合status/attended_minutes驱动生命周期跟进——足以支撑一条从报名到到场再到跟进转化的完整 Webinar 营销自动化链路。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐Marketing Skills 仓库中的 Beehiiv 集成指南用 REST API v2 与 CLI 构建 Newsletter 自动化工作流Marketing Skills 仓库中的 Beehiiv 集成指南用 REST API v2 与 CLI 构建 Newsletter 自动化工作流 本文面向AI 技能人工智能Vuetify v-card 卡片组件实战指南从基础用法到源码级原理Vuetify v card 卡片组件实战指南从基础用法到源码级原理 v card 是 VuetifyVue 组件框架中最常用的内容容器组件它基于 vAI 技能人工智能Slang 自主测试生成战役模式Campaign Mode协议解析基于文档声明驱动的 conformance / design 双层测试套件Slang 自主测试生成战役模式Campaign Mode协议解析基于文档声明驱动的 conformance / design 双层测试套件 本文深入解析AI 技能人工智能上一篇Feast Feature Transformation 全解析三大引擎、UDF 与聚合/过滤/关联 API 实战指南下一篇Rerun BarChartView 视图完全指南柱状图蓝图的属性、数据流与源码实现解析创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表