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

# Campaign Triggers

> Set up automated DM campaign triggers

## Overview

Campaign triggers automatically activate your DM campaigns when users perform specific actions. When a trigger condition is met, Blueberry sends a personalized DM to the user.

<Info>
  Triggers are built in natural language. Just describe what should activate your campaign.
</Info>

## Managing Triggers

### Adding Triggers to a New Campaign

When creating a new campaign, you'll set up triggers **after** the campaign is created:

<Steps>
  <Step title="Create Campaign">
    Create your campaign and configure the basic settings (objective, message, etc.)
  </Step>

  <Step title="Navigate to Triggers">After saving the campaign, go to the **Triggers** section</Step>

  <Step title="Add Triggers">
    Add one or more triggers that will activate your campaign
  </Step>
</Steps>

### Editing Triggers for Existing Campaigns

<Steps>
  <Step title="Open Campaign">
    Navigate to **DMs** → **Campaigns** and select the campaign you want to edit
  </Step>

  <Step title="Go to Triggers Section">
    Click on the **Triggers** tab or section within the campaign
  </Step>

  <Step title="Edit Triggers">
    Add, remove, or modify existing triggers as needed
  </Step>
</Steps>

## Trigger Types

Blueberry supports two types of triggers:

<CardGroup cols={2}>
  <Card title="Comment Triggers" icon="comment">
    Activate when someone comments on your posts or ads
  </Card>

  <Card title="DM Triggers" icon="message">
    Activate when someone sends you a direct message
  </Card>
</CardGroup>

### Comment Triggers

Comment triggers activate when users comment on your Instagram or Facebook content.

<AccordionGroup>
  <Accordion title="How It Works" icon="gears">
    <Steps>
      <Step title="User Comments">
        A user comments on your post or ad
      </Step>

      <Step title="Blueberry Evaluates">
        Blueberry checks if the comment matches your trigger conditions
      </Step>

      <Step title="Campaign Activates">
        If it matches, the campaign sends a personalized DM
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Trigger Options" icon="sliders">
    **Describe what should trigger the campaign in natural language:**

    * "Any comment showing interest in buying"
    * "Comments asking about price or availability"
    * "Positive comments or compliments"
    * "Comments with questions"
    * "Any comment mentioning \[product name]"

    **Optional: Restrict to specific posts**

    You can limit triggers to specific posts or let them work across all your content.

    <Note>
      Works on both organic posts and paid ads.
    </Note>
  </Accordion>

  <Accordion title="Examples" icon="lightbulb">
    **Example 1: Product Interest**

    ```yaml theme={null}
    Trigger Type: Comment
    Description: "Any comment showing interest in the product"
    Post Restriction: None (all posts)
    ```

    **Example 2: Specific Post**

    ```yaml theme={null}
    Trigger Type: Comment
    Description: "Comments asking for more information"
    Post Restriction: "Fall Sale Announcement" post
    ```

    **Example 3: Keyword-Based**

    ```yaml theme={null}
    Trigger Type: Comment
    Description: "Any comment containing 'link' or 'shop'"
    Post Restriction: None (all posts)
    ```
  </Accordion>
</AccordionGroup>

### DM Triggers

DM triggers activate when users send you a direct message.

<AccordionGroup>
  <Accordion title="How It Works" icon="gears">
    <Steps>
      <Step title="User Sends DM">
        A user sends a direct message to your account
      </Step>

      <Step title="Blueberry Evaluates">
        Blueberry checks if the message matches your trigger conditions
      </Step>

      <Step title="Campaign Activates">
        If it matches, the campaign sends a personalized response
      </Step>
    </Steps>

    <Info>
      Story replies are DMs, so they can also trigger campaigns.
    </Info>
  </Accordion>

  <Accordion title="Trigger Options" icon="sliders">
    **Describe what should trigger the campaign in natural language:**

    * "Any DM asking about products or pricing"
    * "DMs with questions about shipping"
    * "Messages mentioning returns or exchanges"
    * "Any DM that seems like a customer support inquiry"
    * "DMs asking for recommendations"

    <Tip>
      DM triggers are great for automating customer support and frequently asked questions.
    </Tip>
  </Accordion>

  <Accordion title="Examples" icon="lightbulb">
    **Example 1: General Inquiries**

    ```yaml theme={null}
    Trigger Type: DM
    Description: "Any DM asking about products or services"
    ```

    **Example 2: Support Questions**

    ```yaml theme={null}
    Trigger Type: DM
    Description: 'DMs mentioning shipping, delivery, or tracking'
    ```

    **Example 3: Story Replies**

    ```yaml theme={null}
    Trigger Type: DM
    Description: 'Story replies asking for more information'
    ```
  </Accordion>
