Slack Integration

Send notifications and messages to Slack

What is Slack?

Slack is a team communication platform. You can integrate it with your app to send notifications, alerts, and messages directly to your Slack channels.

Perfect for:

• Team notifications (new orders, signups, errors)
• Alert messages (payment received, system down)
• Daily reports and summaries
• Customer support alerts
• Monitoring and logging

What You’ll Need

1. Slack Workspace

   You need access to a Slack workspace

2. Create Slack App

   Set up a simple Slack app

3. Get Webhook URL

   Get your incoming webhook URL

4. A good initial prompt

   Read on for clarity

Here’s a helpful video to get you started.

Step 1: Create a Slack App

Create the App

1. Go to api.slack.com/apps
2. Click Create New App
3. Choose From scratch
4. Fill in:
   • App Name: Your app name (like “My App Notifications”)
   • Workspace: Choose your Slack workspace
5. Click Create App

Enable Incoming Webhooks

1. In your app settings, click Incoming Webhooks
2. Toggle Activate Incoming Webhooks to On
3. Scroll down and click Add New Webhook to Workspace
4. Choose which channel to post to (like #general or #notifications)
5. Click Allow

Get Your Webhook URL

You’ll see a Webhook URL that looks like:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXX

Copy this URL! This is what you’ll give to the agent.

Keep this URL secret! Anyone with it can post to your Slack channel.

Step 2: Tell the Agent What You Want

Describe what notifications you need:

Example 1: New User Signup Notifications

I want Slack notifications when users sign up.

Slack Webhook URL: https://hooks.slack.com/services/T.../B.../XXX

When a new user signs up, send message to Slack with:
- User's name
- Email
- Signup time
- Link to their profile (if applicable)

Message format:
"🎉 New signup! John Doe ([e-mail]) just joined!"

Please set this up.

Example 2: Order Notifications

Send Slack alerts for new orders.

Slack Webhook URL: https://hooks.slack.com/services/T.../B.../XXX

When someone places an order, notify Slack with:
- Customer name
- Order total
- Items ordered
- Order ID

Make the message formatted and easy to read.

Please set this up.

Example 3: Error Monitoring

I need error alerts in Slack.

Slack Webhook URL: https://hooks.slack.com/services/T.../B.../XXX

When an error occurs in my app:
- Send alert to Slack
- Include error message
- Include which page/feature
- Timestamp
- Severity level (color-coded: red for critical)

Please build this.

Example 4: Daily Summary Reports

Send daily summary to Slack every morning.

Slack Webhook URL: https://hooks.slack.com/services/T.../B.../XXX

Every day at 9 AM, send message with:
- Total new signups (yesterday)
- Total revenue
- Number of orders
- Top selling item

Format it nicely with emojis and sections.

Please set this up.

That’s it! The agent will handle sending messages to Slack when events happen.

Step 3: Test Your Integration

After setup:

1. Click Preview

   In Emergent, click Preview

2. Trigger the Event

   Do whatever should trigger the notification:

   • Sign up a test user
   • Place a test order
   • Trigger an error
3. Check Slack

   Go to your Slack workspace

   Check the channel you selected

   You should see the notification!

4. Verify Message

   Make sure the message has:

   • Correct information
   • Good formatting
   • Emojis (if you wanted them)

Message Formatting Tips

Use Emojis for Visual Impact

Tell the agent:
"Use these emojis in messages:
- 🎉 for new signups
- 💰 for payments
- ⚠️ for warnings
- 🔴 for errors
- ✅ for success"

Color-Coded Messages

Tell the agent:
"Make Slack messages color-coded:
- Green for success (payments, signups)
- Yellow for warnings
- Red for errors
- Blue for info"

Rich Formatting

Tell the agent:
"Format Slack messages with:
- Bold text for important info
- Bullet points for lists
- Links to relevant pages
- Sections for organization"

Common Questions

Is Slack integration free?

Yes! Slack’s incoming webhooks are completely free.

No API limits for basic notifications.

Perfect for all apps!

Can I send to multiple channels?

Yes! Create multiple webhooks. Tell the agent:

I have multiple Slack channels:

Webhook 1 (sales): https://hooks.slack.com/.../XXX
Webhook 2 (support): https://hooks.slack.com/.../YYY
Webhook 3 (errors): https://hooks.slack.com/.../ZZZ

Send new orders to #sales
Send support tickets to #support
Send errors to #errors

Can I send images in messages?

Yes! Tell the agent:

When sending order notifications to Slack,
include product images in the message.

Make it look nice and visual.

What about interactive buttons?

For interactive features (buttons, menus), you need the Slack API.

Tell the agent:

I want Slack messages with buttons:
- "Approve" button
- "Reject" button

When clicked, update in my app.

Please use Slack API for this.

(Requires more setup than basic webhooks)

Something Not Working?

Messages Not Appearing

Tell the agent:

Slack messages aren't being sent.
Events are triggering but nothing appears in Slack.

My webhook URL: https://hooks.slack.com/.../XXX

Can you debug this?

Wrong Channel

Tell the agent:

Messages going to wrong Slack channel.
They should go to #notifications but going to #general.

Can you create a new webhook for the right channel?

Message Format Broken

Tell the agent:

Slack messages look messy.
Can you format them better with:
- Line breaks
- Bold text for titles
- Organized sections

---

Real Examples

Example 1: E-commerce Monitoring

Complete e-commerce Slack notifications.

Slack webhooks:
- Sales channel: https://hooks.slack.com/.../XXX
- Inventory channel: https://hooks.slack.com/.../YYY

Notifications to send:
1. New order placed (to #sales)
   - Customer info
   - Order details
   - Total amount

2. Low inventory alert (to #inventory)
   - When product stock < 5
   - Product name and current stock

3. Payment failed (to #sales)
   - Customer name
   - Reason for failure

Please set all this up.

Example 2: SaaS App Monitoring

Monitor my SaaS app via Slack.

Slack webhook: https://hooks.slack.com/.../XXX

Send notifications for:
- New trial signup (🎉)
- Trial converted to paid (💰)
- User cancelled subscription (😔)
- Critical error occurred (🚨)
- Daily active users summary (every evening)

Make messages informative and emoji-rich.

Please build this.

Example 3: Customer Support System

Customer support alerts in Slack.

Slack webhook: https://hooks.slack.com/.../XXX

When customer submits support ticket:
- Alert in Slack immediately
- Include customer name and email
- Show their issue/question
- Priority level (high/medium/low)
- Link to ticket in app

High priority tickets should be red-colored.

Please set this up.

Advanced Features

Slack API (Beyond Webhooks)

For more advanced features, tell the agent:

I need advanced Slack integration using Slack API.

Features:
- Send direct messages to specific users
- Read messages from channel
- Add reactions to messages
- Update existing messages
- Interactive buttons

I'll provide:
- Slack Bot Token
- Channel IDs
- Other credentials needed

Please set this up.

Getting Slack API Access:

1. In your Slack app settings
2. Go to OAuth & Permissions
3. Add required scopes
4. Install app to workspace
5. Copy Bot User OAuth Token

Slash Commands

Create Slack slash command for my app.

Command: /check-status

When someone types /check-status in Slack:
- App checks current system status
- Returns formatted message with:
  - Server status
  - Database status
  - Recent errors
  - Uptime

Please build this.

Two-Way Communication

Enable two-way Slack communication:

When ticket created in app → Send to Slack
When team replies in Slack thread → Update ticket in app

Keep everything in sync.

Please set this up.

Multiple Workspaces

If you have multiple Slack workspaces:

I need to send to different Slack workspaces:

Workspace 1 (Company A):
Webhook: https://hooks.slack.com/.../AAA
For: Client A orders and issues

Workspace 2 (Company B):
Webhook: https://hooks.slack.com/.../BBB
For: Client B orders and issues

Route messages to correct workspace based on client.

Please set this up.

Scheduling Slack Messages

Daily Reports

Send daily report to Slack every day at 9 AM.

Slack webhook: https://hooks.slack.com/.../XXX

Report should include:
- Yesterday's stats (signups, revenue, orders)
- Top performing items
- Any issues or alerts
- Nice formatting with sections

Schedule this daily.

Weekly Summaries

Send weekly summary every Monday at 9 AM.

Include:
- Last week's total revenue
- New customers count
- Best selling products
- Charts/graphs (if possible)

To Slack webhook: https://hooks.slack.com/.../XXX

Message Templates

Simple Text

Message format:
"New user signup: [name] ([email])"

Formatted with Sections

Message format:
"
🎉 New Order Received!

Customer: John Doe
Email: [e-mail]
Order ID: #12345
Total: $99.00

Items:
• Product A (x2) - $50.00
• Product B (x1) - $49.00

View Order: [link]
"

With Attachments (Rich Format)

Use Slack message attachments:
- Title: "New Support Ticket"
- Color: Orange
- Fields:
  - Customer: John Doe
  - Priority: High
  - Category: Technical Issue
- Footer: Received at [timestamp]
- Button: View Ticket

Best Practices

1. Use descriptive messages - Include all important info
2. Add emojis - Makes messages easier to scan
3. Include links - Link to relevant pages in your app
4. Color-code by importance - Red for urgent, green for good news
5. Don’t spam - Batch notifications if needed

Avoid This

1. Too many notifications - Will annoy your team
2. Unclear messages - “Something happened” isn’t helpful
3. Missing context - Always include relevant details
4. No links - Make it easy to take action
5. Plain text only - Use formatting and emojis

Rate Limiting

Slack has generous limits, but if sending many messages:

Tell the agent:
"I'm sending many Slack notifications.
Can you add rate limiting so we don't hit Slack's limits?

Batch notifications if needed:
- Collect for 5 minutes
- Send one summary message
Instead of individual messages."

Troubleshooting Guide

Common Errors

“Invalid webhook URL”

• Check you copied the full URL
• Make sure it starts with https://hooks.slack.com/services/

“Messages delayed”

• Might be network issues
• Check your server logs

“Messages not formatted”

• Need to use proper Slack formatting
• Ask agent to use Slack’s block kit

Quick Checklist

Before going live, check that you have:

• Created Slack app
• Got webhook URL
• Tested sending messages
• Messages appear in correct channel
• Formatting looks good
• Emojis working
• Links clickable
• Not too many notifications

Remember

Completely free - No API costs

Easy to set up - Just need webhook URL

Great for teams - Keep everyone informed

Rich formatting - Make messages beautiful

No rate limits (reasonable use) - Send lots of messages

Multiple channels - Create multiple webhooks

Quick start: Get your webhook URL from Slack and tell the agent what notifications you want. Works in 5 minutes!

Need Help?

Can’t Find Webhook URL

In Slack app settings:
1. Click "Incoming Webhooks"
2. Scroll to bottom
3. Look for "Webhook URLs for Your Workspace"
4. Copy the URL

If you don't see it:
- Make sure webhooks are activated (toggle at top)
- Add new webhook to workspace

Want to Change Channel

Create a new webhook for the new channel:
1. In Slack app → Incoming Webhooks
2. Click "Add New Webhook to Workspace"
3. Choose new channel
4. Get new URL

Tell agent: "Use this new webhook URL: [paste URL]"

Messages Too Frequent

Tell the agent:
"Slack messages are too frequent. Can you:
1. Batch them together
2. Send summary every 5 minutes
3. Only send if more than 5 events
Instead of one message per event."

Pro tip: Start with simple notifications, then add more as needed. It’s better to add features gradually than to spam your Slack with too many alerts!