📥 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)
➕ Add New Inbox
Step by Step
- In the sidebar, click “Settings” → “Inboxes”
- Click ”+ Add Inbox”
- Choose channel type
- Follow specific instructions for each channel
- Assign agents to the inbox
- Done! Start receiving messages
Integration Options
Chatwoot supports 3 ways to connect WhatsApp:Evolution API
Most stable and reliable
Multi-device
Ideal for production
Multi-device
Ideal for production
WAHA
Open-source
Self-hosted
Free
Self-hosted
Free
UAZ API
Brazilian provider
PT-BR support
Easy setup
PT-BR support
Easy setup
Configure WhatsApp (Evolution API)
- Get API Key from your Evolution provider
- In Chatwoot: “Add Inbox” → “WhatsApp”
- Choose “Evolution API”
- Fill in:
- Inbox Name: e.g., “Sales WhatsApp”
- API URL: Your Evolution server URL
- API Key: Your authentication key
- Scan QR Code with WhatsApp
- Assign agents to inbox
- 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.
- Add Inbox → “Instagram”
- Click “Connect with Facebook”
- Login to Facebook
- Choose the Facebook Page connected to Instagram
- Authorize permissions
- Select Instagram account
- 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
- Add Inbox → “Facebook Messenger”
- Click “Connect with Facebook”
- Login
- Choose the Page you want to connect
- Authorize permissions
- 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!- Add Inbox → “Email”
- Fill in information:
- Server: imap.gmail.com (Gmail)
- Port: 993
- Email: [email protected]
- Password: Email password (or App Password)
- Server: smtp.gmail.com (Gmail)
- Port: 587
- Email: [email protected]
- Password: Email password
- Test connection
- Assign agents
Common Providers
| Provider | IMAP | IMAP Port | SMTP | SMTP Port |
|---|---|---|---|---|
| Gmail | imap.gmail.com | 993 | smtp.gmail.com | 587 |
| Outlook | outlook.office365.com | 993 | smtp.office365.com | 587 |
| Yahoo | imap.mail.yahoo.com | 993 | smtp.mail.yahoo.com | 587 |
| Custom | your-server.com | 993/143 | your-server.com | 587/465 |
🌐 Website Widget (Website Chat)
Install Chat on Website
- Add Inbox → “Website”
- Give it a name: e.g., “Main Website Chat”
- Configure appearance:
- Primary Color: Your brand color
- Welcome Message: “Hello! How can I help?”
- Avatar: Company logo
- Copy installation code:
- Paste before
</body>on your website - Reload site and test!
💬 Telegram
Create Telegram Bot
- On Telegram, talk to @BotFather
- Send
/newbot - Choose name and username for bot
- Copy the Token provided
Connect to Chatwoot
- Add Inbox → “Telegram”
- Paste bot Token
- Give inbox a name
- Assign agents
- 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

