如何在Infobip门户编辑器中添加自定义占位符并配置API自定义变量传参
Infobip门户自定义邮件模板的动态占位符全流程实现
门户编辑器内自定义占位符配置
- 打开已创建的发票邮件模板编辑页面,定位到需要插入动态内容的文本位置,在编辑器侧边栏的「个性化」组件面板中,选择自定义变量占位符选项
- 按照业务场景定义占位符的唯一标识,例如对应收件人姓名的
recipient_name、对应发票编号的invoice_id,可同步为占位符设置兜底默认值,避免后续传入空值时出现页面展示空白 - 完成占位符插入后,可通过编辑器内置的预览功能输入测试值,验证展示格式、排版位置是否符合预期,确认无误后发布模板,记录分配的模板ID用于接口调用
发送邮件接口的自定义变量传参位置
- 调用发送邮件接口时,自定义收件人数据不需要在模板ID的同级参数中寻找独立入口,实际参数挂载在
message数组条目的placeholders字段下 - 字段值为键值对结构,键名必须和你在编辑器内定义的占位符标识完全匹配,参考配置结构:
{ "messages": [ { "templateId": "门户生成的发票模板ID", "placeholders": { "recipient_name": "李四", "invoice_id": "INV20240600789", "invoice_amount": "899.00" }, "to": [ {"address": "customer@example.com"} ] } ] }
- 若为批量多收件人发送场景,每个收件人对应的message条目下单独配置自身的
placeholders值,系统会自动逐一对占位符做内容替换,无需为不同收件人拆分独立模板
常见注意事项
- 占位符标识的大小写需与编辑器内定义的内容完全一致,否则会出现替换失败、直接展示原始占位符文本的问题
- 动态跳转按钮、附件链接这类元素也可直接用占位符实现,无需在编辑器写死跳转地址,只需把目标位置设置为占位符,调用接口时传入实际跳转地址即可
- 模板发布后如果修改了占位符的标识名,需同步更新接口侧传入的键名,避免出现变量匹配失效
内容的提问来源于stack exchange,提问作者Vixson
相关产品推荐
相关产品推荐

