Ligar as suas ferramentas com webhooks

Prepare o endereço de receção

É o endereço https do seu servidor, do seu CRM ou de um cenário Make ou Zapier. Para experimentar sem instalar nada, abra o webhook.site: aparece um endereço gratuito; copie-o.

Abra as definições

No painel, carregue no nome da sua associação, em baixo à esquerda, e depois em Definições e no separador Webhooks.

Adicione o endereço

Carregue em Adicionar um endereço, cole o endereço e dê-lhe uma descrição que lhe diga algo, por exemplo «Conversões Google Ads».

Escolher os eventos

Os eventos estão agrupados por família: pagamentos, donativos mensais, encomendas, associados e bilhetes, recibos de donativo, transferências… Em caso de dúvida, deixe tudo marcado e clique em Adicionar.

Copie o segredo

Uma janela mostra o segredo de assinatura (começa por whsec_). Clique em Copiar e transmita-o à sua equipa técnica: prova que as mensagens vêm efetivamente da Donoor. Poderá voltar a mostrá-lo a qualquer momento.

Envie uma mensagem de teste

No cartão do seu endereço, clique em Enviar um teste. Uma mensagem de teste parte de imediato, assinada como as reais.

Simule um evento real

Botão Simular um evento: escolha, por exemplo, «Pagamento confirmado» ou «Entrada digitalizada». Uma pré-visualização mostra a mensagem e, em seguida, a Donoor envia-a com dados fictícios (livemode false), sem qualquer pagamento real. Para o seu servidor de desenvolvimento, adicione um endereço marcando Endereço de teste: só recebe estas simulações.

Consulte o registo

Mais abaixo, o Registo dos envios lista cada mensagem dos últimos 30 dias, com o respetivo estado: com sucesso, com falha ou pendente. Filtre com os botões acima da lista.

Abra um envio

Clique numa linha: vê a resposta do seu servidor (código 200 se tudo estiver bem), cada tentativa com a respetiva hora, e a mensagem exata enviada, para copiar se necessário.

Verifique do lado do servidor

Na sua ferramenta (ou no webhook.site), a mensagem chegou com o cabeçalho Donoor-Signature: é este que a sua equipa técnica verifica.

Adicione os seus parâmetros de acompanhamento

Nos seus anúncios, acrescente ao seu link Donoor os parâmetros habituais: utm_source, utm_campaign… O Google Ads acrescenta ele próprio o gclid se a marcação automática estiver ativada. Os parâmetros são guardados até ao pagamento, mesmo que o doador mude de separador.

O doador faz o seu donativo

Para o doador, nada muda: a página de donativo é a mesma. Funciona também com o widget integrado no seu site.

A mensagem chega

Menos de dois minutos após o pagamento, a sua ferramenta recebe payment.succeeded: montante, doador, identificador de conversão e, em attribution, os parâmetros do anúncio de origem.

Enviar a conversão

O seu servidor, ou um cenário Make ou Zapier, envia a conversão ao Google Ads, ao GA4 ou à Meta com o montante e o identificador de conversão. As suas campanhas são medidas donativo a donativo, mesmo quando o navegador bloqueia os cookies.

Editar um endereço

O lápis abre a janela do endereço: altere a descrição ou os eventos. Os botões Marcar tudo e Desmarcar tudo funcionam família a família.

Coloque-o em pausa

Pausar interrompe os envios para este endereço, por exemplo durante uma manutenção. Reativar retoma-os.

Altere o segredo se necessário

Botão Segredo, depois Mudar o segredo. O antigo continua válido durante 24 horas, o tempo de a sua equipa instalar o novo.

Se o seu servidor não responder

A Donoor tenta novamente 8 vezes durante cerca de 28 horas; o registo mostra a hora da próxima tentativa. Após a última, é avisado por e-mail. Um endereço com falhas durante 3 dias é colocado em pausa automaticamente.

Reenviar uma mensagem

Quando o seu servidor estiver reparado, abra o envio no registo e carregue em Reenviar: a mesma mensagem volta a ser enviada de imediato.

Partilhe a documentação

Envie à sua equipa técnica o link da documentação técnica dos webhooks: descreve cada evento e cada campo.

Verifique cada mensagem

O servidor verifica o cabeçalho Donoor-Signature com o segredo e depois responde com um código 200 em menos de 10 segundos. Um exemplo cifrado permite testar o código.

Teste sem risco

Em sandbox.donoor.org, ambiente de teste separado e não indexado pelos motores de pesquisa, crie uma associação e ligue a Stripe em modo de teste (bastam dados fictícios). A sua página de pagamento de teste fica logo online: faça aí donativos fictícios com o cartão 4242 4242 4242 4242 e receba mensagens reais, marcadas com livemode false.