---
title: "Envie dados para os seus sistemas com webhooks"
description: "Receba um pedido no seu próprio URL quando alguém se regista ou ganha, com um payload assinado e um registo de cada entrega."
url: https://scratcher.io/pt/help/developers/webhooks
language: pt
---

1. [Centro de ajuda](https://scratcher.io/pt/help)
2. [API, webhooks e MCP](https://scratcher.io/pt/help/developers)
3. Envie dados para os seus sistemas com webhooks

# Envie dados para os seus sistemas com webhooks

Receba um pedido no seu próprio URL quando alguém se regista ou ganha, com um payload assinado e um registo de cada entrega.

Um webhook envia dados para um URL à sua escolha no momento em que algo acontece, por exemplo quando alguém se regista ou ganha um prémio. O seu programador configura o sistema que os recebe. Os webhooks fazem parte do plano Basic e superiores.

## Adicionar um webhook

Pode adicionar webhooks a uma campanha, no editor em **Ligar** > **Webhooks**, ou a toda a conta em **Definições** > **Webhooks**.

1. Clique em **Adicionar webhook**.
2. Introduza o **URL do payload**. Tem de usar HTTPS.
3. Escolha o **Tipo de conteúdo**: application/json ou application/x-www-form-urlencoded.
4. Escolha o **Método**: **POST** ou **GET**. Use POST, a menos que o seu sistema precise de GET, que envia os dados no URL.
5. Introduza um **Secret** para assinar os pedidos (recomendado).
6. Escolha os eventos em **Que eventos devem acionar o webhook?**:
    - "Quando é criado um novo lead" (ao nível da conta)
    - "Sempre que um lead participa numa campanha"
    - "Quando um lead ganha um prémio"
7. Confirme que **Ativo** está ligado e guarde.

No editor de campanhas também pode escolher **Basic Auth** em **Autenticação** e usar **Payload personalizado** para decidir os nomes dos campos.

## O que é enviado

O corpo tem um `event` e um objeto `data` com a campanha (id e nome), os campos do lead, o canal, os consentimentos com texto, hora e endereço IP, as respostas ao quiz e, para os vencedores, o prémio com o respetivo código. Os valores vazios são omitidos.

## Verificar a assinatura

Se definir um secret, cada pedido tem um cabeçalho `X-Hub-Signature`: `sha1=` seguido de um HMAC-SHA1 dos dados codificados em JSON, usando o seu secret como chave. Calcule o mesmo do seu lado e compare, para ter a certeza de que o pedido veio do Scratcher.

## Entregas e novas tentativas

Se o seu URL não responder ou devolver um erro, o Scratcher tenta mais duas vezes: após 5 segundos e após um minuto. Clique em **Mostrar entregas** (ou **Ver entregas**) para ver cada pedido e resposta, mostrar apenas os falhados e usar **Tentar novamente** numa entrega. As entregas são guardadas durante 60 dias.

Ative **Registar corpo da resposta** para guardar também o que o seu sistema respondeu, o que ajuda na depuração.

API, webhooks e MCP

- [Comece a usar a API REST](https://scratcher.io/pt/help/developers/rest-api)
- [Envie dados para os seus sistemas com webhooks](https://scratcher.io/pt/help/developers/webhooks)
- [Scratcher MCP para as suas próprias ferramentas de IA](https://scratcher.io/pt/help/developers/mcp)

## Artigos relacionados

- [Comece a usar a API REST](https://scratcher.io/pt/help/developers/rest-api): Crie um token de acesso, escolha os âmbitos e leia campanhas, leads e listas a partir dos seus próprios sistemas.
- [Verifique o estado da entrega e reenvie leads](https://scratcher.io/pt/help/integrations/delivery-status): Veja que leads foram enviados para as suas ferramentas, descubra porque falhou uma entrega e envie-a novamente.
- [Ligue mais de 8000 aplicações com o Zapier](https://scratcher.io/pt/help/integrations/zapier): Envie os novos registos do Scratcher para o Google Sheets, o Slack, o seu CRM ou milhares de outras aplicações com o Zapier.

## Ainda precisa de ajuda?

Há pessoas reais prontas para ajudar. Se já usa o Scratcher, o mais rápido é o chat dentro da plataforma.

- **[Fale connosco no chat](https://platform.scratcher.io/login)**

    Inicie sessão e clique no botão de chat no canto inferior direito. O Rex responde de imediato e a nossa equipa está à distância de um clique.
- **[Marque uma reunião](https://scratcher.io/pt/book-a-meeting)**

    Uma videochamada gratuita de 30 minutos com a nossa equipa: uma demonstração, ideias de campanhas ou ajuda com a sua configuração.
- **[Envie-nos um e-mail](mailto:contact@scratcher.io)**

    Escreva para contact@scratcher.io e entraremos em contacto consigo.