Facebook Messenger Send icon

Facebook Messenger Send

Send messages and perform actions in Facebook Messenger

Actions12

Send Media Template

AI-generated

Summary

Send a media template message (image or video) to a specific Facebook Messenger recipient using their PSID, optionally including a single button below the media.

Inputs

  • Recipient ID (required) — The PSID (Page-Scoped ID) of the message recipient.
  • Media Type (required) — The type of media to send, either 'image' or 'video'.
  • Attachment ID or URL (required) — The Facebook attachment ID or a Facebook URL for the media to be sent.
  • Media Buttons (JSON) — Optional JSON array containing up to one button to display below the media.
  • Messaging Type (required) — The messaging type indicating message context: Response, Update, or Message Tag.
  • Message Tag — The message tag used if Messaging Type is 'MESSAGE_TAG', e.g. 'CONFIRMED_EVENT_UPDATE'.

Output shape

a single JSON object representing Facebook's API response for the sent media template message

Returns the JSON response from Facebook Messenger API after sending the message. If errors occur and 'Continue On Fail' is enabled, an error JSON is returned instead.

Examples

Example 1: Send a media template with an image and a linked button

Set the Recipient ID to target the recipient, select 'image' as Media Type, provide an attachment ID or URL, and optionally include a JSON array with a button in Media Buttons (JSON). Choose appropriate Messaging Type and Message Tag if applicable.

Links

Discussion