MB SuiteMB Suite
Menu

Referência da API · Inbox

Análises

social_inbox · analytics · 1 operação

GET/v1/social-inbox/performance
GET/v1/social-inbox/performance

Get the Social Inbox team performance

social_inbox.analytics.performance

LeituraIdempotenteDesde 2026-11-01

Returns the inbox performance between start_date and end_date (YYYY-MM-DD, UTC days, up to 366): items received, replied and resolved, items moved to Spam by hand (spam_marked; what the inbox sends to Spam by itself when a message arrives does not count), the average first response time of people (ms; automatic replies do not count), the same per platform, replies and resolutions per agent (people and AI Community Managers, ai-<position_id>) and a daily series (spam_marked per day too). Built from daily aggregates: it does not read the items. Requires view access to the Social Inbox. With LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their fields are left out of the response (the permissions guide lists what each platform allows).

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

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

Parâmetros

start_datestringqueryobrigatório

First day, YYYY-MM-DD (UTC days, as the daily aggregates are stored).

end_datestringqueryobrigatório

Last day, YYYY-MM-DD (inclusive; up to 366 days from start_date).

Resposta

range_startstring

First day of the range (YYYY-MM-DD, UTC).

range_endstring

Last day of the range (YYYY-MM-DD, UTC).

receivednumber

Items received.

repliednumber

Items replied.

resolvednumber

Items resolved.

spam_markednumber

Items someone moved to Spam in the range, by hand in the inbox or with social_inbox.items.mark_spam (marking a whole conversation counts each of its items), counted on the UTC day they were marked. What the inbox sends to Spam by itself when a message arrives (the AI analyst or a rule) does not count, and taking an item out of Spam does not subtract.

avg_first_response_msnumber | null

Average time to the first reply by a person (ms); null without replies in the range.

received_by_platformobject

Received per network (facebook, instagram, linkedin, tiktok).

replied_by_platformobject

Replied per network.

avg_first_response_by_platformobject

Average first reply per network (ms).

agentsarray<object>

Replies and resolutions per agent.

dailyarray<object>

One row per day of the range.

Erros

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Exemplo

curl "https://api.mb-suite.com/v1/social-inbox/performance?start_date=START_DATE&end_date=END_DATE" \
  -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/performance?start_date=START_DATE&end_date=END_DATE" \
  -H "Authorization: Bearer $MB_TEST_KEY"