Webhooks
Los webhooks permiten que una URL HTTPS de su propiedad reciba un POST con cuerpo JSON cuando ocurre un evento soportado (por ejemplo, relacionado con registros de campo o con nuevo usuario tras un onboarding, según las categorías que muestre su pantalla).
Cómo configurarlos
- Inicie sesión como administrador del panel.
- Vaya a Configuración (
/configuracion). - Abra la sección Webhooks (
/webhooks). - Cree un webhook: asigne un nombre, la URL de destino y, si lo necesita, cabeceras HTTP (por ejemplo token de autorización).
- Elija la categoría del evento que corresponda a su caso de uso y active el webhook cuando esté listo para producción.
- Si aparece la opción de incluir todo el canal (o similar), lea la descripción en pantalla antes de activarla: amplía el alcance de los eventos según la configuración de su organización.
Recomendaciones técnicas
- Responda con un código 2xx en pocos segundos; procese trabajo pesado en segundo plano.
- Diseñe el receptor como idempotente (reintentos pueden ocurrir).
- Valide identidad con las cabeceras que haya configurado en Harvis.
- El detalle de campos del JSON puede evolucionar: versione su consumidor y sea tolerante a propiedades nuevas.
Si no ve la entrada Webhooks en Configuración, puede deberse a su plan o a flags de empresa: consulte con soporte.
API REST pública
La guía pública y estable de la API REST de Harvis (autenticación, recursos, ejemplos y límites) está en desarrollo. Cuando esté lista, se publicará desde esta misma sección de documentación.
Mientras tanto, para integraciones en tiempo real lo habitual es usar webhooks desde el panel. Para necesidades empresariales (sandbox, alcance, acuerdos), contacte al equipo de producto o comercial.