使用Twilio API无法通过WhatsApp发送xlsx、docx文件的问题

你遇到的错误码12300，本质是Twilio WhatsApp API不支持doc、docx、xlsx这类Office格式文件的原生Content-Type。当前Twilio仅支持WhatsApp官方允许的媒体类型，而Office格式不在默认支持列表中，所以当Twilio抓取文件时，无法识别对应的Content-Type，从而返回错误。

可行解决方案 #

1. 将Office文件转换为PDF格式发送 #

这是最直接的解决办法，因为PDF是Twilio明确支持的格式，你已经验证过PDF可以正常发送。

实现思路：

• 在生成文件路径前，对doc/docx/xlsx文件进行格式转换，生成对应的PDF文件
• 将转换后的PDF文件URL传入mediaUrl参数

示例代码调整方向（假设你有文件转换工具/库）：

// 假设$original_file是原Office文件路径，$pdf_file是转换后的PDF路径
$file_ext = pathinfo($original_file, PATHINFO_EXTENSION);
if (in_array($file_ext, ['doc', 'docx', 'xlsx'])) {
    // 调用转换逻辑，比如用PHPWord/PhpSpreadsheet等库生成PDF
    convertOfficeToPdf($original_file, $pdf_file);
    $newname = basename($pdf_file);
}

// 后续保持原代码逻辑
$whats_app_twilio_arr = [
    "mediaUrl" => [PORTAL_URL . "/" . $dir . "/" . $newname],
    "from" => "whatsapp:" . WHATS_APP_NO
];

2. 验证文件服务器的Content-Type（仅辅助排查） #

如果坚持尝试发送原格式（注：此方法大概率无效，因为Twilio本身不支持这类格式），需确认你的文件服务器返回正确的Content-Type：

• doc: application/msword
• docx: application/vnd.openxmlformats-officedocument.wordprocessingml.document
• xlsx: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

但即使Content-Type正确，Twilio WhatsApp API仍会拒绝这些格式，所以此操作仅作排查用。

关键注意点 #

• 确保转换后的PDF文件处于公网可访问状态，Twilio需要能正常抓取文件内容
• 转换Office文件时，注意保留原文件的内容排版，避免出现格式错乱

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