Synup
Schlüssel erstellen
v1Ressourcen/Review Invites/postCRM-Kontakte prüfen oder importieren

CRM-Kontakte prüfen oder importieren

Erfordert ReviewGen, Bewertungszugriff, einen unbeschränkten Agenturinhaber/Administrator und unbeschränkte Zugangsdaten. POST benötigt stets review-invite:write. op:preview liest aktuelle CRM-Kontakte ohne Speicherung; limit ist standardmäßig 500, erlaubt 1–5000. Optionales mapping gilt nur für die Vorschau und wird nicht gespeichert. op:import nutzt gespeicherte Regeln und das Limit des Hintergrundauftrags; mapping und limit werden abgelehnt. Importe können E-Mails/SMS senden und Credits verbrauchen: allowSend:true ist nach ausdrücklicher Versandfreigabe Pflicht. HTTP 202 liefert runId und status:queued, keine abgeschlossenen Ergebnisse. HTTP 503 mit data.status:queue_unknown und runId bedeutet unbestätigte Einreihung; diesen Lauf vor einem weiteren Import prüfen. Die Vorschau enthält keine rohen Anbieterobjekte oder internen Planungsdaten.

post/api/v1/review-invites/crm/{id}/import
review-invite:write
Query-Parameter
idstringerforderlich
Anfragetext
opstring (preview | import)optional
mappingobjectoptional
sourceFieldstringerforderlich
rulesarray of objecterforderlich
valuestringerforderlich
locationIdstringerforderlich
fallbackLocationIdstringerforderlich
limitintegeroptional
allowSendbooleanoptional
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.
409Der Datensatz wurde geändert, der Versand benötigt Zustimmung oder der Vorgang widerspricht dem aktuellen Zustand.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
503Der Einladungsvorgang konnte nicht abgeschlossen werden. Bei unbestätigter CRM-Einreihung bleibt runId erhalten; vor einem erneuten Versuch prüfen.
post/api/v1/review-invites/crm/{id}/import
Ihr API-Schlüssel
id *
Anfragetext
{}

Anleitungen, die diese Ressource verwenden