WhatsApp Flow无法推送至iOS设备但Android端正常的问题求助

问题背景 #

WhatsApp Flow可正常推送到Android设备，但iOS设备接收不到，调用接口返回状态码200，无任何错误提示。已查阅Meta官方文档并在社区求助，问题仍未解决。

相关配置 #

Flow JSON

{
    "version":"3.1",
    "screens":[
        {
            "id":"RECOMMEND",
            "title":"Feedback 1 of 1",
            "data":{
                
            },
            "terminal":true,
            "success":true,
            "layout":{
                "type":"SingleColumnLayout",
                "children":[
                    {
                        "type":"Form",
                        "name":"form",
                        "children":[
                            {
                                "type":"TextSubheading",
                                "text":"Give feedback?"
                            },
                            {
                                "type":"Dropdown",
                                "label":"Rate your experience",
                                "name":"demo_feedback",
                                "data-source":[
                                    {
                                        "id":"0",
                                        "title":"★★★★★ • Excellent (5/5)"
                                    },
                                    {
                                        "id":"1",
                                        "title":"★★★★☆ • Good (4/5)"
                                    },
                                    {
                                        "id":"2",
                                        "title":"★★★☆☆ • Average (3/5)"
                                    },
                                    {
                                        "id":"3",
                                        "title":"★★☆☆☆ • Poor (2/5)"
                                    },
                                    {
                                        "id":"4",
                                        "title":"★☆☆☆☆ • Very Poor (1/5)"
                                    }
                                ],
                                "required":true
                            },
                            {
                                "type":"TextSubheading",
                                "text":"How could we do better?"
                            },
                            {
                                "type":"TextArea",
                                "label":"Leave a comment",
                                "required":false,
                                "name":"comment_text"
                            },
                            {
                                "type":"Footer",
                                "label":"Submit",
                                "on-click-action":{
                                    "name":"complete",
                                    "payload":{
                                        "demo_feedback":"${form.demo_feedback}",
                                        "comment_text":"${form.comment_text}"
                                    }
                                }
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

消息Payload

{
    "recipient_type":"individual",
    "messaging_product":"whatsapp",
    "to":"TOBE_FILLED_WITH_PHONE_NUMBER",
    "type":"interactive",
    "interactive":{
        "type":"flow",
        "body":{
            "text":"TOBE_FILLED_WITH_FLOW_BODY"
        },
        "footer":{
            "text":"TOBE_FILLED_WITH_FLOW_FOOTER"
        },
        "action":{
            "name":"flow",
            "parameters":{
                "mode":"published",
                "flow_message_version":"3",
                "flow_token":"TOBE_FILLED_WITH_USER_IDENTIFIER",
                "flow_id":"TOBE_FILLED_WITH_FLOW_ID",
                "flow_cta":"TEXT_SHOWN_ON_FLOW_BUTTON",
                "flow_action":"navigate",
                "flow_action_payload":{
                    "screen":"TOBE_FILLED_WITH_FIRST_SCREEN_ID"
                }
            }
        }
    }
}

排查建议 #

• 版本兼容性匹配：Flow配置版本为3.1，但消息payload中flow_message_version设为3，调整为3.1后重新测试，确保版本对齐。
• 特殊字符兼容性：Flow中使用的星级符号★可能在iOS端存在渲染问题，替换为纯文本描述（如5/5 Excellent）后重新发布Flow。
• 参数准确性校验：确认flow_action_payload.screen的值与Flow中首个屏幕IDRECOMMEND完全一致，无大小写或拼写错误；检查flow_token格式符合Meta规范，无无效字符。
• iOS设备环境检查：确保测试设备安装最新正式版WhatsApp，开启通知权限，网络环境稳定无代理限制；更换多台iOS设备测试排除单设备异常。

内容的提问来源于stack exchange，提问作者MD Rameez