Inbox troubleshooting
Fixes for the most common Team Inbox and contacts problems: missing conversations or folders, replies that won't send, permission errors and missing filters.
- Who can use this
- Account owner, Manager, Agent
Fixes for the most common Team Inbox and contacts problems: missing conversations or folders, replies that won't send, permission errors and missing filters.
Use this page when something in the Team Inbox or the contacts list is missing or refuses to work. Most problems come from three things: what your role allows, which channels you can use, and the messaging window. Each row links to the page with the full steps.
The Team Inbox is Sidebar → Team Inbox; contacts are Sidebar → Contacts. What each person sees depends on their role (Manager, Team Lead or Staff) and their extra permissions, set by a manager under Teams (see Users, roles and permissions).
Check three things first:
| What you see | Why | What to do |
|---|---|---|
| Team Inbox is missing from the sidebar | Your role cannot use chats | Ask a manager to change your role |
| The Unassigned folder is missing | Staff need the Unassigned Conversations Tab permission. Managers and team leads have it already | Ask a manager to add it |
| Another folder (for example Closed) is missing | Your role cannot view that folder | Ask a manager |
| "Permission Denied — Acquire permission to view this conversation" | The conversation belongs to someone else | Ask the assignee or a manager to transfer or share it (Share a conversation) |
| A colleague's chat never appears for you | Staff see their own chats and unassigned chats of their teams only | A manager can give Manage Conversations ("Full access to all conversations… same as manager"), or share the chat with you |
| Shared with me is missing | Shared chats are off for your workspace, or not in your plan | See Share a conversation |
| No SLA group in the inbox | SLA is not on your plan or is switched off | Check Billing → Current Plan; a manager turns SLA on in General Settings |
| What you see | Why | What to do |
|---|---|---|
| "Conversation doesn't have an active session. Only template messages can be sent." | The messaging window is closed | Send an approved WhatsApp template |
| "You don't have permission to send messages in this conversation." / You can only read this conversation | The chat is assigned to someone else, or your role cannot reply | Ask the assignee or a manager to transfer it to you |
| "Shared with you to read. You can't reply." | The chat was shared with you as Read only | Ask for Read and reply |
| "You no longer have access to this chat." | Someone stopped sharing it with you | Ask the assignee |
| "Message not sent" with a reason on the bubble | The channel refused the message | Read the reason. For window errors, send a template. For Meta error codes, see Common Meta error codes |
| A product carousel failed: "This carousel failed because the catalog isn't connected to this WhatsApp number…" (or "most likely failed") | Meta refused it with error #131009. A carousel needs the catalog connected to the number in WhatsApp Manager | Click Send as product list instead on the failed message (it then shows Sent as a product list), or connect the catalog in WhatsApp Manager → Account tools → Catalogue |
| What you see | Why | What to do |
|---|---|---|
| "To send products as a carousel, connect this catalog to your WhatsApp number…" and Send as product carousel can't be ticked | The cart's catalog is not connected to this number | Send as a list, or connect the catalog in WhatsApp Manager, then click Check again |
| "This WhatsApp number has a different catalog connected…" | Another catalog is connected to the number | Connect this catalog, or send as a list |
| "We couldn't check whether this catalog is connected…" / "This number uses the WhatsApp Business app…" | The connection could not be checked | A carousel may fail; a product list is safer |
| "Some products in the cart are missing catalog details. Remove them and add them again from the Shop tab." | Old items in the cart have no catalog | Remove them and add them again |
| "The cart has products from more than one catalog…" / "These products are from another WhatsApp number's catalog…" | One message can show products from one catalog only | Remove the others, or clear the cart |
See Send catalog messages for the cart steps.
| What you see | Why | What to do |
|---|---|---|
| The assign icon is greyed out | You cannot assign this conversation | Ask a manager or your team lead |
| "Couldn't assign — … doesn't have access to this conversation's channel." | That person cannot use this number | Pick someone else, or give them channel access under Teams |
| Create "…" in the tag picker does nothing, or "Couldn't change tags" | Only managers create and manage tags, or (with Strict access) your access level on this chat does not allow tagging | Ask a manager (Tags) |
| No Team or Company option when saving a quick message | Staff manage only their own private quick messages; company-wide ones need Manage Quick Messages | Ask a manager (Quick messages) |
| No Assigned To option in Add Filter | Filtering by assignee needs Filter Conversations By Staff (managers and team leads have it) | Ask a manager |
| SLA Policies is missing from Settings | Needs the SLA feature, and Manage SLA for non-managers | Check your plan, or ask a manager (SLA policies) |
| What you see | Why | What to do |
|---|---|---|
| Contacts is missing from the sidebar | Your role lacks Manage Contacts ("View and manage all contacts") | Ask a manager |
| No Add Contact button | Your role lacks Create Contact | Ask a manager |
| No import or export | Import needs Contact Import; export needs Contact Export | Ask a manager (Import contacts, Export contacts) |
| You can't create or edit groups, or merge them | Groups need Manage Contact Groups; merging needs Merge Contact Groups (merging cannot be undone) | Ask a manager (Contact groups and saved filters) |
| "This contact is outside your contact groups." (or "Some of these contacts are outside your contact groups.") | Your contacts are limited to some groups | Ask a manager to add the contact to one of your groups |
SLA and shared chats depend on your plan. Check Billing → Current Plan. After a manager changes your role or permissions, reload the panel.
Do it with Copilot
(inbox_get_conversation, read-only. The Copilot acts with your own permissions, so it sees what you see.)
Do it with Copilot
(workspace_team, read-only)