Messenger关联账号

让用户体验无缝链接

当用户没有通过Messenger内的登录按钮,而是通过其他途径(例如邮件订阅确认)确认了要将Facebook账号和官网账号的绑定之后,可以通过这个接口通知Meetbot,这样用户就完成了关联,可以在Messenger里收到关联成功的确认,并在今后的使用中享受绑定带来的便利。  

开发指南

发送请求

您可以用任意一个已经启用的API Key向Meetbot发起请求,向一个手机号发送一条消息。这个请求的样例如下:
请求属性属性名说明
地址https://api.meetbot.biz/api
请求方式POST
HeaderAPIKEY您的API KEY
Form Datarequest.method需要调用的api。此处设置为 account_link
Form Datarequest.id由调用者生成的请求的唯一标识符
Form Datarecipient.id待关联的Facebook user id
Form Dataaccount_linking.username待关联的官网账号(用户名)
Form Dataaccount_linking.email待关联的官网账号(邮箱)
Form Dataaccount_linking.phone_number待关联的官网账号(电话号码)
Form Dataaccount_linking.status取值为linked表示确认绑定,unlinked表示确认解除绑定
Form Datarequest.meta

发送请求样例

{ "recipient":{ "id":"123456" }, "timestamp":"1409291011", "account_linking":{ "status":"linked", "username":"myaccount", "email":"mike@example.com", "phone_number":"18900001111" }, "request":{ "method":"account_link", "id":"F4js0Za2", "meta":"" } }

成功返回样例

{ "request_id":"F4js0Za2" }

失败返回样例

{ "error":{ "message":"Invalid Facebook user id", "type":"InvalidParamException", "code":10000, "error_subcode":1234567, "request_id":"F4js0Za2" } }

错误码

错误码说明
10000无效的method参数
10005无效的API KEY
13000未指定fb_user_id
13001未指定任何一种绑定方式
13002绑定的fb_user_id无效
13003指定的status无效

调用说明

  • 接口支持用户名,邮箱,电话号码三种形式之一或多个与Facebook账号进行绑定。调用此api时,username, email和phone_number至少要传一个。
  • 此接口所指定的Facebook账号如果已经有绑定的账号了,那么会更新所绑定的官网账号。
  • 此接口同样适用于用户先绑定邮箱,后续再绑定手机号这种情况。调用2次该接口,依序指定邮箱和手机号即可。
  • 若调用此接口是为了解除绑定,则不需要传username,email或者phone_number,而是解除该Facebook账号的所有关联官网账号。
2024-05-14
0