---
title: "Invia dati ai tuoi sistemi con i webhook"
description: "Ricevi una richiesta al tuo URL quando qualcuno si iscrive o vince, con un payload firmato e un registro di ogni consegna."
url: https://scratcher.io/it/help/developers/webhooks
language: it
---

1. [Centro assistenza](https://scratcher.io/it/help)
2. [API, webhook e MCP](https://scratcher.io/it/help/developers)
3. Invia dati ai tuoi sistemi con i webhook

# Invia dati ai tuoi sistemi con i webhook

Ricevi una richiesta al tuo URL quando qualcuno si iscrive o vince, con un payload firmato e un registro di ogni consegna.

Un webhook invia dati a un URL che scegli tu nel momento in cui succede qualcosa, per esempio quando qualcuno si iscrive o vince un premio. Il sistema che li riceve lo configura il tuo sviluppatore. I webhook sono inclusi dal piano Basic in su.

## Aggiungi un webhook

Puoi aggiungere webhook a una campagna, nell'editor in **Collega** > **Webhook**, oppure per tutto il tuo account in **Impostazioni** > **Webhook**.

1. Clicca su **Aggiungi webhook**.
2. Inserisci l'**URL del payload**. Deve usare HTTPS.
3. Scegli il **Tipo di contenuto**: application/json o application/x-www-form-urlencoded.
4. Scegli il **Metodo**: **POST** o **GET**. Usa POST, a meno che il tuo sistema non richieda GET, che invia i dati nell'URL.
5. Inserisci un **Secret** per firmare le richieste (consigliato).
6. Scegli gli eventi in **Quali eventi devono attivare il webhook?**:
    - "Quando viene creato un nuovo lead" (a livello di account)
    - "Ogni volta che un lead partecipa a una campagna"
    - "Quando un lead vince un premio"
7. Assicurati che **Attivo** sia attivato e salva.

Nell'editor della campagna puoi anche scegliere **Basic Auth** in **Autenticazione** e usare **Payload personalizzato** per decidere tu i nomi dei campi.

## Cosa viene inviato

Il corpo contiene un `event` e un oggetto `data` con la campagna (id e nome), i campi del lead, il canale, i consensi con testo, orario e indirizzo IP, le risposte ai quiz e, per i vincitori, il premio con il suo codice. I valori vuoti vengono omessi.

## Verifica la firma

Se imposti un secret, ogni richiesta ha un header `X-Hub-Signature`: `sha1=` seguito da un HMAC-SHA1 dei dati codificati in JSON, con il tuo secret come chiave. Calcola lo stesso valore dal tuo lato e confrontali, per essere sicuro che la richiesta arrivi da Scratcher.

## Consegne e nuovi tentativi

Se il tuo URL non risponde o restituisce un errore, Scratcher riprova altre due volte: dopo 5 secondi e dopo un minuto. Clicca su **Mostra consegne** (o **Vedi consegne**) per vedere ogni richiesta e risposta, mostrare solo quelle non riuscite e usare **Riprova** su una consegna. Le consegne vengono conservate per 60 giorni.

Attiva **Registra il corpo della risposta** per salvare anche la risposta del tuo sistema, utile per il debug.

API, webhook e MCP

- [Inizia con la REST API](https://scratcher.io/it/help/developers/rest-api)
- [Invia dati ai tuoi sistemi con i webhook](https://scratcher.io/it/help/developers/webhooks)
- [Scratcher MCP per i tuoi strumenti AI](https://scratcher.io/it/help/developers/mcp)

## Articoli correlati

- [Inizia con la REST API](https://scratcher.io/it/help/developers/rest-api): Crea un token di accesso, scegli gli ambiti e leggi campagne, lead e liste dai tuoi sistemi.
- [Controlla lo stato della consegna e invia di nuovo i lead](https://scratcher.io/it/help/integrations/delivery-status): Scopri quali lead sono stati inviati ai tuoi strumenti, perché una consegna non è riuscita e inviala di nuovo.
- [Collega oltre 8.000 app con Zapier](https://scratcher.io/it/help/integrations/zapier): Invia i nuovi iscritti da Scratcher a Google Sheets, Slack, il tuo CRM o migliaia di altre app con Zapier.

## Hai ancora bisogno di aiuto?

Persone vere sono qui per aiutarti. Se usi già Scratcher, il modo più veloce è la chat all'interno della piattaforma.

- **[Chatta con noi](https://platform.scratcher.io/login)**

    Accedi e clicca sul pulsante della chat in basso a destra. Rex risponde subito e il nostro team è a un clic di distanza.
- **[Prenota un incontro](https://scratcher.io/it/book-a-meeting)**

    Una videochiamata gratuita di 30 minuti con il nostro team: un tour, idee per campagne o aiuto con la configurazione.
- **[Scrivici](mailto:contact@scratcher.io)**

    Scrivi a contact@scratcher.io e ti risponderemo.