API · Webhooks
Una API REST para leer sus reseñas, responderlas, enviar solicitudes de reseña y publicar en sus fichas de Google. Webhooks firmados para enterarse de cada nueva reseña, cada respuesta y cada cambio de establecimiento.
Basta una clave para llamar a la API. Basta una URL para recibir los eventos.
Obtenga sus establecimientos y sus reseñas, de la más reciente a la más antigua, con nota, texto, autor y respuesta.
Envíe una respuesta a una reseña: se publica en Google, o se envía por correo al autor de una reseña recopilada por Reputacion.
Su caja, su CRM o su web envía la lista de clientes; Reputacion les manda la solicitud de reseña por correo tras el plazo elegido.
Un post con imagen y botón de acción en hasta 500 fichas con una sola llamada, ahora o en una fecha programada. Añada también fotos a sus fichas.
Los webhooks envían un evento a su URL con cada reseña creada o modificada, cada respuesta y cada cambio de establecimiento.
Cada webhook se firma con HMAC-SHA256. Si falla, se reintenta hasta cuatro veces durante algo más de un día.
Un administrador genera la clave desde los ajustes. Da acceso a todos los establecimientos de la organización, y Reputacion solo conserva una huella cifrada. Generar una clave nueva desactiva de inmediato la anterior: es también lo que debe hacer si una clave se ha filtrado. Los ajustes muestran el número de llamadas y la fecha del último uso.
Dos lecturas: la lista de sus establecimientos y las reseñas de un establecimiento, de la más reciente a la más antigua, en páginas de hasta 100. Cuatro escrituras: responder a una reseña, enviar solicitudes de reseña por correo a partir de una de sus plantillas, publicar un post de Google en 1 a 500 fichas y añadir hasta 10 fotos a una ficha. El séptimo endpoint devuelve el estado de una publicación, ficha por ficha. La documentación completa está en el centro de ayuda de su cuenta.
Una URL HTTPS por organización recibe ocho eventos: creación, modificación y eliminación de un establecimiento; creación y modificación de una reseña; creación, modificación y eliminación de una respuesta. Cada envío contiene un identificador, el tipo, la fecha y los datos, y lleva la cabecera X-Reputacion-Signature, una firma HMAC-SHA256 del cuerpo calculada con su secreto. Los eventos salen en menos de un minuto y cualquier respuesta 2xx cuenta como recibida. Si no, el envío se reintenta a los 5 minutos, 30 minutos, 3 horas y luego 23 horas.
La clave API y los webhooks los gestionan los administradores de la organización.
En Ajustes, Desarrollador, API, un administrador genera la clave de la organización. Cópiela y guárdela en un lugar seguro.
Incluya la clave en la cabecera X-API-Key de cada petición. Las respuestas están en JSON y las listas van paginadas.
En Desarrollador, Webhooks, introduzca su URL en HTTPS y active el envío. Verifique cada firma con su secreto.
Sí, en todos los planes, prueba gratuita incluida, sin cuota de llamadas propia de la API. Responder a reseñas, publicar posts y añadir fotos requiere una suscripción activa.
Solo los administradores de la organización. La clave da acceso a todos los establecimientos de la organización.
Añada su clave en la cabecera X-API-Key de cada petición. Una clave ausente o no válida devuelve un error 401.
No, solo hay una clave activa por organización. Generar una nueva desactiva la anterior.
Todavía no. La API publica solo en las fichas de Google. La publicación en Facebook e Instagram se hace desde la aplicación.
Creación, modificación y eliminación de un establecimiento; creación y modificación de una reseña; creación, modificación y eliminación de una respuesta. Todos los eventos van a su URL: fíltrelos por tipo.
Vuelva a calcular la firma HMAC-SHA256 del cuerpo sin procesar con su secreto y compárela con la cabecera X-Reputacion-Signature. La cabecera X-Reputacion-Delivery identifica el envío y no cambia entre intentos.
El envío se reintenta cuatro veces: a los 5 minutos, 30 minutos, 3 horas y luego 23 horas. Después se marca como fallido en el registro de envíos, y su webhook sigue activo para los eventos siguientes.
Salen en el minuto siguiente al evento. Una nueva reseña de Google genera su evento en cuanto la sincronización de sus fichas la detecta.
No hay un conector listo para usar. Cualquier herramienta capaz de llamar a una API puede, en cambio, lanzar una solicitud de reseña tras una compra o recibir nuestros webhooks.
En el centro de ayuda de su cuenta Reputacion, página API & Webhooks: endpoints, campos, formato de los eventos y verificación de la firma.
