Pruebas

Probar y depurar webhooks

Verifica que tu integración de webhooks funcione antes de desplegarla en producción. Esta página explica cómo recibir webhooks en tu máquina local y cómo diagnosticar errores comunes de entrega y verificación.

​

Desarrollo local

Los webhooks requieren una URL accesible públicamente, por lo que tendrás que exponer tu servidor local a Internet durante el desarrollo.

​

Uso de Cloudflare Tunnels

Cloudflare Tunnels ofrece una forma gratuita de exponer tu servidor local sin necesidad de abrir puertos en el firewall:

cloudflared tunnel --url localhost:3000

Obtendrás una URL pública como https://abc123.trycloudflare.com. Utiliza esta URL en la configuración de tu webhook:

{
  "url": "https://abc123.trycloudflare.com/webhook"
}

​

Resolución de problemas

​

Los webhooks no llegan

• Endpoint no accesible: Comprueba que tu servidor sea accesible públicamente y que los firewalls permitan conexiones entrantes
• Uso de HTTP: Las URLs de webhook deben usar HTTPS
• Eventos incorrectos: Revisa el filtro de events en la configuración de tu webhook

​

Error en la verificación de la firma

La causa más común es usar el cuerpo JSON ya parseado en lugar del cuerpo bruto de la solicitud.

// Incorrecto: usando el body parseado
const signature = crypto
  .createHmac('sha256', secret)
  .update(JSON.stringify(req.body))
  .digest('hex');

// Correcto: usando el body en crudo
app.use('/webhook', express.raw({ type: 'application/json' }));
app.post('/webhook', (req, res) => {
  const signature = crypto
    .createHmac('sha256', secret)
    .update(req.body) // Buffer en crudo
    .digest('hex');
});

​

Otros problemas

• Secreto incorrecto - Verifica que estés usando la clave secreta correcta en la configuración de tu cuenta
• Errores de tiempo de espera (timeout) - Asegúrate de que tu endpoint responda en menos de 10 segundos