Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.socializioz.com/llms.txt

Use this file to discover all available pages before exploring further.

The inbox lets you manage Instagram direct message conversations without leaving Socializioz. You can read incoming messages, reply to followers, and switch between multiple Instagram accounts.

Supported platforms

PlatformCapabilities
InstagramView conversations, read messages, send text replies
Direct message support is currently available for Instagram only. Facebook Messenger, X DMs, LinkedIn messages, and other platforms are not supported at this time. The comments feature covers Facebook and Instagram post comments separately — see comments.

Requirements

To use the inbox, your Instagram account must have the instagram_manage_messages permission granted. This permission is requested during the OAuth connection flow. If the permission is missing, the inbox displays an error prompting you to reconnect your Meta account. To fix this:
1

Go to connections

Open the connections page.
2

Disconnect the account

Remove the affected Instagram account.
3

Reconnect

Connect the Instagram account again and make sure you approve all requested permissions during the OAuth flow.

Switching between accounts

If you have multiple Instagram accounts connected, they appear as pill-shaped tabs in the toolbar at the top of the inbox. Each tab shows the Instagram icon and the account name. The first account is selected automatically when you open the page. Tap a different account tab to switch. Switching accounts clears your current conversation selection and reloads the conversation list for the new account. On mobile, the view returns to the conversation list.

Using the inbox

1

Open the inbox

Navigate to the Inbox page from the workspace sidebar or the More menu on mobile.
2

Select an account

If you have multiple Instagram accounts connected, choose the one you want to manage from the account tabs. The first account is selected automatically.
3

Pick a conversation

The conversation list shows recent DM threads with participant names and a preview of the last message (truncated to 60 characters). Messages you sent are prefixed with “You:”. Select a conversation to open it.
4

Read and reply

The message thread displays the full conversation history. Type your reply in the input field at the bottom and press Enter to send. Use Shift + Enter to add a new line without sending.

Conversation list

Each conversation row shows:
  • A circular avatar with the first letter of the participant’s name
  • The participant name (or “Instagram User” if not available from the platform)
  • A relative timestamp for the last activity (for example, “5m”, “2h”, “3d”, or a date like “26 Mar” for older threads)
  • A message preview truncated to 60 characters, prefixed with “You:” for messages you sent
While conversations are loading, animated skeleton placeholders appear in place of the list.

Empty states

StateWhat you see
No Instagram accounts connectedA prompt to connect an account with a Connect Account button linking to the connections page
No conversations”No conversations yet” with a note that conversations appear when someone messages your Instagram account
No messages in a thread”No messages” displayed in the center of the thread area
No conversation selected (desktop)“Select a conversation to start” with a send icon

Message display

  • Your messages appear on the right side in blue
  • Received messages appear on the left
  • Each message shows the time it was sent in 12-hour format (for example, “2:34 PM”)
  • Participant names default to “Instagram User” if the name is not available from the platform

Current limitations

The inbox currently supports text messages only. Images, videos, stickers, story replies, shared posts, shared reels, voice messages, reactions, and other media types are not displayed — media-only messages appear as empty bubbles. You cannot send media attachments. To see the full conversation including media, open the Instagram app directly.
LimitationDetails
Text onlyYou can send and receive text messages. Media-only messages appear as empty bubbles. Sending media is not supported.
Conversation limitThe inbox loads your most recent 25 conversations and 20 messages per thread. Older conversations and messages are not available. There is no pagination to load more.
No searchYou cannot search conversations or messages by keyword.
No deep linkingYou cannot link directly to a specific conversation. Navigating away from the inbox resets your conversation selection.
No real-time updatesConversations do not refresh automatically. You must manually refresh to see new messages — see syncing.
No read receiptsThe inbox does not show whether your message has been read by the recipient.
No message deletionYou cannot delete or unsend messages from within Socializioz. Use the Instagram app to manage sent messages.

Thread organization

Conversations are organized as one-to-one threads between your Instagram account and individual users. Group conversations are not supported. Each thread shows messages from a single participant, sorted chronologically.

Desktop and mobile layout

On desktop, the inbox shows the conversation list and message thread side by side. On mobile, the inbox switches between a conversation list view and a message thread view. Tap a conversation to open the thread, and use the back button to return to the list.

Syncing

Conversations do not refresh automatically in the background. To see new messages, you need to refresh manually:
  • Desktop — click the refresh button in the toolbar.
  • Mobile — pull down from the top of the conversation list to refresh.
