Send API – Messenger Platform – Documentation – Meta for Developers

metadata – A string of additional data you want to pass in the message_echo webhook. Must be less than 1000 characters

attachment object – Previews the URL. Used to send messages with media or Structured Messages. text or attachment must be set.

The type of message your Page is sending. Either text or attachement must be set when using this parameter.

The type of message being sent

The person who will receive the message your Page is sending

Can only be sent with the recipient parameter. Cannot be sent with the message parameter but must be sent as a separate request.

The action icon shown in the messaging window representing the action taken by the Page on a message the Page has received from a person.

tag

enum

A tag that enables your Page to send a message to a person outsde the standard 24 hour messaging window.

• ACCOUNT_UPDATE – Tags the message you are sending to your customer as a non-recurring update to their application or account.

  – Tags the message you are sending to your customer as a non-recurring update to their application or account.
  View the allowed uses.
  

  Not available for Instagram Messaging API.

• CONFIRMED_EVENT_UPDATE – Tags the message you are sending to your customer as a reminder fo an upcoming event or an update for an event in procgres for which the customer is registered.

  – Tags the message you are sending to your customer as a reminder fo an upcoming event or an update for an event in procgres for which the customer is registered.
  View the allowed uses.
  

  Not available for Instagram Messaging API.

• CUSTOMER_FEEDBACK – Tags the message you are sending to your customer as a

  – Tags the message you are sending to your customer as a
  Customer Feedback Survey
  . Customer feedback messages must be sent within 7 days of the customer’s last message.
  View the allowed uses.
  

  Not available for Instagram Messaging API.

• HUMAN_AGENT – Required for Instagram Messaging API. When this tag is added to a message being sent to a person, it allows a human agent to respond to the person’s message. Messages can be sent within 7 days of the person’s message. Human agent support is for issues that cannot be resolved within the standard messaging window.

  • Apps will need to apply for the Human Agent permission via the Developer App dashboard. Navigate to App dashboard -> App review -> Permissions & Features -> Human Agent. Apps that were previously approved for beta access to the Human Agent permission do not need to re-apply for access.

  Human Agent permission is not available in standard access or development mode. You will need to complete the app review process before you can leverage the human agent tag. During app review submission, please provide clear instructions and a demonstration for how you intend to leverage the human agent tag in your experiences.

  When this tag is added to a message being sent to a person, it allows a human agent to respond to the person’s message. Messages can be sent within 7 days of the person’s message. Human agent support is for issues that cannot be resolved within the standard messaging window.
  View the allowed uses.
  

• POST_PURCHASE_UPDATE – Tags the message you are sending to your customer as an update for a recent purchase made by the customer.

  – Tags the message you are sending to your customer as an update for a recent purchase made by the customer.
  View the allowed uses.
  

  Not available for Instagram Messaging API.