MB SuiteMB Suite
Menu

Referência da API · Inbox

Configurações

social_inbox · config · 2 operações

GET/v1/social-inbox/configPATCH/v1/social-inbox/config
GET/v1/social-inbox/config

Get the Social Inbox configuration

social_inbox.config.get

LeituraIdempotenteDesde 2026-11-01

Returns the inbox configuration of the organization: sync_enabled (whether messages are being ingested; it is turned on from the screen) and enabled_at (since when), enabled_sources (source → false means that source is not ingested; absent means enabled), inbox_agent_uids (who can be assigned, what config.update calls agent_uids; absent means every member) with inbox_agents (those members with their names) and updated_at (0 when the configuration was never saved). Requires view access to the Social Inbox.

Escopo
social_inbox:read
Permissão
Ver o módulo
Tool do MCP
social_inbox_config_getNa superfície completa; na compacta, mb_execute_operation com id: "social_inbox.config.get".

Custo declarado: até 23 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

Sem parâmetros.

Resposta

sync_enabledboolean

Whether the inbox is on (it brings new comments and messages from the connected networks).

updated_atnumber

Last change (epoch ms); 0 = the configuration was never saved.

enabled_atnumber | null

When the inbox was turned on (epoch ms).

enabled_sourcesobject | null

Source → false = not brought in (ig_comment, tt_message…). Absent or missing key = brought in.

inbox_agent_uidsarray<string> | null

The members offered in the Assign menu (what config.update calls agent_uids). Absent = every member.

inbox_agentsarray<object>

Those members with their names (only the ones still in the organization).

Erros

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Exemplo

curl "https://api.mb-suite.com/v1/social-inbox/config" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl "https://api.mb-suite.com/v1/social-inbox/config" \
  -H "Authorization: Bearer $MB_TEST_KEY"
PATCH/v1/social-inbox/config

Update the Social Inbox sources and team

social_inbox.config.update

EscritaIdempotenteDesde 2026-11-01

Updates what the inbox ingests and who can be assigned. enabled_sources replaces the source map (source → false stops ingesting it from now on; existing items stay; sources: ig_comment, ig_message, ig_mention, fb_comment, fb_message, fb_mention, li_comment, li_message, li_mention, tt_comment, tt_message; unknown ones are dropped). agent_uids replaces the assignable team (members of the organization or its agency; others are dropped; an empty list means everyone). Send one or both. Returns the configuration and what was dropped (dropped.sources, dropped.agent_uids). Owner or admin only.

Escopo
social_inbox:write
Permissão
Editar no módulo · Só owner, admin
Tool do MCP
social_inbox_config_updateNa superfície completa; na compacta, mb_execute_operation com id: "social_inbox.config.update".

Custo declarado: até 25 leituras e 1 escritas por chamada (contam na cota diária).

Parâmetros

enabled_sourcesobjectcorpoopcional

Source → false stops bringing it in (ig_comment, ig_message, ig_mention, fb_comment, fb_message, fb_mention, li_comment, li_mention, tt_comment, tt_message); a missing key = brought in. Replaces the whole map; unknown sources are dropped (dropped.sources in the reply).

agent_uidsarray<string>corpoopcional

The members offered in the Assign menu (user ids from members.members.list); [] = every member. Replaces the list; non-members are dropped (dropped.agent_uids in the reply).

Resposta

sync_enabledboolean

Whether the inbox is on (it brings new comments and messages from the connected networks).

updated_atnumber

Last change (epoch ms); 0 = the configuration was never saved.

droppedobject

What the call sent and was not saved.

enabled_atnumber | null

When the inbox was turned on (epoch ms).

enabled_sourcesobject | null

Source → false = not brought in (ig_comment, tt_message…). Absent or missing key = brought in.

inbox_agent_uidsarray<string> | null

The members offered in the Assign menu (what config.update calls agent_uids). Absent = every member.

inbox_agentsarray<object>

Those members with their names (only the ones still in the organization).

Erros

role_requiredinvalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Exemplo

curl -X PATCH "https://api.mb-suite.com/v1/social-inbox/config" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl -X PATCH "https://api.mb-suite.com/v1/social-inbox/config" \
  -H "Authorization: Bearer $MB_TEST_KEY"