messaging_account_linking Webhook Event Reference

When using Account Linking, this callback will occur when the Link Account or Unlink Account button have been tapped.

The status parameter tells you whether the user linked or unlinked their account. The authorization_code is a pass-through parameter. allowing you to match the business user entity to the page-scoped ID (PSID) of the sender.

Example

{
  "sender":{
    "id":"USER_ID"
  },
  "recipient":{
    "id":"PAGE_ID"
  },
  "timestamp":1234567890,
  "account_linking":{
    "status":"linked",
    "authorization_code":"PASS_THROUGH_AUTHORIZATION_CODE"
  }
}    
{
  "sender":{
    "id":"USER_ID"
  },
  "recipient":{
    "id":"PAGE_ID"
  },
  "timestamp":1234567890,
  "account_linking":{
    "status":"unlinked"
  }
}    

Properties

sender

PropiedadTipoDescripción

id

Cadena

El PSID del usuario que activó el evento de webhook.

user_ref

Cadena

La user_ref del usuario que activó el evento de webhook. Esto está disponible solamente para el evento de webhook del plugin de chat.

recipient

PropiedadTipoDescripción

id

Cadena

El identificador de la página.

account_linking

Property Description Type

status

linked or unlinked

String

authorization_code

Value of pass-through authorization_code provided in the Account Linking flow

String

Note: authorization_code is only available when status is linked