Synup
Schlüssel erstellen
v1Ressourcen/Social Inbox/postPosteingangsaktionen anwenden

Posteingangsaktionen anwenden

Erfordert einen aktiven Agenturnutzer mit Social-Zugriff und aktivierter Social Inbox. Nutzersichtbarkeit und Kundenbeschränkungen der Zugangsdaten werden kombiniert. Genau items (1–2000 Paare aus kind/id) oder ein strukturiertes filter-Objekt angeben, keine URL-Zeichenfolge. Aktionen: resolve, reopen, resolveThread, markRead, markUnread, save, unsave. Filter verwenden Arrays, gültige Datumsangaben und boolesche Werte; unbekannte Felder werden abgelehnt. Alle Elemente werden vor Änderungen autorisiert; resolveThread prüft auch erweiterte Elemente und das Limit von 2000. Liefert updated/skipped; Lesen/Ungelesen überspringt Direktnachrichten. Nur interner Zustand, kein Versand. Bei späterem Schreibfehler kann ein Teil bereits abgeschlossen sein.

post/api/v1/inbox/actions
inbox:write
Anfragetext
itemsarray of objectoptional
kindstring (comment | message | mention)erforderlich
idstringerforderlich
filterobjectoptional
clientIdstringoptional
locationsarray of stringoptional
fromstringoptional
tostringoptional
tzintegeroptional
platformarray of stringoptional
statusarray of string (open | resolved)optional
sentimentarray of string (positive | neutral | negative)optional
assigneestring (all | unassigned | me | team)optional
keywordstringoptional
sortstring (newest | oldest)optional
typesarray of stringoptional
sourcesarray of stringoptional
savedbooleanoptional
tagsarray of stringoptional
tagMatchstring (any | all)optional
untaggedbooleanoptional
languagearray of stringoptional
needsResponsestring (yes | no)optional
intentarray of string (question | complaint | praise | feedback | lead | other)optional
spamstring (exclude | only)optional
priorityarray of string (1 | 2 | 3 | 4 | none)optional
caseTypearray of string (general | support | question | feedback | lead)optional
poststringoptional
pulsestring (closing | reply | fresh)optional
actionstring (resolve | reopen | resolveThread | markRead | markUnread | save | unsave)erforderlich
Antwort
dataobjectoptional
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
409Die Änderung widerspricht dem aktuellen Datensatz.
413Mehr als 2000 Elemente entsprechen der Auswahl oder erweiterten Threads; Auswahl eingrenzen.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
503Der Posteingangsvorgang konnte nicht abgeschlossen werden.
post/api/v1/inbox/actions
Ihr API-Schlüssel
Anfragetext*
{}

Neu bei der Synup-API?