v1Recursos/Social Inbox/postAplicar acciones de bandeja
Aplicar acciones de bandeja
Requiere usuario activo de la agencia con acceso a Social y Social Inbox habilitado. Combina la visibilidad del usuario y las restricciones de clientes de la credencial. Indicar exactamente items (1–2000 pares kind/id) o un objeto filter estructurado, nunca una cadena URL. Acciones: resolve, reopen, resolveThread, markRead, markUnread, save, unsave. Los filtros usan matrices, fechas válidas y booleanos; se rechazan campos desconocidos. Autoriza todos los elementos antes de escribir; resolveThread también comprueba los elementos ampliados y el límite de 2000. Devuelve updated/skipped; leído/no leído omite mensajes directos. Cambia solo estado interno, sin enviar mensajes. Puede haber cambios parciales si falla una escritura posterior.
post
inbox:write/api/v1/inbox/actionsCuerpo de la solicitud
itemsarray of objectopcional
kindstring (comment | message | mention)obligatorio
idstringobligatorio
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)obligatorio
Respuesta
dataobjectopcional
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
409El cambio entra en conflicto con el registro actual.
413Más de 2000 elementos coinciden o pertenecen a hilos ampliados; reduzca la selección.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
503No se pudo completar la operación de bandeja.
post/api/v1/inbox/actions
Su clave de API
Cuerpo de la solicitud*
{}