v1Ressources/Social Inbox/postAppliquer des actions de boîte
Appliquer des actions de boîte
Nécessite un utilisateur actif de l’agence avec accès Social et Social Inbox activé. Combine la visibilité utilisateur et les restrictions client des identifiants. Fournir exactement items (1–2000 paires kind/id) ou un objet filter structuré, jamais une chaîne URL. Actions : resolve, reopen, resolveThread, markRead, markUnread, save, unsave. Filtres avec tableaux, dates valides et booléens ; champs inconnus refusés. Tous les éléments sont autorisés avant écriture ; resolveThread contrôle aussi les éléments étendus et la limite de 2000. Renvoie updated/skipped ; lu/non lu ignore les messages privés. État interne uniquement, aucun envoi. Des modifications partielles sont possibles si une écriture ultérieure échoue.
post
inbox:write/api/v1/inbox/actionsCorps de la requête
itemsarray of objectfacultatif
kindstring (comment | message | mention)obligatoire
idstringobligatoire
filterobjectfacultatif
clientIdstringfacultatif
locationsarray of stringfacultatif
fromstringfacultatif
tostringfacultatif
tzintegerfacultatif
platformarray of stringfacultatif
statusarray of string (open | resolved)facultatif
sentimentarray of string (positive | neutral | negative)facultatif
assigneestring (all | unassigned | me | team)facultatif
keywordstringfacultatif
sortstring (newest | oldest)facultatif
typesarray of stringfacultatif
sourcesarray of stringfacultatif
savedbooleanfacultatif
tagsarray of stringfacultatif
tagMatchstring (any | all)facultatif
untaggedbooleanfacultatif
languagearray of stringfacultatif
needsResponsestring (yes | no)facultatif
intentarray of string (question | complaint | praise | feedback | lead | other)facultatif
spamstring (exclude | only)facultatif
priorityarray of string (1 | 2 | 3 | 4 | none)facultatif
caseTypearray of string (general | support | question | feedback | lead)facultatif
poststringfacultatif
pulsestring (closing | reply | fresh)facultatif
actionstring (resolve | reopen | resolveThread | markRead | markUnread | save | unsave)obligatoire
Réponse
dataobjectfacultatif
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409La modification contredit l’enregistrement actuel.
413Plus de 2000 éléments correspondent ou appartiennent aux fils étendus ; réduire la sélection.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
503L’opération de boîte n’a pas pu aboutir.
post/api/v1/inbox/actions
Votre clé API
Corps de la requête*
{}