Volver al diccionario
Desarrollo Web
Webhooks
Mecanismo para que una aplicación envíe datos en tiempo real a otra cuando ocurre un evento.
Qué son los Webhooks
Los webhooks son "callbacks HTTP": una forma de que una aplicación notifique a otra sobre eventos en tiempo real. En lugar de polling (preguntar repetidamente si hay novedades), la aplicación origen envía automáticamente datos cuando algo sucede.
Cómo funciona
1. Registras una URL en la aplicación origen
2. Ocurre un evento en esa aplicación
3. La aplicación hace un POST a tu URL con los datos del evento
4. Tu servidor procesa la información
Ejemplo: Pago completado
Una pasarela de pago notifica a tu tienda:
```
POST https://mitienda.com/webhooks/payment
Content-Type: application/json
{
"event": "payment.completed",
"data": {
"order_id": "12345",
"amount": 99.99,
"currency": "EUR",
"customer_email": "cliente@email.com"
}
}
```
Casos de uso comunes
- Pagos (Stripe, PayPal)
- Notificaciones de pedidos (Shopify, WooCommerce)
- CI/CD (GitHub, GitLab)
- Comunicación (Slack, Discord)
- CRMs (HubSpot, Salesforce)
Mejores prácticas
Verificar autenticidad
Validar firmas para asegurar que el webhook viene de la fuente legítima.
Idempotencia
Procesar el mismo webhook múltiples veces debe dar el mismo resultado.
Respuesta rápida
Devolver 200 OK rápidamente y procesar en background.
Reintentos
Esperar reintentos si tu servidor no responde.
```javascript
// Ejemplo Next.js API Route
export async function POST(request) {
const payload = await request.json()
// Verificar firma
if (!verifySignature(payload)) {
return new Response("Invalid", { status: 401 })
}
// Procesar en background
await processWebhook(payload)
return new Response("OK", { status: 200 })
}
```
Necesitas ayuda con tu ecommerce?
Somos expertos en desarrollo de tiendas online. Cuéntanos tu proyecto y te asesoramos sin compromiso.
Contactar con Ganton