[PHP] 如何通过Twitter API为个人账号设置活动监听webhooks

前提要求 #

• 需要先注册X开发者平台账号，创建对应项目与应用，申请Account Activity API的访问权限，个人账号使用的话申请免费层级基本可以覆盖基础监听需求
• 你需要拥有可公网访问的HTTPS服务端点用于接收webhook回调，X会对该端点做CRC校验验证所有权

支持的监听场景（完全覆盖你提到的需求） #

• 个人账号发布的推文收到点赞/取消点赞
• 个人账号新增/丢失关注者
• 个人账号收到@提及、回复、转发
• 个人账号收到私信等其他互动行为

核心配置步骤 #

1. 首先在你的服务端开发CRC校验接口，用于响应X平台的校验请求，校验逻辑需要对X发来的crc_token参数用你的应用Consumer Secret做HMAC SHA256加密后返回指定格式响应
2. 调用POST /2/webhooks接口注册你的webhook端点，注册成功后X会主动触发第一次CRC校验
3. 调用POST /2/webhooks/:id/subscriptions接口绑定你要监听的个人账号，完成账号授权绑定
4. 后续对应事件触发时，X会主动向你的webhook端点推送符合格式的事件 payload，你自行处理后推送通知即可

注意事项 #

• 免费层级的Account Activity API仅支持绑定1个账号，最多可配置1个webhook端点，事件推送有基础频次限制，个人使用完全足够
• webhook端点必须支持HTTPS，且不能使用自签名证书，必须是公共信任机构颁发的证书
• X平台推送事件后如果你的端点5秒内没有返回200类状态码，会触发重试，多次重试失败后会暂时禁用你的webhook端点

内容的提问来源于stack exchange，提问作者Kévin Guiot