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

# Meta triggers

> Run Ruby agents when messages, comments, or leads arrive on Meta platforms.

![Meta triggers](https://mintcdn.com/ruby-ai/tR9f1R3EWJ6lERa6/branding/integrations/meta-triggers.svg?fit=max\&auto=format\&n=tR9f1R3EWJ6lERa6\&q=85\&s=2074a4a54a03c5004b469fcb2ffaddcb)

> [!NOTE]
>
> Meta integrations are in preview. Ruby enables them per workspace while Meta reviews Ruby's app. If a tool or trigger source is missing, use your Ruby support channel to request access.

Run agents automatically when something happens on WhatsApp, Facebook or Instagram.

## Set up a trigger

1. Go to **Spaces → Triggers** (workspace admins) and add a **WhatsApp Business**,
   **Facebook Pages** or **Instagram** source.
2. Click **Connect**, sign in with Facebook, then select the accounts to receive events from.
3. Choose the events, then add a trigger to an agent from the agent's settings.

## Events

| Source | Events |
| - | - |
| WhatsApp Business | Message received (including button and list replies), message status (sent, delivered, read, failed) |
| Facebook Pages | Messenger message received, Page comment, lead received |
| Instagram | DM received, comment, mention |

Ruby ignores messages and comments sent by your own account, so an agent replying to a customer
does not trigger itself again.

## Good to know

* Each event starts a new agent conversation. On Messenger and Instagram, the agent can read the
  conversation history with its tools. WhatsApp does not provide message history: the agent sees
  the message that triggered it.
* The agent runs as the person who created the trigger, and asks that person for approvals.
* If that person leaves the workspace, their triggers are removed. Create long-lived automations
  from an account that stays.
* Use trigger filters to limit which events run the agent, for example only text messages.

See [Meta overview](https://docs.ruby.ad/docs/user-documentation/agents/tools/meta) for setup, asset access, and approvals.

See [Filter webhooks payload](https://docs.ruby.ad/docs/user-documentation/agents/triggers/webhooks/filter-webhooks-payload.md) to narrow the events that run your agent, and [Rate limiting](https://docs.ruby.ad/docs/user-documentation/agents/triggers/webhooks/rate-limiting.md) to control run frequency.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.