Configurar webhooks de testimonios salientes
Conecte un punto final de recepción y comprenda los formatos actuales de entrega de pruebas y colecciones.
Actualizado
Panel actual de Socialjuice con datos de ejemplo. Las etiquetas siguen el idioma de tu panel.
En esta página
Preparar un punto final de recepción
Los webhooks envían información sobre nuevos testimonios de rutas de creación admitidas a otro servicio. Necesita un plan con webhooks, permiso para editar el espacio y un receptor HTTPS accesible públicamente. La validación de URL del panel no admite el host local, los nombres de host locales ni las direcciones de red privada.
Para Zapier o Make, primero cree un activador de webhook receptor y copie su URL HTTPS. No conecte una automatización orientada al cliente hasta que haya verificado la carga útil real y los encabezados de autenticación que recibirá.
Guarde y pruebe la conexión
- Abra Webhooks en la barra lateral. Abre Configuración del espacio de trabajo → Avanzado.
- Ingrese la URL del webhook y elija Guardar configuración del webhook. Guarde el secreto de firma generado de forma segura en su servidor receptor. Nunca lo incluyas en el código del navegador, capturas de pantalla o registros públicos.
- Elija Enviar evento de prueba. El panel envía un evento webhook.test firmado. Compruebe que el receptor devuelva una respuesta 2xx.
- Inspeccione la solicitud antes de asignar campos. Una prueba de panel exitosa verifica que la solicitud de prueba firmada; Las entregas de formularios de recogida actualmente utilizan un formato diferente, que se describe a continuación.
Comprender los dos formatos de entrega actuales
Los eventos de prueba del panel utilizan un sobre firmado por HMAC con campos de identificación, tipo, creación y datos. Los encabezados incluyen Socialjuice-Event, Socialjuice-Delivery, Socialjuice-Timestamp y Socialjuice-Signature. Un evento de creación firmado utiliza testimonial.created; la prueba del tablero utiliza webhook.test.
El servicio de recopilación actual envía el secreto configurado en X-Webhook-Secret a través de HTTPS. No adjunta los encabezados HMAC ni el sobre firmado. Las cargas útiles de la colección pueden contener campos testimoniales directamente o dentro de un objeto testimonial, según la ruta de la colección. Inspeccione una solicitud real antes de asignar el nombre, el correo electrónico, uuid y el contenido del testimonio. No asuma que la carga útil de prueba del panel coincide con una colección real.
Autenticar y manejar ambos formatos.
Para solicitudes firmadas, verifique HMAC SHA-256 sobre <timestamp>.<raw_request_body>, compare el resumen en tiempo constante y rechace las marcas de tiempo obsoletas. Para solicitudes de recopilación, compare X-Webhook-Secret con el secreto configurado en su servidor. Rechazar una solicitud que no pase la autenticación requerida para su formato.
El formato de secreto compartido no proporciona protección de reproducción de ID de entrega y marca de tiempo de eventos firmados. Deduplica las solicitudes de recolección con el testimonio uuid en el contexto del espacio correcto cuando esté disponible. Para eventos firmados, utilice Socialjuice-Delivery o la identificación del sobre. Pase únicamente los campos de cliente que su flujo de trabajo posterior necesita.
Límites de entrega y solución de problemas
Devuelva una respuesta 2xx rápidamente. El remitente firmado del panel realiza hasta tres intentos en total, con un tiempo de espera de 10 segundos por intento. El remitente de la colección actual realiza una única solicitud sin ese bucle de reintento. No asuma que los reintentos del remitente firmado se aplican a las entregas de formularios de cobro.
Si la herramienta de recepción no puede validar el encabezado requerido, realice un paso de verificación en su propio servidor antes de activar acciones confidenciales. Un webhook indica creación, no una nueva concesión de consentimiento para publicar. Revise la visibilidad pública y el consentimiento por separado.
Girar o desactivar la conexión
Si el secreto queda expuesto, utilice Rotar secreto y actualice todos los receptores inmediatamente. Esto cambia el secreto utilizado por ambos formatos de entrega. Para deshabilitar la entrega, borre la URL del webhook y guárdela. Mantenga el viejo secreto fuera de los registros públicos y las capturas de pantalla.