v1Recursos/Social Inbox/postAplicar ações da caixa
Aplicar ações da caixa
Requer usuário ativo da agência com acesso a Social e Social Inbox habilitado. Combina visibilidade do usuário e restrições de clientes da credencial. Informe exatamente items (1–2000 pares kind/id) ou objeto filter estruturado, nunca uma string de URL. Ações: resolve, reopen, resolveThread, markRead, markUnread, save, unsave. Filtros usam listas, datas válidas e booleanos; campos desconhecidos são recusados. Todos os itens são autorizados antes da gravação; resolveThread também verifica itens expandidos e o limite de 2000. Retorna updated/skipped; lido/não lido ignora mensagens diretas. Apenas estado interno, sem enviar mensagens. Pode haver conclusão parcial se uma gravação posterior falhar.
post
inbox:write/api/v1/inbox/actionsCorpo da solicitação
itemsarray of objectopcional
kindstring (comment | message | mention)obrigatório
idstringobrigatório
filterobjectopcional
clientIdstringopcional
locationsarray of stringopcional
fromstringopcional
tostringopcional
tzintegeropcional
platformarray of stringopcional
statusarray of string (open | resolved)opcional
sentimentarray of string (positive | neutral | negative)opcional
assigneestring (all | unassigned | me | team)opcional
keywordstringopcional
sortstring (newest | oldest)opcional
typesarray of stringopcional
sourcesarray of stringopcional
savedbooleanopcional
tagsarray of stringopcional
tagMatchstring (any | all)opcional
untaggedbooleanopcional
languagearray of stringopcional
needsResponsestring (yes | no)opcional
intentarray of string (question | complaint | praise | feedback | lead | other)opcional
spamstring (exclude | only)opcional
priorityarray of string (1 | 2 | 3 | 4 | none)opcional
caseTypearray of string (general | support | question | feedback | lead)opcional
poststringopcional
pulsestring (closing | reply | fresh)opcional
actionstring (resolve | reopen | resolveThread | markRead | markUnread | save | unsave)obrigatório
Resposta
dataobjectopcional
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
409A alteração conflita com o registro atual.
413Mais de 2000 itens correspondem ou pertencem a conversas expandidas; restrinja a seleção.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
503Não foi possível concluir a operação da caixa.
post/api/v1/inbox/actions
Sua chave de API
Corpo da solicitação*
{}