Conectar sus herramientas con los webhooks

Prepare la dirección de recepción

Es la dirección https de su servidor, de su CRM o de un escenario de Make o Zapier. Para probar sin instalar nada, abra webhook.site: aparece una dirección gratuita, cópiela.

Abra los ajustes

En el panel, haga clic en el nombre de su organización, abajo a la izquierda, y después en Ajustes y en la pestaña Webhooks.

Añada la dirección

Haga clic en Añadir una dirección, pegue la dirección y dele una descripción que le resulte clara, por ejemplo «Conversiones Google Ads».

Elija los eventos

Los eventos están ordenados por categoría: pagos, donaciones mensuales, pedidos, socios y entradas, certificados de donativo, transferencias… En caso de duda, déjelo todo marcado y haga clic en Añadir.

Copie el secreto

Una ventana muestra el secreto de firma (empieza por whsec_). Haga clic en Copiar y entrégueselo a su equipo técnico: demuestra que los mensajes proceden realmente de Donoor. Podrá volver a mostrarlo en cualquier momento.

Envíe un mensaje de prueba

En la tarjeta de su dirección, haga clic en Enviar una prueba. Sale de inmediato un mensaje de prueba, firmado igual que los reales.

Simule un evento real

Botón Simular un evento: elija, por ejemplo, «Pago confirmado» o «Entrada escaneada». Una vista previa muestra el mensaje y Donoor lo envía con datos ficticios (livemode false), sin ningún pago real. Para su servidor de desarrollo, añada una dirección activando Dirección de prueba: solo recibirá estas simulaciones.

Consulte el registro

Más abajo, el Registro de envíos muestra cada mensaje de los últimos 30 días con su estado: entregado, fallido o pendiente. Filtre con los botones situados encima de la lista.

Abra un envío

Haga clic en una línea: verá la respuesta de su servidor (código 200 si todo va bien), cada intento con su hora y el mensaje exacto enviado, que puede copiar si lo necesita.

Compruébelo en el servidor

En su herramienta (o en webhook.site), el mensaje ha llegado con la cabecera Donoor-Signature: es la que comprueba su equipo técnico.

Añada sus parámetros de seguimiento

En sus anuncios, añada a su enlace de Donoor los parámetros habituales: utm_source, utm_campaign… Google Ads añade él mismo el gclid si el etiquetado automático está activado. Los parámetros se conservan hasta el pago, aunque el donante cambie de pestaña.

El donante hace su donación

Para él no cambia nada: la página de donación es la misma. También funciona con el widget integrado en su sitio web.

Llega el mensaje

Menos de dos minutos después del pago, su herramienta recibe payment.succeeded: importe, donante, identificador de conversión y, en attribution, los parámetros del anuncio de origen.

Transmita la conversión

Su servidor, o un escenario de Make o Zapier, envía la conversión a Google Ads, GA4 o Meta con el importe y el identificador de conversión. Sus campañas se miden donación a donación, incluso cuando el navegador bloquea las cookies.

Modifique una dirección

El lápiz abre la ventana de la dirección: cambie su descripción o sus eventos. Los botones Marcar todo y Desmarcar todo actúan categoría por categoría.

Póngala en pausa

Pausar detiene los envíos a esta dirección, por ejemplo durante un mantenimiento. Reactivar los reanuda.

Cambie el secreto si es necesario

Botón Secreto y después Cambiar el secreto. El antiguo sigue siendo válido 24 horas, el tiempo que su equipo necesita para instalar el nuevo.

Si su servidor no responde

Donoor lo reintenta automáticamente 8 veces durante unas 28 horas; el registro muestra la hora del próximo intento. Tras el último, se le avisa por correo electrónico. Una dirección que falla durante 3 días se pone en pausa automáticamente.

Reenvíe un mensaje

Una vez reparado su servidor, abra el envío en el registro y haga clic en Reenviar: el mismo mensaje sale de nuevo de inmediato.

Comparta la documentación

Envíe a su equipo técnico el enlace a la Documentación técnica de los webhooks: describe cada evento y cada campo.

Verifique cada mensaje

El servidor verifica la cabecera Donoor-Signature con el secreto y después responde con un código 200 en menos de 10 segundos. Un ejemplo resuelto, con todos sus valores, permite probar el código.

Pruebe sin riesgo

En sandbox.donoor.org, un entorno de pruebas separado que los motores de búsqueda no indexan, cree una organización y conecte Stripe en modo de prueba (basta con información ficticia). Su página de pago de prueba queda en línea de inmediato: haga donaciones ficticias con la tarjeta 4242 4242 4242 4242 y reciba mensajes reales, marcados livemode false.