API · Webhooks
Une API REST pour lire vos avis, y répondre, envoyer des demandes d'avis et publier sur vos fiches Google. Des webhooks signés pour être prévenu à chaque nouvel avis, chaque réponse et chaque changement d'établissement.
Une clé suffit pour appeler l'API. Une URL suffit pour recevoir les événements.
Récupérez vos établissements et leurs avis, du plus récent au plus ancien, avec note, texte, auteur et réponse.
Envoyez une réponse à un avis : elle est publiée sur Google, ou envoyée par e-mail à l'auteur d'un avis collecté par Reputacion.
Votre caisse, votre CRM ou votre site transmet la liste des clients ; Reputacion leur envoie la demande d'avis par e-mail, après le délai choisi.
Un post avec image et bouton d'action sur 500 fiches au plus, en un appel, maintenant ou à une date programmée. Ajoutez aussi des photos à vos fiches.
Les webhooks envoient un événement à votre URL à chaque avis créé ou modifié, à chaque réponse et à chaque changement d'établissement.
Chaque webhook est signé en HMAC-SHA256. En cas d'échec, il est retenté jusqu'à quatre fois sur un peu plus d'une journée.
Un administrateur génère la clé depuis les paramètres. Elle donne accès à tous les établissements de l'organisation, et Reputacion n'en conserve qu'une empreinte chiffrée. Générer une nouvelle clé désactive immédiatement l'ancienne : c'est aussi la marche à suivre si une clé a fuité. Les paramètres affichent le nombre d'appels et la date de dernière utilisation.
Deux lectures : la liste de vos établissements, et les avis d'un établissement, du plus récent au plus ancien, par pages de 100 au plus. Quatre écritures : répondre à un avis, envoyer des demandes d'avis par e-mail à partir d'un de vos modèles, publier un post Google sur 1 à 500 fiches, ajouter jusqu'à 10 photos à une fiche. Le septième point d'accès donne le statut d'une publication, fiche par fiche. La documentation complète se trouve dans le centre d'aide de votre espace.
Une URL HTTPS par organisation reçoit huit événements : création, modification et suppression d'un établissement ; création et modification d'un avis ; création, modification et suppression d'une réponse. Chaque envoi contient un identifiant, le type, la date et les données, et porte l'en-tête X-Reputacion-Signature, une signature HMAC-SHA256 du corps calculée avec votre secret. Les événements partent dans la minute, et toute réponse 2xx vaut réception. Sinon, l'envoi est retenté après 5 minutes, 30 minutes, 3 heures puis 23 heures.
La clé API et les webhooks sont gérés par les administrateurs de l'organisation.
Dans Paramètres, Développeur, API, un administrateur génère la clé de l'organisation. Copiez-la et conservez-la en lieu sûr.
Passez la clé dans l'en-tête X-API-Key de chaque requête. Les réponses sont en JSON, et les listes sont paginées.
Dans Développeur, Webhooks, saisissez votre URL en HTTPS et activez l'envoi. Vérifiez chaque signature avec votre secret.
Oui, dans toutes les formules, essai gratuit compris, sans quota d'appels propre à l'API. Répondre aux avis, publier des posts et ajouter des photos demande un abonnement actif.
Seuls les administrateurs de l'organisation. La clé donne accès à tous les établissements de l'organisation.
Ajoutez votre clé dans l'en-tête X-API-Key de chaque requête. Une clé absente ou invalide renvoie une erreur 401.
Non, une seule clé est active par organisation. En générer une nouvelle désactive la précédente.
Pas encore. L'API publie sur les fiches Google uniquement. La publication sur Facebook et Instagram se fait depuis l'application.
La création, la modification et la suppression d'un établissement ; la création et la modification d'un avis ; la création, la modification et la suppression d'une réponse. Tous les événements partent vers votre URL : filtrez-les sur leur type.
Recalculez la signature HMAC-SHA256 du corps brut avec votre secret, et comparez-la à l'en-tête X-Reputacion-Signature. L'en-tête X-Reputacion-Delivery identifie l'envoi et reste le même d'une tentative à l'autre.
L'envoi est retenté quatre fois : après 5 minutes, 30 minutes, 3 heures puis 23 heures. Au-delà, il est marqué en échec dans le journal des livraisons, et votre webhook reste actif pour les événements suivants.
Ils partent dans la minute qui suit l'événement. Un nouvel avis Google déclenche son événement dès que la synchronisation de vos fiches le détecte.
Pas de connecteur prêt à l'emploi. Un outil capable d'appeler une API peut en revanche déclencher une demande d'avis après un achat, ou recevoir nos webhooks.
Dans le centre d'aide de votre espace Reputacion, page API & Webhooks : points d'accès, champs, format des événements et vérification de la signature.
