使用Twilio Flex API发送WhatsApp外呼消息时遇路由无效错误

核心排查与修复步骤 #

错误码45008对应路由配置无效，以下是针对性的解决方案：

1. 移除冲突的路由参数 #

当直接指定worker_sid（分配给特定座席）时，不需要同时传入queue_sid和workflow_sid——直接分配逻辑无需经过队列或工作流。修改后的路由参数块如下：

[
    "routing" => [
        "properties" => [
            "workspace_sid" => env('TWILIO_WORKSPACE_SID'),
            "worker_sid" => $worker->sid,
            "attributes" => [
                "customerName" => "John Doe",
                "customerAddress" => "whatsapp:$to",
            ],
        ],
    ],
]

如果需要通过工作流分配对话，则移除worker_sid，保留workflow_sid和queue_sid，同时确保工作流的目标配置正确指向该队列。

2. 验证座席状态与权限 #

• 确认$worker->sid对应的座席处于**在线（Available）**状态
• 检查座席属性（Attributes）是否包含工作流要求的技能标签（若使用技能路由）
• 确保座席拥有处理WhatsApp对话的权限

3. 校验WhatsApp号码合法性 #

• 确认OUTBOUND_MX_WHATSAPP_PHONE_NUMBER是Twilio验证通过的WhatsApp发送号码，且已绑定到当前Flex项目
• 接收方号码$to必须为合规的WhatsApp注册号码，格式为+[国家码][手机号]（例如+1234567890）

4. 检查资源关联一致性 #

确保TWILIO_WORKSPACE_SID与worker_sid/queue_sid/workflow_sid属于同一个Twilio账户和Flex项目，避免跨资源的无效关联

完整修正后的代码示例 #

$interaction = $this->client->flexApi->v1->interaction->create(
    [
        "type" => "whatsapp",
        "initiated_by" => "agent",
        "properties" => [
            "type" => "whatsapp",
        ],
        "participants" => [
            [
                "address" => "whatsapp:$to",
                "proxy_address" => "whatsapp:" . env('OUTBOUND_MX_WHATSAPP_PHONE_NUMBER'),
                "type" => "whatsapp",
            ],
        ],
    ], // channel
    [
        "routing" => [
            "properties" => [
                "workspace_sid" => env('TWILIO_WORKSPACE_SID'),
                "worker_sid" => $worker->sid,
                "attributes" => [
                    "customerName" => "John Doe",
                    "customerAddress" => "whatsapp:$to",
                ],
            ],
        ],
    ]
);

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