WhatsApp API含视频模板消息无法发送问题排查求助

通过WhatsApp API发送带视频的模板消息时，无媒体内容的模板能正常送达，但添加视频的模板无法发送且无任何错误提示。以下是相关信息：

请求代码 #

{"messaging_product": "whatsapp","to": "01123456789","type": "template","template": {"namespace": "your-trainer","name": "my_template_name","language": {"code": "DE","policy": "deterministic"},"components": [{"type": "header","parameters": [{"type": "video","video": {"link": "https://scontent.whatsapp.net/v/t61....."}}]},{"type": "body","parameters": [{"type": "text","text": "Some custom text for variable"}]}]}}

已审核通过的模板配置 #

{
    "data": [
        {
            "name": "my_template_name",
            "components": [
                {
                    "type": "HEADER",
                    "format": "VIDEO",
                    "example": {
                        "header_handle": ["https://scontent.whatsapp.net/v/t61..."]
                    }
                },
                {
                    "type": "BODY",
                    "text": "Hallo {{1}}\n\",
                    "example": {
                        "body_text": [["stackoverflow"]]
                    }
                },
                {
                    "type": "FOOTER",
                    "text": "Some Footer-Text"
                },
                {
                    "type": "BUTTONS",
                    "buttons": [
                        {
                            "type": "QUICK_REPLY",
                            "text": "Promotions stoppen"
                        }
                    ]
                }
            ],
            "language": "de",
            "status": "APPROVED",
            "category": "MARKETING",
            "id": "myid"
        }
    ]
}

API返回结果 #

{"messaging_product": "whatsapp","contacts": [{"input": "1234567899","wa_id": "1234567899"}],"messages": [{"id": "wamid.HBgLNDE3OTQ2NDg4NjYVAgARGDFSDFSDFSDF"}]}

• 视频链接权限及有效性问题：你使用的scontent.whatsapp.net域名链接属于WhatsApp内部临时存储地址，这类链接有有效期限制，且仅对特定场景开放访问权限，无法作为公共媒体链接用于模板消息。需替换为自行托管、可公开访问的视频链接，同时确保视频为WhatsApp支持的MP4格式，编码符合H.264标准，文件大小不超过16MB。
• 接收号码格式不符合规范：请求中的to参数为01123456789，但API返回的wa_id是1234567899，格式不匹配。WhatsApp API要求接收号码必须使用E.164标准格式（例如+1234567890），错误的号码格式会导致消息无法正确路由到目标用户。
• 模板组件匹配不完整：模板配置中包含FOOTER和BUTTONS组件，但请求的components仅传入了HEADER和BODY。虽然WhatsApp允许部分组件省略，但建议保持请求组件与模板配置的完整性，避免因组件缺失导致消息渲染失败。
• 视频参数结构验证：确认请求中视频参数的结构符合API规范，模板视频头不支持自定义字幕，无需额外添加caption字段，仅需保证link字段指向有效资源即可。

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