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

# New Message

> Trigger workflows when new Slack messages mention the @Markifact bot.

**New Message** triggers your workflow when someone mentions @Markifact in a Slack message. Perfect for creating interactive workflows that respond to team requests, questions, or commands directly from Slack channels.

***

## Inputs

| Field        | Type   | Required | Description                                                                  |
| ------------ | ------ | -------- | ---------------------------------------------------------------------------- |
| **Channels** | Select | Yes      | Listen to any channel or specific channels where bot is present              |
| **Channel**  | Select | Yes\*    | Specific channel to monitor (\*Required when "Specific channel" is selected) |

***

## How It Works

This trigger listens for messages in Slack channels where the @Markifact bot has been mentioned. When someone types a message that includes @Markifact, the workflow is triggered with the message content and details.

### ⚠️ Important Requirements

**Bot Must Be Mentioned**:

* Only messages that mention **@Markifact** will trigger workflows
* Regular messages without the bot mention are ignored
* This prevents workflows from triggering on every channel message

**Bot Must Be Added to Channels**:

* The Markifact bot must be a member of channels you want to monitor

***

## Bot Setup Requirements

### Adding Bot to Channels

**For Public Channels:**

1. **Go to the channel** you want to monitor
2. **Type @Markifact** in a message
3. **Slack will prompt** to invite the bot
4. **Click "Invite to Channel"**

**For Private Channels:**

1. **Go to the private channel**
2. **Type @Markifact** to invite the bot
3. **The bot must be added** before it appears in channel dropdown
4. **Once added**, the channel will be available for selection

### Channel Dropdown Behavior

* **Public channels**: Usually appear in dropdown automatically
* **Private channels**: Only appear after bot is manually added
* **Missing channels**: Check if bot has been invited to the channel

***

## Configuration Examples

### Team Request Handler

**Scenario:** Trigger workflows when team mentions @Markifact for reports

**Configuration:**

* **Channels:** "Specific channel"
* **Channel:** "#marketing-requests"

**Usage:** Team members type "@Markifact generate weekly report" to trigger report workflow.

### Multi-Channel Support Bot

**Scenario:** Respond to @Markifact mentions across all channels

**Configuration:**

* **Channels:** "Any channel where bot is present"

**Usage:** Bot responds to mentions in any channel it's been added to.

***

## Common Use Cases

### Google Analytics AI Agent

**Trigger**: "@Markifact how much traffic did we get last week?"

**Workflow**: AI Agent → Send Slack Message

***

## Troubleshooting

### "Channel not showing in dropdown"

**Problem**: Private channel missing from selection
**Solution**:

1. Go to the private channel
2. Type @Markifact to invite the bot
3. Refresh the workflow editor
4. Channel should now appear in dropdown

### "Bot not responding to mentions"

**Problem**: Messages with @Markifact not triggering workflow
**Solutions**:

* Verify bot is member of the channel
* Check if @Markifact is actually mentioned in the message
* Ensure workflow is published and active
* Check workflow history for error messages

### "Permission denied errors"

**Problem**: Bot can't access channel content
**Solution**:

* Re-invite bot to channel with proper permissions
* Check Slack workspace bot permissions
* Verify bot has necessary scopes for channel access

***

## Credit Cost

1 credit per successful run.

***

## FAQ

<Accordion title="Why isn't my private channel showing in the dropdown?">
  **Private channels only appear after the bot is added.** Go to your private channel, type @Markifact in a message, and invite the bot. Once the bot is a member, refresh your workflow editor and the channel will appear in the dropdown.
</Accordion>

<Accordion title="Will I know if Markifact received my message?">
  **Yes! Markifact automatically reacts with a ⚡ emoji** to confirm it received your @Markifact mention. This happens immediately while your workflow is being processed. Look for the lightning bolt reaction on your message to know the bot is working on your request.
</Accordion>

<Accordion title="I'm testing my workflow but only see test data - why?">
  **Manual testing from the workflow editor shows placeholder data.** You'll see test messages like:

  "This is a test message" and test IDs like "test\_channel\_id" and "test\_user" instead of real Slack data.

  **To see actual data, you must activate your workflow** (turn on the switch at the top) and then go to Slack to send a real @Markifact mention.
</Accordion>

<Accordion title="I sent a @Markifact message but nothing happened - what's wrong?">
  **Check if your workflow is active!** The most common issue is that the workflow isn't turned on. Look for the switch button at the top of your workflow editor and make sure it's activated. If the workflow is off, it won't respond to Slack messages even if everything else is set up correctly.
</Accordion>

<Accordion title="Do I have to mention @Markifact in every message?">
  **Yes, only messages that mention @Markifact trigger workflows.** This prevents the bot from responding to every message in a channel. Regular conversation continues normally - only @Markifact mentions activate automation.
</Accordion>

<Accordion title="Can I use this trigger across multiple channels at once?">
  **Yes! Choose "Any channel where bot is present"** to listen across all channels the bot has access to. You can also create multiple triggers for specific channels if you need different workflows for different channels.
</Accordion>

<Accordion title="What happens if the bot isn't in the channel I selected?">
  **You'll get an error: "The Slack bot is not a member of the specified channel."** To fix this, go to the channel and type @Markifact to invite the bot. The channel dropdown only shows channels where the bot is already a member.
</Accordion>

<Accordion title="Can team members see when the bot is added to channels?">
  **Yes, Slack shows a notification when bots are added to channels.** This is normal Slack behavior. Team members will see that the Markifact bot has joined, which actually helps them know they can use @Markifact mentions.
</Accordion>

<Accordion title="What data is available from the triggered message?">
  **The trigger provides the message text, sender information, channel details, timestamp, and thread information** if the message is part of a thread. This data can be used in subsequent workflow steps.
</Accordion>

<Accordion title="Can I filter messages beyond just the @Markifact mention?">
  **The trigger activates on any @Markifact mention.** For more sophisticated filtering, use subsequent workflow nodes with conditional logic to process the message content and decide how to respond.
</Accordion>

<Accordion title="Will this work with Slack threads?">
  **Yes, @Markifact mentions in thread replies will trigger workflows.** The trigger includes thread information, so you can even respond back to the same thread using the Send Message node with the thread ID.
</Accordion>