文档首页/云客服/API参考/Adapter类接口参考/接口说明/数据访问接口/facebook渠道/facebook回调接口
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

facebook回调接口

接口功能

渠道配置完成后生成回调接口，facebook配置该接口验证回调，与ccmessaging对接。

使用说明

  • 前提条件
    • facebook渠道创建成功
    • 详见官方文档：https://developers.facebook.com/

接口鉴权

将渠道配置里的verifyCode与请求参数中的hub.verify_token进行比较，相同既鉴权通过。

接口原型

表1 接口原型说明

请求方法

GET

请求URL

https://ip:port/social/on/facebook/{channelId}

其中，ip:port为对外暴露的nslb的ip和port，

channelId为渠道id

请求参数

表2 请求Headers参数说明

参数名称

选取原则

参数类型

说明

Content-Type

必选

String

固定：application/json; charset=UTF-8。

user-agent

必选

String

例：facebookplatform/1.0 (+http://developers.facebook.com)

accept-encoding

必选

String

例：deflate, gzip

表3 请求Body中request参数说明

参数名称

选取原则

参数类型

说明

hub.mode

必选

String

必须是subscribe

hub.verify_token

必选

String

facebook携带的验证信息

hub.challenge

必选

String

校验成功后response响应内容

响应参数

当调用本接口响应成功，response 无响应内容。

当调用本接口响应失败，则返回相应的状态码或者错误描述信息。

接口示例

  • 请求示例 
    GET https://10.10.10.1/social/on/facebook/202106178632962090

host : 10.10.10.2:28090
connection : Keep-Alive
x-forwarded-for : 10.10.10.3, 10.10.10.4
x-real-ip : 10.10.10.5
remote-host : 10.10.10.6
accept : */*
accept-encoding : deflate, gzip
user-agent : facebookplatform/1.0 (+http://developers.facebook.com)

{
    "hub.mode": "subscribe",
    "msgBody": "*********************",
    "hub.challenge": ""
}
  • 响应示例 
    Status Code: 400
response: "The token sent by facebook is not correct."
父主题：facebook渠道