You need to enable JavaScript to run this app. 如何在Infobip门户编辑器中添加自定义占位符并配置API自定义变量传参
优惠活动
大模型
产品
解决方案
定价
更多

如何在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 06:27:09