View Source WeChat.Work.Customer.Welcome (wechat v0.16.0)
客户欢迎语
Summary
Types
群欢迎语的素材id
Types
@type template_id() :: String.t()
群欢迎语的素材id
Functions
@spec add_group_template(WeChat.Work.client(), WeChat.Work.agent(), body :: map()) :: WeChat.response()
添加入群欢迎语素材 - 官方文档
企业可通过此API向企业的入群欢迎语素材库中添加素材。每个企业的入群欢迎语素材库中,最多容纳100个素材。
@spec delete_group_template(WeChat.Work.client(), WeChat.Work.agent(), body :: map()) :: WeChat.response()
删除入群欢迎语素材 - 官方文档
企业可通过此API删除入群欢迎语素材,且仅能删除调用方自己创建的入群欢迎语素材。
@spec edit_group_template(WeChat.Work.client(), WeChat.Work.agent(), body :: map()) :: WeChat.response()
编辑入群欢迎语素材 - 官方文档
企业可通过此API编辑入群欢迎语素材库中的素材,且仅能够编辑调用方自己创建的入群欢迎语素材。
@spec get_group_template(WeChat.Work.client(), WeChat.Work.agent(), body :: map()) :: WeChat.response()
获取入群欢迎语素材 - 官方文档
企业可通过此API获取入群欢迎语素材。
@spec send_welcome_msg(WeChat.Work.client(), WeChat.Work.agent(), body :: map()) :: WeChat.response()
发送新客户欢迎语 - 官方文档
- 企业微信在向企业推送添加外部联系人事件时,会额外返回一个welcome_code,企业以此为凭据调用接口,即可通过成员向新添加的客户发送个性化的欢迎语。
- 为了保证用户体验以及避免滥用,企业仅可在收到相关事件后20秒内调用,且只可调用一次。
- 如果企业已经在管理端为相关成员配置了可用的欢迎语,则推送添加外部联系人事件时不会返回welcome_code。
- 每次添加新客户时可能有多个企业自建应用/第三方应用收到带有welcome_code的回调事件,但仅有最先调用的可以发送成功。后续调用将返回41051(externaluser has started chatting)错误,请用户根据实际使用需求,合理设置应用可见范围,避免冲突。
- 旧接口发送新客户欢迎语已经废弃,接口升级后支持发送视频文件,并且最多支持同时发送9个附件