Skip to main content

📥 Inboxes & Channels

Learn how to connect and manage all support channels in Chatwoot: WhatsApp, Instagram, Facebook, Email, website chat, and more!

📋 What are Inboxes?

Inbox is each communication channel where you receive messages from customers:
  • 💬 WhatsApp Business
  • 📷 Instagram Direct
  • 📘 Facebook Messenger
  • 📧 Email (IMAP/SMTP)
  • 🌐 Website Widget (website chat)
  • 💬 Telegram
  • 📱 SMS
  • ☎️ Phone (via integration)
Each inbox works as a separate “mailbox”, but all support is centralized in Chatwoot!

➕ Add New Inbox

Step by Step

  1. In the sidebar, click “Settings” → “Inboxes”
  2. Click ”+ Add Inbox”
  3. Choose channel type
  4. Follow specific instructions for each channel
  5. Assign agents to the inbox
  6. Done! Start receiving messages

💬 WhatsApp

Integration Options

Chatwoot supports 3 ways to connect WhatsApp:

Evolution API

Most stable and reliable
Multi-device
Ideal for production

WAHA

Open-source
Self-hosted
Free

UAZ API

Brazilian provider
PT-BR support
Easy setup

Configure WhatsApp (Evolution API)

  1. Get API Key from your Evolution provider
  2. In Chatwoot: “Add Inbox” → “WhatsApp”
  3. Choose “Evolution API”
  4. Fill in:
    • Inbox Name: e.g., “Sales WhatsApp”
    • API URL: Your Evolution server URL
    • API Key: Your authentication key
  5. Scan QR Code with WhatsApp
  6. Assign agents to inbox
  7. Test by sending a message

WhatsApp Features

✅ Send/Receive text messages
✅ Media: Images, videos, audios, documents
✅ Templates: Pre-approved WhatsApp messages
✅ Interactive buttons: Quick replies
✅ Lists: Option menus
✅ Location: Share/receive location
✅ Contacts: Send vCard

📷 Instagram Direct

Connect Instagram

Requirement: You need an Instagram Business account linked to a Facebook page.
  1. Add Inbox → “Instagram”
  2. Click “Connect with Facebook”
  3. Login to Facebook
  4. Choose the Facebook Page connected to Instagram
  5. Authorize permissions
  6. Select Instagram account
  7. Assign agents

Instagram Features

✅ Direct Messages: Handle DMs directly in Chatwoot
✅ Comments: (Optional) Receive post comments
✅ Stories: Story replies appear as messages
✅ Media: Photos, videos, GIFs
✅ Quick Replies: Send saved responses

📘 Facebook Messenger

Connect Facebook

  1. Add Inbox → “Facebook Messenger”
  2. Click “Connect with Facebook”
  3. Login
  4. Choose the Page you want to connect
  5. Authorize permissions
  6. Assign agents

Facebook Features

✅ Page Messages: Handle messages directly
✅ Comments: (Optional) Turn comments into conversations
✅ Media: Share photos, videos, GIFs
✅ Buttons: Use quick reply buttons

📧 Email (IMAP/SMTP)

Configure Email

Turn your email into a Chatwoot inbox!
  1. Add Inbox → “Email”
  2. Fill in information:
IMAP (Receive):
  • Server: imap.gmail.com (Gmail)
  • Port: 993
  • Email: your@email.com
  • Password: Email password (or App Password)
SMTP (Send):
  • Server: smtp.gmail.com (Gmail)
  • Port: 587
  • Email: your@email.com
  • Password: Email password
  1. Test connection
  2. Assign agents

Common Providers


🌐 Website Widget (Website Chat)

Install Chat on Website

  1. Add Inbox → “Website”
  2. Give it a name: e.g., “Main Website Chat”
  3. Configure appearance:
    • Primary Color: Your brand color
    • Welcome Message: “Hello! How can I help?”
    • Avatar: Company logo
  4. Copy installation code:
  1. Paste before </body> on your website
  2. Reload site and test!

💬 Telegram

Create Telegram Bot

  1. On Telegram, talk to @BotFather
  2. Send /newbot
  3. Choose name and username for bot
  4. Copy the Token provided

Connect to Chatwoot

  1. Add Inbox → “Telegram”
  2. Paste bot Token
  3. Give inbox a name
  4. Assign agents
  5. Done! Messages to bot appear in Chatwoot

📊 Inbox Metrics

Track performance of each channel:

Available Metrics

  • Total Conversations: How many conversations per channel
  • Average Response Time: Per inbox
  • Resolution Rate: % of resolved conversations
  • Satisfaction (CSAT): Average rating per channel
  • Peak Hours: When receives most messages

💡 Tips and Best Practices

Organization

✅ Clear names: “Sales WhatsApp”, “Support Email”
✅ One inbox per function: Separate sales from support
✅ Specific agents: Assign specialists per channel
✅ Correct hours: Configure business hours

Performance

✅ Auto-assignment: Use Round Robin or Capacity
✅ Canned Responses: Create templates for common replies
✅ Labels per channel: Organize conversations by source

Customer Experience

✅ Reply fast: Configure agent notifications
✅ Personalize welcome: Warm and helpful message
✅ Out of hours: Inform when you’ll return
✅ Multi-channel: Offer options to customer

🚀 Next Steps

Conversation Management

Learn to manage support

Automations

Automate replies and assignments