Social inbox
Read and answer comments, mentions and replies from your connected accounts in one place.
How the inbox works
Open Inbox in the sidebar. Sociquza checks every connected account that supports it about every 5 minutes in the background (checking never delays publishing), stores new comments, mentions and replies, and shows an unread count next to Inbox. The page refreshes itself about once a minute; Check now asks the platforms immediately.
Select a message to read the whole conversation, then reply from the box under it. A reply is posted publicly as the connected account (direct messages are sent privately). You can insert a saved reply, ask Suggest reply for an AI draft when the server has an AI provider (you always read and edit it before sending), assign the message to a teammate, archive it or mark it unread. All times are shown in IST.
The first check of an account stores the last 30 days as already read, so connecting an account does not flood you with notifications. Replying needs the Create content permission; other roles can read the inbox. Every reply is recorded in the workspace activity feed.
What each platform supports
Only official, documented APIs are used. A platform that offers no way to read comments or messages for third-party apps is publish-only here and shows nothing in the inbox.
| Platform | What you get | Needs |
|---|---|---|
| Instagram (Instagram Login) | Comments on your posts and replies to them. | Permission instagram_business_manage_comments. Accounts connected before the inbox existed must reconnect. |
| Instagram (with music, Facebook Login) | Comments and replies. | Permission instagram_manage_comments (+ pages_read_engagement). |
| Facebook Pages | Comments on Page posts and replies as the Page. | Permissions pages_read_user_content and pages_manage_engagement. Messenger DMs are not supported. |
| YouTube | Comments on your channel and replies to them. | Scope youtube.force-ssl, which the publishing connection does not include: reconnect. A reply costs 50 YouTube API quota units (reading costs 1). |
| X (Twitter) | Mentions and replies; reply to them. | The server operator has to enable it: X bills API reads (credits). Your connection already has the scopes. |
| Bluesky | Replies, mentions and quotes; reply to them. | Nothing extra (the app password works). |
| Mastodon | Mentions and replies; reply to them. | An access token with the read:notifications scope (plus write:statuses, which publishing already needs). |
| Replies to your posts and comments, username mentions; reply to them. | Scope privatemessages (reconnect). Reddit private messages only when direct messages are enabled. | |
| Threads | Replies to your threads; reply to them. | Permissions threads_read_replies and threads_manage_replies (reconnect). Mentions are not available. |
| LinkedIn, TikTok, Pinterest, Tumblr, Telegram and the rest | Not supported (publish-only). | These platforms offer no official inbox API for apps like Sociquza. |
Reconnect to enable inbox
Accounts connected earlier only hold the permissions needed to publish. When an account lacks the inbox permission it shows Reconnect to enable inbox instead of failing: open Accounts, choose Reconnect and approve the extra permissions. Self-hosted servers must also set INBOX_REQUEST_SCOPES=true and have the Meta, Google, Threads and Reddit apps allowed to request those permissions (some need the platform's app review).
Server settings
| Variable | Purpose |
|---|---|
| INBOX_ENABLED | Master switch for polling and the inbox API (default true). |
| INBOX_POLL_INTERVAL_MINUTES | How often each account is checked (default 5; X is checked three times less often). Failures back off up to an hour, and a rate-limit answer waits at least 15 minutes. |
| INBOX_X_ENABLED | Poll X mentions (default false, because X charges for API reads). |
| INBOX_DMS_ENABLED | Fetch direct messages where the platform allows (default false; needs extra permission / app review). |
| INBOX_REQUEST_SCOPES | Add the inbox permissions to new account connections (default false). |
API and MCP
GET /api/inbox/items(filters: application_id, status, platform, account_id, kind, assigned=me|unassigned|user id, q; limit and cursor),GET /api/inbox/items/:id(thread and reply log),PATCH /api/inbox/items/:id(status new|read|archived, assigned_to),POST /api/inbox/mark-read,GET /api/inbox/unread-count.POST /api/inbox/items/:id/reply {text}andPOST /api/inbox/items/:id/suggest-reply;GET /api/inbox/accounts;POST /api/inbox/sync {account_id};/api/inbox/saved-replies(list, create, patch, delete).- MCP tools:
list_inboxandreply_inbox_item. The reply tool posts publicly and cannot be undone, so it only works withconfirmed_by_user=trueafter you approved the exact text.