Message Tags

Message tags allow messages to be marked with a particular tag. The meaning and effect of each tag depend on each specific platform. Using Conversations API, it's possible to set a MessageBird Message Tag, which will be converted to a platform-specific message tag.

The table below displays the correspondence between MessageBird Message Tags and platform-specific message tags.

Notification icon

Currently message tags are only supported by Facebook Messenger.

MessageBird Message TagFacebook Message TagPlatform-specific Description
event.updateCONFIRMED_EVENT_UPDATESend the user reminders or updates for an event they have registered for (e.g., RSVP'ed, purchased tickets).
purchase.updatePOST_PURCHASE_UPDATENotify the user of an update on a recent purchase.
account.updateACCOUNT_UPDATENotify the user of a non-recurring change to their application or account.
human_agentHUMAN_AGENT (Closed BETA) Apply for accessAllows human agents to respond to user inquiries. Messages can be sent within 7 days after a user message.

More details about Facebook Message Tags are available here:

Here's an example of HTTP request you can perform to the Conversations API POST /v1/send endpoint using the tag account.update, which corresponds to the Facebook ACCOUNT_UPDATE message tag.

curl -X "POST" "" \
-H 'Authorization: AccessKey <access-key>' \
-H 'Content-Type: application/json; charset=utf-8' \
-d $'{
"content": {
"text": "Sample message using a tag"
"to": "107998841006481",
"type": "text",
"tag": "account.update",
"from": "8145h20547u54cb7bcde4d5c0bb40a35"

A few details about the HTTP request above:

  • The field to must contain a valid Facebook recipient identifier, or an existing contact ID
  • The field tag must contain one of the aforementioned MessageBird message tags. You can't use platform-specific message tags. For example, ACCOUNT_UPDATE
  • The field from must contain a valid Facebook channel ID

The HTTP response looks like the following:

"id": "7d9b3s4f2e3g44ab5cd72a31c133c5c1",
"status": "accepted",
"fallback": null


We’re always happy to help with code or other doubts you might have! Check out our Quickstarts, API Reference, Tutorials, SDKs, or contact our Support team.

Cookie Settings