Overview
This node enables sending various types of messages through Facebook Messenger. It supports sending text, images, audio, video, and files to a specified recipient identified by their Page-Scoped ID (PSID) or thread ID. Additionally, it can send template messages (generic, button, media templates), mark messages as seen, and send typing indicators.
Common scenarios include:
- Automating customer support replies with text or media.
- Sending promotional content like images or videos.
- Using quick replies to guide user interaction.
- Sending structured template messages with buttons for richer engagement.
- Indicating typing status to improve conversational experience.
Example: Automatically send a welcome text message with quick reply options when a user initiates a chat.
Properties
| Name | Meaning |
|---|---|
| Recipient ID | The Page-Scoped ID (PSID) or thread ID of the recipient to whom the message will be sent. |
| Message Type | The type of message to send. Options: Audio, File, Image, Text, Video. |
| Message Text | The text content of the message (required if Message Type is Text). |
| Media URL | The URL of the media file to send (required if Message Type is Audio, File, Image, or Video). |
| Add Quick Replies | Whether to add quick reply buttons to the message. |
| Quick Replies | Collection of quick replies to add. Each quick reply includes: Content Type (Text, Phone Number, Email), Title, Payload (for Text type), and optional Image URL. |
Output
The node outputs JSON data representing the response from the Facebook Graph API after sending the message. This typically includes message IDs or confirmation details.
If the message includes media, the output confirms successful attachment upload and delivery.
No binary data output is produced by this node.
Dependencies
- Requires an API authentication token credential for Facebook Messenger API access.
- Uses Facebook Graph API endpoint
https://graph.facebook.com/v17.0/me/messages. - The node expects the access token to be provided via n8n credentials configuration.
Troubleshooting
- Invalid Recipient ID: If the recipient ID is incorrect or not associated with the Facebook page, the API will return an error. Verify the PSID or thread ID.
- Missing Required Fields: For text messages, "Message Text" must be provided; for media messages, "Media URL" is required. Ensure these are set correctly.
- API Authentication Errors: If the access token is invalid or expired, the request will fail. Refresh or update the API key credential.
- Unsupported Media URLs: The media URL must be publicly accessible and supported by Facebook Messenger. Check URL accessibility and format.
- Quick Reply Misconfiguration: Quick replies require valid content types and titles. Payloads are mandatory for text-type quick replies.
- Rate Limits: Facebook may throttle requests if limits are exceeded. Implement retries or reduce message frequency.