API · Webhooks
Eine REST-API, um Bewertungen abzurufen, zu beantworten, Bewertungsanfragen zu senden und auf Ihren Google-Profilen zu posten. Signierte Webhooks informieren Sie über jede neue Bewertung, jede Antwort und jede Änderung an einem Standort.
Ein Schlüssel genügt, um die API aufzurufen. Eine URL genügt, um Ereignisse zu empfangen.
Rufen Sie Ihre Standorte und deren Bewertungen ab, die neuesten zuerst, mit Sternen, Text, Autor und Antwort.
Senden Sie eine Antwort auf eine Bewertung: Sie wird auf Google veröffentlicht oder bei einer über Reputacion gesammelten Bewertung per E-Mail an den Autor geschickt.
Kasse, CRM oder Website übermitteln die Kundenliste; Reputacion verschickt die Bewertungsanfrage nach der gewählten Wartezeit per E-Mail.
Ein Beitrag mit Bild und Aktionsbutton auf bis zu 500 Profilen mit einem Aufruf, sofort oder zu einem geplanten Termin. Fügen Sie Ihren Profilen auch Fotos hinzu.
Webhooks senden bei jeder neuen oder geänderten Bewertung, jeder Antwort und jeder Standortänderung ein Ereignis an Ihre URL.
Jeder Webhook ist mit HMAC-SHA256 signiert. Schlägt die Zustellung fehl, wird sie bis zu viermal über gut einen Tag wiederholt.
Ein Administrator generiert den Schlüssel in den Einstellungen. Er gewährt Zugriff auf alle Standorte der Organisation, und Reputacion speichert davon nur einen verschlüsselten Fingerabdruck. Ein neuer Schlüssel deaktiviert den alten sofort: Das ist auch der Weg, wenn ein Schlüssel nach außen gelangt ist. Die Einstellungen zeigen die Zahl der Aufrufe und das Datum der letzten Nutzung.
Zwei Lesezugriffe: die Liste Ihrer Standorte und die Bewertungen eines Standorts, die neuesten zuerst, in Seiten von höchstens 100. Vier Schreibzugriffe: auf eine Bewertung antworten, Bewertungsanfragen per E-Mail auf Basis einer Ihrer Vorlagen senden, einen Google-Beitrag auf 1 bis 500 Profilen veröffentlichen, bis zu 10 Fotos zu einem Profil hinzufügen. Der siebte Endpunkt liefert den Status einer Veröffentlichung, Profil für Profil. Die vollständige Dokumentation finden Sie im Hilfecenter Ihres Kontos.
Eine HTTPS-URL pro Organisation empfängt acht Ereignisse: Standort erstellt, geändert und gelöscht; Bewertung erstellt und geändert; Antwort erstellt, geändert und gelöscht. Jede Zustellung enthält eine ID, den Typ, das Datum und die Daten und trägt den Header X-Reputacion-Signature, eine mit Ihrem Secret berechnete HMAC-SHA256-Signatur des Bodys. Ereignisse gehen innerhalb einer Minute raus, und jede 2xx-Antwort gilt als Empfang. Andernfalls wird die Zustellung nach 5 Minuten, 30 Minuten, 3 Stunden und dann 23 Stunden wiederholt.
API-Schlüssel und Webhooks werden von den Administratoren der Organisation verwaltet.
Unter Einstellungen, Entwickler, API generiert ein Administrator den Schlüssel der Organisation. Kopieren Sie ihn und bewahren Sie ihn sicher auf.
Übergeben Sie den Schlüssel im Header X-API-Key jeder Anfrage. Antworten kommen als JSON, Listen sind paginiert.
Unter Entwickler, Webhooks geben Sie Ihre HTTPS-URL ein und aktivieren den Versand. Prüfen Sie jede Signatur mit Ihrem Secret.
Ja, in allen Tarifen, auch in der kostenlosen Testphase, ohne eigenes Aufrufkontingent für die API. Antworten auf Bewertungen, Beiträge und Fotos setzen ein aktives Abo voraus.
Nur die Administratoren der Organisation. Der Schlüssel gewährt Zugriff auf alle Standorte der Organisation.
Fügen Sie Ihren Schlüssel im Header X-API-Key jeder Anfrage hinzu. Ein fehlender oder ungültiger Schlüssel liefert den Fehler 401.
Nein, pro Organisation ist nur ein Schlüssel aktiv. Ein neuer Schlüssel deaktiviert den vorherigen.
Noch nicht. Die API veröffentlicht nur auf Google-Profilen. Beiträge auf Facebook und Instagram erstellen Sie in der App.
Standort erstellt, geändert und gelöscht; Bewertung erstellt und geändert; Antwort erstellt, geändert und gelöscht. Alle Ereignisse gehen an Ihre URL: Filtern Sie sie nach Typ.
Berechnen Sie die HMAC-SHA256-Signatur des unveränderten Bodys mit Ihrem Secret und vergleichen Sie sie mit dem Header X-Reputacion-Signature. Der Header X-Reputacion-Delivery kennzeichnet die Zustellung und bleibt über alle Versuche gleich.
Die Zustellung wird viermal wiederholt: nach 5 Minuten, 30 Minuten, 3 Stunden und dann 23 Stunden. Danach wird sie im Zustellprotokoll als fehlgeschlagen markiert, und Ihr Webhook bleibt für folgende Ereignisse aktiv.
Sie gehen innerhalb einer Minute nach dem Ereignis raus. Eine neue Google-Bewertung löst ihr Ereignis aus, sobald die Synchronisierung Ihrer Profile sie erfasst.
Einen fertigen Connector gibt es nicht. Jedes Tool, das eine API aufrufen kann, kann aber nach einem Kauf eine Bewertungsanfrage auslösen oder unsere Webhooks empfangen.
Im Hilfecenter Ihres Reputacion-Kontos auf der Seite API & Webhooks: Endpunkte, Felder, Ereignisformat und Signaturprüfung.
