Skip to main content
Automation

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.

PlatformWhat you getNeeds
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 PagesComments on Page posts and replies as the Page.Permissions pages_read_user_content and pages_manage_engagement. Messenger DMs are not supported.
YouTubeComments 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.
BlueskyReplies, mentions and quotes; reply to them.Nothing extra (the app password works).
MastodonMentions and replies; reply to them.An access token with the read:notifications scope (plus write:statuses, which publishing already needs).
RedditReplies to your posts and comments, username mentions; reply to them.Scope privatemessages (reconnect). Reddit private messages only when direct messages are enabled.
ThreadsReplies 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 restNot 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

VariablePurpose
INBOX_ENABLEDMaster switch for polling and the inbox API (default true).
INBOX_POLL_INTERVAL_MINUTESHow 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_ENABLEDPoll X mentions (default false, because X charges for API reads).
INBOX_DMS_ENABLEDFetch direct messages where the platform allows (default false; needs extra permission / app review).
INBOX_REQUEST_SCOPESAdd 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} and POST /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_inbox and reply_inbox_item. The reply tool posts publicly and cannot be undone, so it only works with confirmed_by_user=true after you approved the exact text.

v0.1.2

Social inbox | Documentation | Sociquza