在互动经营工作台里建好一张小程序卡片后,有人会把它直接当成「小程序引导卡片模板」,准备拿去走接口发送。2026年11月20日(北京时间)阅读的抖音开放平台《小程序类型卡片概述》里,这两种对象是分开写的。该页写明:小程序引导卡片模板目前只支持 OpenAPI 发送,暂不支持互动经营工作台配置直接发送;基于小程序引导卡片模板创建的互动经营工作台小程序卡片,与卡片模板无映射关系,也不会随着模板相关配置的更改而更改。工作台里建出的那张卡片,并不能因此就当成引导卡片模板去发;模板后来改了,已经建好
的工作台卡片也不会自动跟着改。本题只讨论这两类对象能不能互相拿去发送、有没有映射,同一页上的小程序券卡片和主动私信授权卡片只作为边界提及,不再展开成类型总论。
《小程序类型卡片概述》把小程序引导卡片模板写成一种基于模板的消息发送方式:应用创建卡片模板时,只需传入卡片背景图、卡片标题、卡片文字描述等封面内容,在发送消息时再传入具体的卡片跳转地址。开发者首先需要通过创建小程序引导卡片模板接口,创建一个小程序卡片模板;再通过发送私信消息或发送群消息接口发送该模板,并在调用接口时传入具体的跳转链接。
同一页对互动经营工作台小程序卡片的写法不同。它的发送效果与引导卡片模板相同,但创建入口写在「互动经营工作台-小程序卡片管理界面」,并给出两种创建方式:通过模板创建,或直接创建。通过模板创建时,创建界面会预填入对应引导卡片模板的相关参数,包括卡片标题、小程序、卡片文案、卡片封面,小程序经营者还需要补充卡片名称以及跳转页面配置。直接创建则需填入卡片标题、小程序、卡片文案、卡片封面等所有参数。
因此,工作台里「已经建了一张小程序卡片」,只说明工作台侧有了一张按该页要求配置的小程序卡片,并不等于已经持有一张可按引导卡片模板那条路径去发送的模板。预填参数发生在创建界面,也不能单独用来证明两边已经是同一个可发送对象。
该页在引导卡片模板的注释里写得很明确:小程序引导卡片模板目前只支持 OpenAPI 发送,暂不支持互动经营工作台配置直接发送。也就是说,模板这一路,官方写出的发送方式是发送私信消息或发送群消息接口,并没有写成可以在互动经营工作台里直接配置发送。
2026年11月20日同时阅读的《创建/更新小程序引导卡片模板》也写了发送步骤:创建好卡片后,可通过发送私信消息接口进行小程序引导卡片发送。这与概述页同属「用接口发送模板」这一方向。需要并列记下的是,概述页写的是「发送私信消息/发送群消息接口」,接口页在这句话里只写了「发送私信消息接口」,两页并不完全相同,不能自行补成同一句,也不能据此写成工作台里建好的卡片可以拿去当模板发。概述页同样没有写:把工作台小程序卡片直接当作引导卡片模板,再用模板的接口去发送。
更容易混淆的,是工作台提供了「通过模板创建」这一方式。概述页随后用注释写清了边界:基于小程序引导卡片模板创建的互动经营工作台小程序卡片,与卡片模板无映射关系;互动经营工作台小程序卡片不会随着小程序引导卡片模板相关配置的更改而更改。
也就是说,创建时预填了模板上的标题、文案、封面等参数,并不表示此后两边仍保持同步。模板侧后来改了配置,不能指望工作台里已经建好的那张卡片自动变成新配置;也不能把工作台里改过的卡片,理解成对应的引导卡片模板已经更新。没有映射关系,也就不能把其中一边当成另一边的可发送替代物。
概述页还写:小程序引导卡片模板是以应用维度创建的,每个应用创建的小程序引导卡片模板上限为 10 万张;创建互动经营工作台小程序卡片,不会计入对应应用创建小程序引导卡片模板的数量。工作台里多建一张小程序卡片,并不能按该页理解成模板数量已经少了一张,也不能反过来把工作台卡片算进模板额度里。
《创建/更新小程序引导卡片模板》对上限另有一句:同一小程序,可以配置最多 10 万张小程序引导卡片模板,调用限制为近 30 天可创建或更新小程序引导卡片模板 5000 次。两页都出现了 10 万张这一上限,但一处写的是「以应用维度 / 每个应用」,一处写的是「同一小程序」,本文只并列转述,不自行说成同一口径。近 30 天 5000 次这一调用限制只出现在接口页,概述页没有写这一条,也不能把概述页没有出现的限制补回概述页。
比较稳妥的做法,不是看见工作台里有一张小程序卡片,就把它当成引导卡片模板去发,而是先对上官方已经分开写明的对象和发送方式。可以留下一组简单记录:
- 手里的对象,是引导卡片模板,还是互动经营工作台里的小程序卡片
- 若是引导卡片模板:官方写的发送方式是否落在 OpenAPI,也就是发送私信消息或发送群消息接口;该页同时写明,暂不支持在互动经营工作台配置直接发送
- 若是工作台小程序卡片:即使创建时选择了「通过模板创建」,官方仍写明它与卡片模板无映射关系,也不会随模板配置更改而更改
- 工作台卡片的创建数量,不计入引导卡片模板的数量;模板上限两页都写了 10 万张,但「每个应用」和「同一小程序」的表述要并列记下;近 30 天可创建或更新 5000 次只出现在接口页
- 同一概述页里的小程序券卡片、主动私信授权卡片是另外的消息类型,不能用来回答本题的发送方式和映射关系
这类核对只帮助判断对象和发送路径有没有对上,不能写成「按这份清单操作就一定能发出去」。本文未登录抖音开放平台或互动经营工作台,也未实际调用发送接口,不把某一次创建或发送结果写成已经验证的通用做法,也不表示任何第三方工具已经接入这些官方能力。
看到工作台里已经建好的小程序卡片,先不要把它收成「可以当引导卡片模板拿去接口发」。能分开的是:引导卡片模板目前只支持用接口发送,暂不支持在工作台直接发送;即便工作台卡片是基于模板创建的,官方也写了没有映射关系,并且不会随模板配置更改而更改。最终仍以当时对照官方原文核对的结果为准。
[1] 小程序类型卡片概述 https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/open-capabilities/management/private-domain/ma-card-type,访问日期 2026-11-20(北京时间)。页面未见面向读者展示的更新日期。该页写明小程序引导卡片模板目前只支持 OpenAPI 发送、暂不支持互动经营工作台配置直接发送;基于模板创建的工作台小程序卡片与卡片模板无映射关系,且不随模板配置更改而更改;创建工作台小程序卡片不计入模板数量;模板以应用维度创建,每个应用上限为 10 万张。
[2] 创建/更新小程序引导卡片模板 https://developer.open-douyin.com/docs/resource/zh-CN/dop/develop/openapi/search-management/business-tool/micro-app-card/create-template,页标更新时间对应北京时间 2025-07-31 21:42,访问日期 2026-11-20(北京时间)。该页写明同一小程序最多可配置 10 万张小程序引导卡片模板,近 30 天可创建或更新 5000 次;并写创建好后可通过发送私信消息接口发送。该页属于经营工具下的小程序引导卡片文档,不是另一产品线的说明。