需在Perplexity开发者控制台配置HTTPS Webhook地址、签名密钥及事件类型：一、部署HTTPS端点并返回200；二、生成32字节密钥并实现HMAC-SHA256校验；三、在设置中填写URL和密钥并保存；四、勾选事件类型并发送测试推送。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Perplexity平台中通过Webhook接收关键事件的安全通知，需在开发者控制台完成回传地址的配置。以下是具体操作步骤：
一、创建具备HTTPS协议的接收端点
Perplexity强制要求Webhook URL必须使用HTTPS协议，以确保传输过程中的数据加密与身份可信。HTTP地址将被平台直接拒绝，且端点需能稳定响应200状态码。
1、部署一个支持HTTPS的Web服务，例如使用Cloudflare Pages Functions、Vercel Edge Functions或Nginx反向代理+Let’s Encrypt证书的自建服务器。
2、在服务代码中添加基础响应逻辑，确保接收到POST请求时返回HTTP 200 OK及空JSON体{"status":"received"}。
3、使用curl命令验证端点可用性：curl -I https://your-domain.com/webhook/perplexity，确认响应头含HTTP/2 200且无重定向。
二、生成并验证签名密钥
Perplexity在发送Webhook时会附带X-Perplexity-Signature-256请求头，其值为使用您在开发者设置中预设的密钥对请求体进行HMAC-SHA256计算后的十六进制字符串。该密钥用于验证通知来源真实性，防止伪造请求。
1、在本地生成32字节随机密钥，推荐使用Python命令：python3 -c "import secrets; print(secrets.token_hex(32))"。
2、将生成的密钥完整复制，不增删空格或换行符，后续仅在此处粘贴一次。
3、在接收端点代码中实现校验逻辑：读取原始请求体（非JSON解析后）、用相同密钥计算HMAC-SHA256、与请求头签名比对，二者必须完全相等才可信任该通知。
Perplexity SEO 优化指南 — 如何获得 Perplexity AI 的引用。涵盖 Perplexity 引用行为、面向 Perplexity 答案的内容结构、Perplex...
三、在开发者设置中填写并保存Webhook地址
该步骤需登录Perplexity开发者控制台，在应用级配置中注册已验证的HTTPS端点。平台会对URL进行即时连通性探测，失败则禁止保存。
1、访问https://www.perplexity.ai/developer/settings，进入目标应用的“Webhooks”标签页。
2、在“Webhook URL”输入框中粘贴已部署的HTTPS地址，例如https://api.yourapp.com/v1/perplexity-webhook。
3、在“Signing Secret”字段中粘贴第二步生成的32字节密钥（纯十六进制字符串，长度为64）。
4、点击“Save Changes”，页面显示绿色提示“Webhook configuration updated”即表示提交成功。
四、启用指定事件类型并触发测试推送
仅配置URL和密钥不足以接收数据，还需明确选择希望监听的事件类型。Perplexity当前支持的事件包括查询完成、结果异常、会话超时等，每类事件对应独立的通知载荷结构。
1、在同一页的“Event Types”区域，勾选至少一项，例如query_completed和result_error。
2、点击“Send Test Webhook”按钮，平台立即向您的端点发送模拟POST请求。
3、检查服务日志，确认收到含X-Perplexity-Event: test头的请求，并验证响应状态码为200；若日志中出现400或签名校验失败记录，则需回溯第二步密钥一致性。
