Amazon Connect联动Pinpoint：细分文件属性无法在联系流中检测的问题

一、先确认属性传递链路是否正常 #

• 检查Pinpoint细分文件：确保campaignid列的表头没有空格、特殊字符（下划线除外），文件为UTF-8无BOM编码，每行数据格式统一，无空值或乱码。
• 核对Pinpoint旅程配置：在Pinpoint的客户旅程中，触发Amazon Connect任务时，必须勾选传递细分属性选项，并手动确认campaignid被纳入传递列表——默认不会全量传递所有属性，需要手动选择。

二、在Connect里找对属性的存放位置 #

• 别死盯着「检查联系属性」的联系属性分类：campaignid大概率在系统属性或者客户属性分类下：
  • 打开「检查联系属性」模块，切换到「系统属性」，搜索ExternalCampaignId或直接搜campaignid关键词；
  • 再切换到「客户属性」分类逐一查看——Pinpoint传递的细分属性常被归到这个分类下。
• 加日志直接查：在联系流开头插入「设置日志记录」模块，把所有联系属性（系统、客户、联系属性全选）输出到CloudWatch，触发一次测试呼叫后去CloudWatch查看日志，直接确认campaignid的实际存储位置和值。

三、验证权限与实际传递情况 #

• 检查IAM权限：确保Pinpoint使用的IAM角色拥有connect:StartOutboundVoiceContact权限，且调用Connect API时确实将campaignid放入了Attributes参数中。
• 单用户测试：在Pinpoint里手动触发一个针对单个用户的旅程，然后到Connect的「联系事件记录」中查看该呼叫的详细属性，确认campaignid是否真的传递到了Connect实例。

四、避坑提醒 #

• 大小写敏感：Pinpoint里是小写campaignid，Connect可能自动转换为驼峰式CampaignId，搜索时注意匹配大小写；
• 列名拼写：仔细核对Pinpoint上传文件的表头，别写成campaign_id或CampaignID，拼写错误会导致属性无法匹配；
• 别依赖搜索框：「检查联系属性」的搜索功能偶尔会漏项，手动展开所有分类逐一查找更靠谱。

内容的提问来源于stack exchange，提问作者Diwakar Singh