RingCentral Glip Webhook特殊字符兼容问题及PHP适配咨询

我之前在对接Glip Webhook的时候也踩过类似的编码坑，刚好能给你梳理清楚问题所在：

首先明确：Glip Webhook完全支持UTF-8字符集，你遇到的UTF-8内容无法发送的问题，几乎不可能是Glip不兼容导致的，大概率是PHP代码在处理编码或发送请求时的细节没做好——毕竟纯ASCII是UTF-8的子集，所以能正常发送。

下面是我实战过的正确处理流程，附带代码示例：

1. 确保原始邮件内容转为UTF-8 #

邮件内容可能来自不同编码（比如ISO-8859-1、GBK等），第一步要把它统一转成UTF-8：

// 假设$rawEmailContent是从邮件中提取的原始内容
$utf8Content = mb_convert_encoding($rawEmailContent, 'UTF-8', 'auto');
// 如果auto识别不准，可以手动指定原始编码，比如'ISO-8859-1'

2. 构造Glip消息并正确编码JSON #

PHP的json_encode()默认会把UTF-8字符转成Unicode转义序列（比如\u4e2d\u6587），Glip是支持这种格式的；如果想直接发送原生UTF-8字符，可以加上JSON_UNESCAPED_UNICODE参数：

$glipPayload = [
    'text' => $utf8Content,
    // 可选：添加其他Glip支持的字段，比如标题、附件等
];
// 编码为JSON，保证UTF-8格式正确
$jsonData = json_encode($glipPayload, JSON_UNESCAPED_UNICODE);

3. 设置正确的请求头并发送 #

发送POST请求时，必须明确告诉Glip服务器你发送的是UTF-8编码的JSON数据，这是很多人忽略的关键点：

$webhookUrl = "你的Glip Webhook地址";
$curl = curl_init($webhookUrl);

curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $jsonData,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json; charset=utf-8',
        'Content-Length: ' . strlen($jsonData)
    ],
    CURLOPT_RETURNTRANSFER => true
]);

$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

// 调试用：检查响应状态
if ($httpCode === 200) {
    echo "消息发送成功";
} else {
    echo "发送失败，状态码：{$httpCode}，响应：{$response}";
}

常见问题排查 #

如果还是发送失败，可以试试这几个排查步骤：

• 用mb_check_encoding($utf8Content, 'UTF-8')检测内容是否为有效的UTF-8，无效字符可以用iconv('UTF-8', 'UTF-8//IGNORE', $utf8Content)去除
• 不要手动对内容做urlencode或其他转义，JSON编码会自动处理必要的转义
• 检查Glip Webhook地址是否正确，有没有权限问题

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