通过Cloud API添加Twilio新购号码至WABA时权限报错问题排查

核心原因 #

1. 新号码未完成Meta侧初始验证：老号码在Twilio留存时间久，已经通过Meta的隐性验证机制完成了所有权校验；新购号码还没经过Meta的验证流程，直接调用API时，系统判定你没有该号码的操作权限，抛出200错误。
2. 控制台操作的验证触发作用：通过WA手动添加号码的过程，会强制Meta向该号码发送验证短信/语音，完成所有权确认。哪怕之后删除号码，Meta系统里已经留存了该号码的验证记录，后续API调用就能通过权限校验。

解决办法 #

方案一：预验证新号码（最直接） #

在调用API添加新Twilio号码前，先通过WA控制台把号码加进去再删掉。这个操作会触发Meta的验证流程，之后API就能正常添加该号码了。

方案二：调用验证API前置处理 #

直接用Meta的号码验证API先完成校验，再执行添加操作：

curl --location 'https://graph.facebook.com/v18.0/WABA_ID/phone_numbers/verify' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer EAA.....' \
--data '{
    "cc": "44",
    "phone_number": "77...",
    "code_method": "SMS" # 也可以选"VOICE"
}'

收到验证码完成验证后，再执行原有的添加号码API即可。

方案三：检查Twilio号码状态 #

确认新购的Twilio号码处于活跃状态，没有被暂停或限制。必须保证号码能正常接收短信/语音，否则Meta的验证流程无法完成，后续API仍会报错。

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