2022年WhatsApp网页版wa.me链接文本换行失效解决方法

换行不生效的核心原因是两点：

• 没有对text参数的内容做标准URL编码，直接把换行标识硬塞进HTML href属性里，会被模板引擎的默认HTML转义规则处理，最终转成普通文本显示。
• 尝试的几种写法里，要么是未编码的原生控制字符，要么是提前写死的转义序列被二次转义，都不符合WhatsApp的参数解析规则。

正确实现方式 #

WhatsApp识别参数内换行的有效转义符是URL编码后的%0A，不需要额外加回车符%0D，全端（网页版、移动端APP）都能正常识别，实现步骤如下：

1. 后端组装预填文本时，直接用原生换行符排版内容即可，不需要手动替换转义字符：

// 预填文本示例，直接换行写内容就行
$preFillText = "您好，我想咨询业务问题
我的相关需求：XXX
联系电话：" . $telephone;
// 单独对文本内容做URL编码，这步是核心
$encodedText = urlencode($preFillText);

2. 模板层的跳转标签明确拼接text参数，传入已经编码好的文本变量：

<a href="https://wa.me/6{{ telephone }}?text={{ encodedText }}" target="_blank">{{ telephone }}</a>

如果使用的模板引擎自带URL编码过滤器（比如Twig的url_encode、Blade的@urlencode），也可以把未编码的原始文本传到模板，在href属性输出时套一层编码过滤器即可，禁止在模板字符串内硬写%0A、\n这类标识，避免被二次转义失效。

避坑说明 #

• 禁止直接在href属性内写\n、PHP_EOL、\r\n这类原生换行符：HTML属性内的空白字符会被解析成普通空格，无法触发WhatsApp的换行识别。
• 禁止提前手动把换行替换成%0D%0A再传入模板：模板引擎默认会对HTML属性内的%做实体转义，把%转成%25，最终写的转义序列会变成纯文本显示。
• 不需要手动拼接api.whatsapp.com域名，wa.me短链会自动携带正确编码的参数跳转到对应聊天页，换行效果不会丢失。

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