Webhooks
Una llamada HTTP firmada a tu servidor con cada evento: opinión, nota baja, testimonio, contacto, invitación, enlace roto.
Cada webhook recibe una petición POST JSON con los campos id, event, occurred_at, account_id y data con las cabeceras X-Repotz-Event, X-Repotz-Delivery y una firma X-Repotz-Signature (HMAC-SHA256 de «marca de tiempo.cuerpo» con tu secreto). En caso de fallo, RepOtz reintenta tras 1 min, 5 min, 30 min, 2 h y 12 h; el registro de los últimos 30 días se consulta y se reenvía desde el panel. Tras 20 fallos consecutivos el webhook se pausa y se te avisa.
Cómo funciona
- 1
Panel > Integraciones > Nuevo webhook: tu URL https y los eventos.
- 2
Copia el secreto mostrado una sola vez y verifica la firma en tu servidor.
- 3
Envía un ping para validar y consulta el registro de entregas.
Qué puedes hacer
- Avisar a tu propio sistema de tickets de una nota baja.
- Alimentar tu almacén de datos sin consultar la API.
- Hacer que un agente de IA propio reaccione a cada opinión.
Preguntas frecuentes
¿Cómo verifico la firma?
Recalcula HMAC-SHA256(marca de tiempo + '.' + cuerpo bruto) con tu secreto y compáralo con el valor v1 de la cabecera; rechaza una marca de tiempo de más de cinco minutos.
¿Qué pasa si mi servidor está caído?
Cinco intentos repartidos en quince horas y luego la entrega se marca como fallida; la reenvías con un clic cuando el servidor vuelva.
API y webhooks están incluidos desde el plan Pro. Los scopes de analytics, testimonios y auditorías requieren el plan Agency.
Mira primero dónde está tu reputación
La auditoría gratuita puntúa tu presencia en línea en un minuto; la prueba de 14 días abre la API y los webhooks.