Clientelo

Webhook e chiavi API

Collegare il modulo del tuo sito, Make.com o Zapier.

4 min di lettura

Prima controlla se ti serve davvero

Se vuoi solo importare i contatti da Facebook Lead Ads, non ti serve questa pagina: usa il collegamento diretto in Impostazioni → Meta Ads, è più semplice e non richiede servizi esterni. Il webhook serve per il modulo di contatto del tuo sito, per sorgenti diverse da Meta, o quando devi trasformare i dati prima di importarli.

Generare una chiave

  1. 1Vai in Impostazioni → API e Webhook
  2. 2Scrivi un'etichetta che ti ricordi a cosa serve — per esempio «Make.com» o «Sito web»
  3. 3Premi Genera chiave
  4. 4Copiala subito: viene mostrata per intero una volta sola

Una chiave per ogni servizio

Se un domani cambi strumento o qualcosa non ti convince, revochi solo quella chiave e il resto continua a funzionare. Revocare una chiave ferma immediatamente le integrazioni che la usano.

Come si invia un contatto

L'indirizzo del webhook è indicato nella stessa pagina. Si invia una richiesta POST in formato JSON con l'intestazione x-api-key valorizzata con la tua chiave.

full_nameNome completo (in alternativa first_name e last_name)
phoneNumero di telefono
emailIndirizzo email
lead_idIdentificativo di origine — è quello che evita i doppioni
source_formNome del modulo di provenienza
source_campaignNome della campagna
treatmentServizio di interesse
interestInteresse dichiarato
messageMessaggio libero, finisce nelle note della scheda

Deve arrivare almeno uno tra nome, telefono ed email. Se il numero corrisponde a una persona già presente, il contatto viene ricollegato alla scheda esistente invece di crearne una nuova.

Nella pagina trovi anche una guida passo passo per Make.com e Zapier, con lo scenario già impostato.

Approfondimenti