</AccordionGroup>

## Multiple Triggers

Campaigns can have multiple triggers. This allows you to activate the same campaign from different user actions.

<Steps>
  <Step title="Click Add Trigger">
    In the Triggers section, click **Add Trigger** to create additional triggers
  </Step>

  <Step title="Configure Each Trigger">
    Set up each trigger with its own conditions and descriptions
  </Step>

  <Step title="All Triggers Work Together">
    Any trigger matching will activate the campaign for that user
  </Step>
</Steps>

**Example: Multiple trigger types for one campaign**

```yaml theme={null}
Campaign: Product Information

Trigger 1:
  Type: Comment
  Description: 'Comments asking about the product'

Trigger 2:
  Type: DM
  Description: 'DMs asking for product details'

Trigger 3:
  Type: Comment
  Description: "Any comment containing 'price' or 'cost'"
```

<Tip>
  Using multiple triggers ensures you capture all interested users regardless of how they reach out.
</Tip>

## FAQ

<AccordionGroup>
  <Accordion title="How does natural language triggering work?" icon="circle-question">
    Instead of exact keyword matching, Blueberry's AI understands the **intent** behind comments and DMs.

    This means "interested!" and "I want this" and "where can I buy?" can all match a trigger for "comments showing buying interest" - even though they use different words.

    <Check>
      This makes triggers more reliable and catches more relevant users without false positives.
    </Check>
  </Accordion>

  <Accordion title="Can I see which comments matched my triggers?" icon="circle-question">
    Yes! In your campaign dashboard, you can view all triggered actions and see exactly which comments or DMs activated the campaign.

    This helps you refine your trigger descriptions if needed.
  </Accordion>

  <Accordion title="What happens if multiple triggers match?" icon="circle-question">
    Only one trigger fires per user per campaign. If multiple triggers match the same action, the first matching trigger wins.

    <Note>
      Each user can only be triggered once per campaign (unless you enable re-triggering in campaign settings).
    </Note>
  </Accordion>

  <Accordion title="Do triggers work on ads?" icon="circle-question">
    Yes! Comment triggers work on both organic posts and paid ads on Instagram and Facebook.
  </Accordion>

  <Accordion title="Can I pause or disable specific triggers?" icon="circle-question">
    Yes. You can enable/disable individual triggers without affecting the campaign or other triggers.

    This is useful for testing or temporarily pausing specific trigger conditions.
  </Accordion>

  <Accordion title="Do campaigns have priority?" icon="circle-question">
    Yes! Campaigns are evaluated in order from top to bottom in your campaigns list.

    When a user action (comment or DM) occurs, Blueberry checks each active campaign in order. The **first campaign** whose trigger matches will activate for that user.

    <Tip>
      If you have multiple campaigns that could match the same action, put the most specific campaign first to ensure it triggers before more general ones.
    </Tip>
  </Accordion>
</AccordionGroup>

## Related Pages

<CardGroup cols={2}>
  <Card title="Campaign Types" icon="bullseye" href="/dms/campaigns/types">
    Learn about different campaign objectives and when to use each
  </Card>

  <Card title="DM Inbox" icon="inbox" href="/inbox/dms">
    View and manage all DM conversations from campaigns
  </Card>
</CardGroup>