# Introducción a los Webhooks

Fuente: /webhooks/webhooks-introduction/

Los **Webhooks** son la forma más eficiente y moderna de mantener tus sistemas sincronizados con los eventos que ocurren en la plataforma de **Verificamex**.

> **Concepto Clave**
>
> En lugar de que tu servidor pregunte constantemente "¿Ya terminó la verificación?" (Polling), nuestra plataforma le "toca la puerta" a tu servidor en el momento exacto en que algo sucede.

![Diagrama de Webhooks](/_astro/webhook-verificamex.UHn3wFUr.jpg)

### ¿Por qué usar Webhooks?

Los webhooks eliminan la necesidad de consultas innecesarias a la API, permitiendo una arquitectura reactiva y escalable.

**Tiempo Real**

Recibe notificaciones instantáneas en cuanto cambia el estado de una verificación o transacción.

**Eficiencia**

Reduce drásticamente el consumo de recursos y ancho de banda al evitar el polling repetitivo.

**Automatización**

Dispara flujos de trabajo automáticos en tu backend (como enviar correos o actualizar bases de datos).

**Escalabilidad**

Facilita la integración con servicios de terceros y arquitecturas basadas en microservicios.

***

### ¿Cómo funcionan?

Implementar webhooks en tu flujo de integración es un proceso sencillo dividido en cinco etapas clave:

1. **Prepara tu Endpoint**: Configura una URL pública en tu servidor (ej. `https://tu-api.com/webhooks/verificamex`) que acepte solicitudes `POST`.
2. **Registra la URL**: Al iniciar un proceso (como una sesión de verificación), incluye esta URL en los parámetros correspondientes.
3. **Escucha Eventos**: Cuando ocurra un evento relevante (ej. `verification.completed`), Verificamex enviará un payload JSON a tu URL.
4. **Verifica la Firma**: Cada envío va firmado con tu clave en los headers `webhook-id`, `webhook-timestamp` y `webhook-signature`. Compruébala antes de procesar el evento ([ver cómo](/webhooks/webhooks-security/)).
5. **Responde con Éxito**: Tu servidor debe procesar el evento y responder con un código de estado `200 OK` para confirmar la recepción.

> **Precaución**
>
> Es fundamental que tu endpoint sea accesible desde internet y cuente con un certificado SSL (HTTPS) válido para garantizar la seguridad de la comunicación.

### Próximos Pasos

¿Listo para empezar a recibir notificaciones en tiempo real?

**Guía de Uso**

Consulta los detalles técnicos, configuración y ejemplos de payloads.

[Ver Guía de Uso](/webhooks/using-webhooks-in-verificamex)

**API Reference**

Explora todos los endpoints que soportan notificaciones vía webhook.

[Ir a API Ref](/identity-verification/create-verification-session)