Skip to main content

Messenger Nodes

Messenger nodes handle communication with contacts through Facebook Messenger. Use them to send automated replies with buttons and escalate conversations to human agents. These nodes work exclusively with the Messenger channel.
Messenger supports text, buttons, and media with a 2,000 character limit. Unlike WhatsApp, Messenger does not support list menus or rich text formatting.

msg.send_message

Send a message via Facebook Messenger. This node sends a text message back through Messenger. It supports dynamic variables from the workflow context for personalized responses.

Configuration

Variable Substitution

Use double curly braces to inject dynamic values:
Available variables include:
  • {{contact.name}} — The contact’s name
  • {{contact.fields.*}} — Any custom fields set on the contact
  • {{conversation.fields.*}} — Any custom fields set on the conversation

Outputs

Connections

  • Inputs: Single input handle from the previous node
  • Outputs: Single output handle for chaining additional actions

Example Use Case

After an AI Agent handles a Messenger conversation, connect to a Messenger Send Message node to deliver the response. Messenger supports buttons, so you can include quick-reply options for common follow-up actions.

msg.handoff

Escalate the Messenger conversation to a human agent. The Handoff node moves the Messenger conversation from automated processing to the human agent inbox. The conversation appears in the Inbox with a “handoff” status and a Messenger channel indicator (blue).

Configuration

Outputs

Connections

  • Inputs: Single input handle from the previous node
  • Outputs: Single output handle (typically connected to a logic.end node or left unconnected)

Example Use Case

When a Facebook Messenger conversation needs human intervention — for example, order issues or account-specific questions — route to the Messenger Handoff node. The agent sees the conversation in their Inbox with the Messenger channel indicator.