Solucionar problemas de entrega de webhooks
Diagnostique diferencias entre prueba y recopilación, errores de autenticación, tiempos de espera y trabajo duplicado.
Actualizado
En esta página
La prueba funciona pero la colección real no.
El tablero envía un sobre webhook.test firmado. El servicio de recogida actual envía X-Webhook-Secret y un cuerpo diferente, sin los encabezados HMAC. Un receptor que solo acepte el formato del panel rechazará las solicitudes de cobro.
Inspeccione los encabezados y el cuerpo de la solicitud real en el historial de solicitudes privadas de su destinatario. Configure la autenticación adecuada y la asignación de campos para cada formato admitido. Los campos de colección pueden estar en el nivel superior o dentro de un objeto testimonial. No publique campos privados de clientes durante la depuración.
Ninguna solicitud llega a su destinatario
- Verifique que la URL del webhook se haya guardado en el espacio correcto y que el plan del propietario incluya webhooks.
- Utilice un punto final público HTTPS que acepte POST. Verifique las reglas del firewall, los requisitos de inicio de sesión y la ortografía de la URL.
- Elija Enviar evento de prueba e inspeccione el historial del receptor. Una solicitud entregada con un paso posterior fallido del flujo de trabajo es un problema diferente a que no llegue ninguna solicitud.
- Devuelva una respuesta 2xx rápidamente. El remitente firmado del panel de control expira después de 10 segundos y realiza hasta tres intentos en total. Actualmente, las solicitudes de cobro no utilizan el mismo ciclo de reintento.
La autenticación falla
Para eventos firmados, verifique los bytes de solicitud sin procesar antes de analizar JSON, use HMAC SHA-256, verifique el secreto actual y valide la marca de tiempo. Un reloj secreto rotado o un reloj de servidor incorrecto pueden interrumpir la verificación.
Para solicitudes de recopilación, valide X-Webhook-Secret con el secreto configurado actual. No intente encontrar Socialjuice-Signature en este formato y nunca desactive la autenticación para que funcione una automatización.
Trabajo repetido o faltante
Deduplicar solicitudes firmadas con Socialjuice-Delivery o la identificación del sobre. Las solicitudes de cobro necesitan un identificador de testimonio estable, como uuid, cuando esté disponible. Confirme que la automatización no se esté ejecutando una vez para la prueba de conexión y nuevamente para un envío real.
Ninguna ruta de entrega es una cola ilimitada ni una garantía de entrega final. Después de corregir el receptor, envíe otra prueba del tablero y verifique el formato apropiado por separado. Es posible que las reseñas importadas y otras rutas de creación no emitan el mismo evento; inspeccionar la ruta específica en lugar de asumir la cobertura universal.
Pida ayuda con evidencia redactada
Envíe al soporte la hora aproximada, el espacio afectado, el formato de entrega, el estado de la respuesta y un mensaje de error redactado. Incluya un ID de entrega para eventos firmados, si está disponible. Nunca incluya el secreto de firma, el valor X-Webhook-Secret, los tokens de acceso ni los datos de contacto privados del cliente.