v1Ressourcen/Reviews/postAntworten zur Freigabe durch den Kunden senden
Antworten zur Freigabe durch den Kunden senden
Bittet Benutzer des Kundenportals, Antwortentwürfe freizugeben, eine Anfrage je Bewertung. Jedes Element enthält eine reviewId und den Antworttext; lassen Sie text weg, wird der gespeicherte Entwurf der Bewertung verwendet. Der Text wird außerdem als Entwurf der Bewertung gespeichert. Jede Person in clientUserIds muss ein aktiver Portalbenutzer des Kunden der Bewertung sein und den Standort der Bewertung sehen können. Zuerst laufen die Inhaltsprüfungen; eine von ihnen beanstandete Antwort wird nicht gesendet. Hat die Bewertung bereits eine offene Anfrage, wird diese aktualisiert: Neuer Text ist eine neue Version, zu der der Kunde erneut gefragt wird, und neue Personen werden hinzugefügt. Jede Bewertung gelingt oder scheitert für sich, daher antwortet der Aufruf auch dann mit 201, wenn einzelne Elemente fehlschlagen; prüfen Sie ok und code in jedem Ergebnis. Kundenbenutzer erhalten eine E-Mail und eine Benachrichtigung in der App, und kurz nacheinander gesendete Anfragen erreichen jede Person als eine Nachricht. Kann die E-Mail nicht gesendet werden, wartet die Anfrage trotzdem in ihrem Portal.
post
reviews:write/api/v1/reviews/reply-approvalsAnfragetext
itemsarray of objecterforderlich
Die zu sendenden Bewertungen, 1 bis 200. Jede Bewertung erhält eine eigene Anfrage.
reviewIdstringerforderlich
Die Bewertung, auf die die Antwort eingeht.
textstringoptional
Die freizugebende Antwort, höchstens 4096 Zeichen. Weglassen, um den gespeicherten Entwurf der Bewertung zu verwenden.
clientUserIdsarray of stringerforderlich
Die zu fragenden Benutzer des Kundenportals, 1 bis 50, aus der Liste der Portalbenutzer des Kunden. Jeder muss den Standort der Bewertung sehen können, sonst schlägt diese Bewertung mit ineligible_assignee fehl.
notestringoptional
Eine optionale Nachricht an die Kundenbenutzer, höchstens 2000 Zeichen.
Antwort
dataobjectoptional
resultsarray of objectoptional
Ein Ergebnis je Element. Nicht gefundene Bewertungen oder solche eines Kunden, auf den das Token keinen Zugriff hat, stehen am Ende.
reviewIdstringoptional
Die Bewertung, zu der dieses Ergebnis gehört.
okbooleanoptional
true, wenn die Anfrage erstellt oder aktualisiert wurde.
requestIdstringoptional
Die ID der Anfrage, wenn ok true ist.
errorstringoptional
Warum diese Bewertung nicht gesendet wurde, wenn ok false ist.
codestring (not_found | not_respondable | no_draft | ineligible_assignee | content_checks)optional
Der Grund für den Fehler: not_found (keine solche Bewertung, oder sie gehört zu einem Kunden, auf den das Token keinen Zugriff hat), not_respondable (auf die Bewertung kann in Synup nicht geantwortet werden, oder sie hat bereits eine veröffentlichte Antwort), no_draft (kein text gesendet und kein gespeicherter Entwurf vorhanden), ineligible_assignee (jemand in clientUserIds kann den Standort der Bewertung nicht sehen) oder content_checks (die Inhaltsprüfungen haben die Antwort beanstandet; korrigieren und erneut senden).
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/reviews/reply-approvals
Ihr API-Schlüssel
Anfragetext*
{}Anleitungen, die diese Ressource verwenden
- Google Business Profile API vs a Listings Management APIHow Google's Business Profile API compares with a listings management API on scope, access, sync status, duplicates and reviews, and when to use each.
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Build an AI Agent for Local SEOBuild an AI agent that audits and fixes listings, tracks local rankings, checks AI visibility and drafts review replies with Synup's MCP server or REST tools.
- How to Build an AI Agent That Responds to ReviewsBuild an AI agent that drafts and posts review replies, with rating-based guardrails, human approval for negatives, and protection against injection.
- How to Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.
- How to Fetch and Respond to Reviews via APIFetch reviews from Google, Facebook and custom review sites, filter them, post owner replies, add internal notes and read review analytics with the Synup API.
- How to Build Automated Review-Response WorkflowsBuild a review-response workflow that routes reviews by rating and sentiment, drafts replies, approves them, and pushes them back to the platform.
- Fetch Recent Reviews via APIPull a location's reviews from every connected platform with the Synup API, filter to what needs attention, and page through with a cursor.
- Local SEO APIs: What Developers Actually NeedA practical checklist of what a local SEO API must cover, from listings and sync status to reviews, rank tracking and AI visibility, mapped to endpoints.
- How to Retrieve Google Business Profile Analytics via APIPull Google Business Profile analytics through an API, portfolio-wide and per location, with views, calls, direction requests and a maps-versus-search split.
- Respond to a Review via APIPost an owner reply to a review with the Synup API, read the push status back, and know which failures are worth a retry.