API · Webhook
Un'API REST per leggere le recensioni, rispondere, inviare richieste di recensione e pubblicare sulle schede Google. Webhook firmati per essere avvisati a ogni nuova recensione, ogni risposta e ogni modifica di una sede.
Basta una chiave per chiamare l'API. Basta un URL per ricevere gli eventi.
Recuperate le vostre sedi e le loro recensioni, dalla più recente alla meno recente, con voto, testo, autore e risposta.
Inviate una risposta a una recensione: viene pubblicata su Google, o inviata via e-mail all'autore di una recensione raccolta da Reputacion.
La cassa, il CRM o il sito trasmette l'elenco dei clienti; Reputacion invia loro la richiesta di recensione via e-mail dopo il ritardo scelto.
Un post con immagine e pulsante di azione su un massimo di 500 schede con una sola chiamata, subito o a una data programmata. Aggiungete anche foto alle schede.
I webhook inviano un evento al vostro URL a ogni recensione creata o modificata, ogni risposta e ogni modifica di una sede.
Ogni webhook è firmato con HMAC-SHA256. In caso di errore viene ritentato fino a quattro volte nell'arco di poco più di un giorno.
Un amministratore genera la chiave dalle impostazioni. Dà accesso a tutte le sedi dell'organizzazione, e Reputacion ne conserva solo un'impronta cifrata. Generare una nuova chiave disattiva subito la precedente: è anche ciò che va fatto se una chiave è stata divulgata. Le impostazioni mostrano il numero di chiamate e la data dell'ultimo utilizzo.
Due letture: l'elenco delle vostre sedi e le recensioni di una sede, dalla più recente alla meno recente, in pagine di massimo 100. Quattro scritture: rispondere a una recensione, inviare richieste di recensione via e-mail a partire da uno dei vostri modelli, pubblicare un post Google su 1-500 schede, aggiungere fino a 10 foto a una scheda. Il settimo endpoint restituisce lo stato di una pubblicazione, scheda per scheda. La documentazione completa si trova nel centro assistenza del vostro account.
Un URL HTTPS per organizzazione riceve otto eventi: creazione, modifica ed eliminazione di una sede; creazione e modifica di una recensione; creazione, modifica ed eliminazione di una risposta. Ogni invio contiene un identificativo, il tipo, la data e i dati, e porta l'intestazione X-Reputacion-Signature, una firma HMAC-SHA256 del corpo calcolata con il vostro segreto. Gli eventi partono entro un minuto e qualsiasi risposta 2xx vale come ricevuta. Altrimenti l'invio viene ritentato dopo 5 minuti, 30 minuti, 3 ore e poi 23 ore.
La chiave API e i webhook sono gestiti dagli amministratori dell'organizzazione.
In Impostazioni, Sviluppatore, API, un amministratore genera la chiave dell'organizzazione. Copiatela e conservatela in un luogo sicuro.
Passate la chiave nell'intestazione X-API-Key di ogni richiesta. Le risposte sono in JSON e gli elenchi sono paginati.
In Sviluppatore, Webhook, inserite il vostro URL HTTPS e attivate l'invio. Verificate ogni firma con il vostro segreto.
Sì, in tutti i piani, prova gratuita compresa, senza una quota di chiamate specifica per l'API. Rispondere alle recensioni, pubblicare post e aggiungere foto richiede un abbonamento attivo.
Solo gli amministratori dell'organizzazione. La chiave dà accesso a tutte le sedi dell'organizzazione.
Aggiungete la chiave nell'intestazione X-API-Key di ogni richiesta. Una chiave mancante o non valida restituisce un errore 401.
No, è attiva una sola chiave per organizzazione. Generarne una nuova disattiva la precedente.
Non ancora. L'API pubblica solo sulle schede Google. La pubblicazione su Facebook e Instagram si fa dall'applicazione.
Creazione, modifica ed eliminazione di una sede; creazione e modifica di una recensione; creazione, modifica ed eliminazione di una risposta. Tutti gli eventi arrivano al vostro URL: filtrateli per tipo.
Ricalcolate la firma HMAC-SHA256 del corpo grezzo con il vostro segreto e confrontatela con l'intestazione X-Reputacion-Signature. L'intestazione X-Reputacion-Delivery identifica l'invio e resta invariata tra un tentativo e l'altro.
L'invio viene ritentato quattro volte: dopo 5 minuti, 30 minuti, 3 ore e poi 23 ore. Dopodiché è segnato come non riuscito nel registro delle consegne, e il webhook resta attivo per gli eventi successivi.
Partono entro il minuto successivo all'evento. Una nuova recensione Google genera il suo evento non appena la sincronizzazione delle schede la rileva.
Non c'è un connettore pronto all'uso. Qualsiasi strumento in grado di chiamare un'API può però avviare una richiesta di recensione dopo un acquisto, o ricevere i nostri webhook.
Nel centro assistenza del vostro account Reputacion, pagina API & Webhooks: endpoint, campi, formato degli eventi e verifica della firma.