The last synced time is shown next to a clock icon in the toolbar on desktop. It displays as a time-only value (for example, “2:30 PM”) in your configured timezone. The synced time indicator is not visible on mobile.
If you are actively messaging with someone, tap the refresh button after each exchange to load their latest reply.

Notifications for new messages

New direct messages do not currently trigger in-app notifications or badge updates on the inbox icon. You need to manually check the inbox or refresh to see new messages. For real-time DM alerts, use the Instagram app’s native push notifications.

Message character limits

Instagram DMs support messages up to 1,000 characters. The inbox does not enforce this limit in the input field, but messages exceeding the limit may fail to send. Keep replies concise.

Sending messages

When you send a reply:
  1. Your message text is cleared from the input field immediately.
  2. A spinner appears on the send button while the message is being delivered.
  3. Once delivered, the conversation list and message thread both refresh to show your sent message.
The send button is disabled when the input field is empty or while a message is in transit.
If sending fails (for example, due to a network error), your message text is not preserved in the input field. You will need to retype your reply and try again. Consider copying important messages to your clipboard before sending.

When to use the inbox vs. Instagram directly

The Socializioz inbox is designed for quick text-based responses within your existing workflow. Use it when you want to reply to followers without leaving your workspace. Switch to the native Instagram app when you need to:
  • View or send images, videos, voice messages, or story replies
  • Access conversations older than your most recent 25
  • Read full message history beyond 20 messages per thread
  • Delete or unsend messages
  • Use group conversations
Pair the inbox with comments for a complete engagement workflow. Comments covers public Facebook and Instagram post replies with AI-assisted responses, while the inbox handles private Instagram DMs.

Quick replies and templates

Socializioz does not include saved quick replies or template responses for DMs. If you frequently send similar replies (such as business hours, pricing, or FAQ answers), consider these workarounds:
  • Text snippets — use your operating system’s built-in text replacement feature (macOS Text Replacements, Windows clipboard history, or a text expander app) to store and paste common responses.
  • AI chat assistant — open the AI chat in a side panel, ask it to draft a reply based on the message context, and paste the result into the inbox reply field.
  • Notes document — keep a shared document with your team containing approved response templates. Copy and paste as needed.

Best practices for managing DMs

  • Check the inbox at set intervals — since messages do not auto-refresh, build a habit of opening the inbox and tapping refresh at the start and end of each work session.
  • Copy important replies before sending — the input field clears immediately on send. If a network error occurs, your text is lost. Clipboard-copy long replies first.
  • Use the AI chat for response ideas — if you need help crafting a reply, open the AI chat assistant in a side panel and ask for a draft. Then paste the result into the inbox reply field.
  • Monitor connection health — if the inbox stops loading conversations, check the connections page for an expired Instagram token (amber status dot). Reconnect to restore access.

Troubleshooting

IssueWhat to do
”Permission required” errorReconnect your Instagram account and approve the instagram_manage_messages permission. See requirements above. This error does not show a retry button — you must reconnect through the connections page.
”Failed to load conversations” errorA network or server issue prevented loading. Click the Retry button to try again. If the issue persists, check the system status page.
No conversations appearConversations show up when someone messages your Instagram account. If you expect messages, tap the refresh button to load the latest data.
No Instagram accounts listedConnect an Instagram account from the connections page. The inbox only shows accounts that have been connected with Instagram messaging permissions.
Message failed to sendCheck your network connection and try again. Note that the message text is cleared immediately when you press send and is not preserved if sending fails — you will need to retype it. If sending keeps failing, verify your account token is still valid on the connections page.
Empty message bubblesThe other person sent an image, video, story reply, or other media type. The inbox currently displays text only — media messages appear as empty bubbles.
Only seeing recent conversationsThe inbox loads your 25 most recent conversations and 20 messages per thread. Older history is not currently available.
Conversations look outdated after switching accountsSwitching accounts reloads the conversation list, but data may be briefly cached. Click the refresh button to force a fresh fetch.
  • Comments — manage public Facebook and Instagram post comments with AI-assisted replies
  • Connections — manage Instagram account health and permissions
  • AI chat assistant — draft reply ideas in a side panel
  • Keyboard shortcuts — use Enter to send messages and Shift+Enter for new lines
Last modified on May 16, 2026