> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heyy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Actions

## Send Message

<Frame>
  <img src="https://mintcdn.com/heyy-c8bd5c9e/o8dmFLLuNhw8NaLP/assets/automations-messenger-message.png?fit=max&auto=format&n=o8dmFLLuNhw8NaLP&q=85&s=f76aae9d3123c5afa852e7c9a89b32ff" alt="Messenger message action" width="1462" height="820" data-path="assets/automations-messenger-message.png" />
</Frame>

Sends a Facebook Messenger text message to the contact in the current chat. You can add optional quick-reply buttons and choose to wait for a reply, with optional timeout and saving the reply to a variable or attribute. Use this for simple replies, follow-ups, or guided choices in Messenger conversations.

### Fields

* **Channel** (required): Select the Facebook Messenger channel to send from.
* **Body** (required): The message text. You can use workflow variables and contact attributes.
* **Quick replies** (optional): Add quick-reply buttons the contact can tap. Optional labels and optional payloads.
* **Reply timeout** (optional): Duration after which the automation continues if the contact doesn’t reply.
* **Wait for reply** (optional): When enabled, the automation pauses until the contact replies.
* **Save text reply to** (optional): Save the contact’s text reply to a variable or attribute.
* **Save file reply to** (optional): Save the contact’s file reply to a variable.

### Use cases

* **Reply in the current chat:** Use the action to send a text message in the Messenger conversation (e.g. after a trigger or another action). The body can use variables and attributes; add quick replies if you want the contact to tap a choice.
* **Ask and branch on the reply:** Use “Wait for reply” and “Save text reply to”, then add a Condition or AI action to branch the automation (e.g. qualification, routing) based on what the contact replied or tapped.
* **Confirm or follow up after another action:** After another step (e.g. Assign chat, Set attribute), use Send Message to confirm or ask a follow-up question in Messenger.

***

## Send Media

<Frame>
  <img src="https://mintcdn.com/heyy-c8bd5c9e/o8dmFLLuNhw8NaLP/assets/automations-messenger-media.png?fit=max&auto=format&n=o8dmFLLuNhw8NaLP&q=85&s=23e951d6e20096626f1243bb2121e838" alt="Messenger media action" width="1462" height="820" data-path="assets/automations-messenger-media.png" />
</Frame>

Sends a Facebook Messenger message with a media header (image, video, or document). You upload a file or paste a URL. You can optionally wait for a reply, set a reply timeout, and save the contact’s reply to a variable or attribute. Use this to send images, videos, or documents in Messenger from an automation.

### Fields

* **Channel** (required): Select the Facebook Messenger channel to send from.
* **Header** (required): Choose image, video, or document and upload a file or paste a URL.
* **Reply timeout** (optional): Duration after which the automation continues if the contact doesn’t reply.
* **Wait for reply** (optional): When enabled, the automation pauses until the contact replies.
* **Save text reply to** (optional): Save the contact’s text reply to a variable or attribute.
* **Save file reply to** (optional): Save the contact’s file reply to a variable.

### Use cases

* **Share a visual or file in Messenger:** Use the action to send an image, video, or document in the Facebook Messenger chat (e.g. brochure, how-to video, form) as part of a support or sales flow.
* **Ask and branch after sending media:** Use “Wait for reply” and “Save text reply to” so the next steps (e.g. Condition, Assign) can use the contact’s response to the media you sent.
* **Follow up with context:** After another action (e.g. AI employee, Set attribute), use Send Media to deliver a relevant document or visual and optionally wait for the contact’s reply.

***

## Send Buttons

<Frame>
  <img src="https://mintcdn.com/heyy-c8bd5c9e/o8dmFLLuNhw8NaLP/assets/automations-messenger-buttons.png?fit=max&auto=format&n=o8dmFLLuNhw8NaLP&q=85&s=9eb930c431ee721d4a40b47022b4a5fe" alt="Messenger buttons action" width="1462" height="820" data-path="assets/automations-messenger-buttons.png" />
</Frame>

Sends a Facebook Messenger message with interactive buttons (e.g. postback or URL). You set the body text and add one or more buttons; you can optionally wait for a reply, set a reply timeout, and save the contact’s reply to a variable or attribute. Use this to present clear choices (e.g. “Book now”, “More info”) in Messenger.

### Fields

* **Channel** (required): Select the Facebook Messenger channel to send from.
* **Body** (required): The message text. You can use workflow variables and contact attributes.
* **Buttons** (required): Add one or more buttons. Each button has a label and type (e.g. postback, URL).
* **Reply timeout** (optional): Duration after which the automation continues if the contact doesn’t tap a button or reply.
* **Wait for reply** (optional): When enabled, the automation pauses until the contact taps a button or sends a message.
* **Save text reply to** (optional): Save the contact’s reply (button tap or text) to a variable or attribute.
* **Save file reply to** (optional): Save the contact’s file reply to a variable.

### Use cases

* **Present clear choices in Messenger:** Use the action to send a message with buttons (e.g. “Book now”, “More info”, “Talk to sales”) so the contact can tap a choice; use “Save text reply to” to branch the automation on their selection.
* **Confirm or collect consent:** After another step (e.g. AI, Set attribute), send a message with “Confirm” and “Cancel” (or similar) and branch the flow based on which button the contact taps.
* **Store the choice on the contact:** Save the button label or reply to a contact attribute so you can use it later in the same automation or in campaigns and views.