Zapier对接SendGrid时List ID及自定义字段无法拉取问题

修复「联系人无法加入指定Early Access Waitlist列表」问题 #

• 先获取正确的列表标识：进入SendGrid联系人管理页面，找到Early Access Waitlist列表，复制列表详情页URL中携带的36位UUID格式ID，不要直接用列表名称作为传参值。
• 修正接口传参结构：list_ids字段需要和contacts字段保持平级，且值必须为数组格式（即使仅添加1个列表也要用方括号包裹ID），错误的嵌套位置、字符串格式传值都会导致列表关联失败，参考正确结构片段：

{
  "list_ids": ["替换为你复制的36位列表ID"],
  "contacts": [
    {
      "email": "映射Viral Loops输出的用户邮箱字段",
      "first_name": "映射First Name字段",
      "last_name": "映射Last Name字段"
    }
  ]
}

修复「Participant URL自定义字段同步失败」问题 #

• 先获取正确的自定义字段标识：进入SendGrid自定义字段配置页，找到提前创建的Participant URL字段，复制系统生成的字段ID（格式类似e1_f的下划线拼接字符串），不要用你设置的字段显示名"Participant URL"作为传参key。
• 修正自定义字段传参结构：自定义字段需要放在contacts对象下的custom_fields对象中，以上一步复制的字段ID为key，映射Viral Loops输出的Participant URL值，参考结构片段：

{
  "contacts": [
    {
      "email": "映射用户邮箱字段",
      "first_name": "映射First Name字段",
      "last_name": "映射Last Name字段",
      "custom_fields": {
        "替换为你复制的Participant URL字段ID": "映射Viral Loops输出的Participant URL字段"
      }
    }
  ]
}

解决Hopscotch JSON解析报错 #

• 检查自定义请求的JSON语法：排查是否存在最后一个键值对后多余逗号、字符串未用双引号包裹、对象/数组括号不配对的问题，这类基础语法错误会直接触发解析失败。
• 所有动态字段不要手动输入占位符，全部通过Zapier编辑器右侧的字段选择器点选插入，避免手动输入带入多余不可见字符破坏JSON结构。
• 配置完成后先运行测试，查看Zapier生成的请求预览：确认结构符合上述要求、无语法高亮报错后再正式启用Zap。
• 注意SendGrid联系人同步存在1-2分钟的延迟，测试请求返回202接受状态后，等待2分钟再到SendGrid后台校验数据即可，无需重复触发请求。

内容的提问来源于stack exchange，提问作者Marketing Team