Skip to main content

Calendly

Collega Calendly per ricevere dati di attribution dalle domande dei form di prenotazione. Quando qualcuno prenota un appuntamento, Calendly invia un webhook con tutte le risposte dell’invitato — inclusa la tua domanda “Come ci hai conosciuto?” — che Finseo normalizza in canali di attribution.

Requisiti

  • I webhook di Calendly richiedono un piano a pagamento: Standard, Teams o Enterprise (non disponibili su Free).
  • Le sottoscrizioni webhook si creano tramite l’API di Calendly — non esiste un toggle nell’interfaccia. Ti serve un personal access token dalla pagina delle integrazioni Calendly.
  • Una domanda per l’invitato sul tuo tipo di evento, ad es. “Come ci hai conosciuto?”.

Ottieni il tuo URL webhook

  1. In Finseo apri Integrations → Calendly → Connect.
  2. Copia il tuo URL webhook personale (contiene l’ID del tuo progetto, ?source=calendly e un token segreto):

Crea la sottoscrizione webhook

Crea la sottoscrizione con una singola chiamata API (sostituisci il token e gli URL):
Usa invece "scope": "user" con un URI user se vuoi solo le tue prenotazioni. Finseo estrae automaticamente la risposta di attribution dall’array questions_and_answers. Consulta la documentazione sui webhook di Calendly per i dettagli.

Test e mappatura dei campi

  • Usa il live listener nella finestra di connessione di Finseo: prenota un appuntamento di prova e ispeziona il payload ricevuto.
  • Se la tua domanda è formulata diversamente, seleziona la risposta giusta sotto Field Mapping.

Risoluzione dei problemi

I webhook richiedono un piano Standard o superiore sull’account Calendly proprietario del token. Gli account Free possono leggere l’API ma non possono creare sottoscrizioni webhook.
Assicurati che la domanda faccia parte delle domande per l’invitato del tipo di evento (o di un routing form) — le risposte compaiono nel payload solo se l’invitato ha effettivamente visto la domanda.