Proposal for Replies and Reactions

This is an open request for developers comments on new webhook events. This documents does not represent the current behavior of the API and can change at any time.

Currently apps don't get webhook notifications when an user replies to a message of does a reaction. Once this is introduced it will fix that.

Reply Webhook

Example of a reply to a message in Messenger

Example Reply Webhook Schema

message:{
    text: 'San Fransisco'
    mid: '<MID>'
    reply_to: {
        mid: '<MID_OF_MESSAGE_BEING_REPLIED_TO>',
    }
   attachment: [{…}]
}

Reaction Webhook

Reactions will have their own subscription field

Example of a reaction in Messenger

Example Reaction Webhook Schema

message:{
    reaction: {
        reaction: 'smile|angry|sad|wow|love|like|dislike',
        emoji: '\u{2764}\u{FE0F}',
        action: 'react|unreact',
        mid: '<MID_OF_ReactedTo_Message>',
    }
}

Webhook options to ease adoption

To make it easy for apps that show the text to a human agent. We are considering having options to toggle text messages that describe the action taken in a human readable form.

These options should be deprecated eventually since they will act as helpers until apps can make the code changes needed to parse the new webhooks.

Via the app dashboard, developers can opt in into having these helper webhooks described below.

Reply - Migration Helper Webhook

If toggle is enabled this webhook instead of the default will be sent. This is similar to the default one with the text altered and the original text available.

message:{
    text: 'San Fransisco, replied to - Where are you flying from?',
    original_text: 'San Fransisco',
    mid: '<MID>',
    reply_to: {
        mid:'<MID_OF_MESSAGE_BEING_REPLIED_TO>'
    }
   attachment: [{…}]
}

Reaction - Migration Helper Webhook

If toggle is enabled this webhook instead of the default will be sent. This is similar to the default one with the added human readable text Fake mid wont be retrivable

message:{
    text: '\u{2764}\u{FE0F} reaction to - Are you interested in learning more about our…'
    mid: 'placeholder_mid_for_reaction_<timestamp>',
    reaction: {
        reaction: 'smile|angry|sad|wow|love|like|dislike',
        emoji: '\u{2764}\u{FE0F}',
        action: react|unreact,
        mid: <MID_OF_ReactedTo_Message>,
    }
}