Come configurare i webhook per ricevere notifiche sulle nuove compilazioni dei moduli PDF

Benjamin André-Micolon

Un modo potente per inviare le compilazioni alla tua applicazione o collegare SimplePDF con altri servizi come Zapier o Activepieces è usare i webhook.

Webhook?

I webhook permettono di collegare applicazioni tra loro inviando dati in tempo reale da un'applicazione all'altra ogni volta che si verifica un determinato evento.

In SimplePDF, ogni volta che un PDF viene inviato tramite il portale della tua azienda, sia usando i link dei moduli che integrandolo nel tuo sito web, viene inviato un evento contenente il nome del documento e l'URL della compilazione tra le altre informazioni.

Da lì, il limite è il cielo e puoi dare libero sfogo alla tua immaginazione.

Potresti ad esempio salvare quelle informazioni in un foglio Google o integrarle con Zapier o Activepieces e sbloccare ancora più possibilità!

Configurare i webhook in SimplePDF

La configurazione dei webhook è disponibile con il piano BASIC

• Accedi al tuo account
• Vai alla vista delle impostazioni dell'account

• Fai clic su Update configuration
• Inserisci l'URL del webhook del servizio o dell'applicazione a cui vuoi inviare gli eventi

• Facoltativo: specifica gli header da inviare come parte del webhook

Ecco fatto! Un evento verrà inviato ogni volta che c'è una nuova compilazione

Eventi webhook

Di seguito troverai gli eventi inviati da SimplePDF al webhook che hai configurato.

• Nuova compilazione

Payload

type: "submission.created",
data: {
  document: {
    id: "b7615a68-9e1f-4eac-bd20-5e80632a4d9e",
    name: "your_document.pdf",
  },
  submission: {
    id: "80146d5b-a068-490f-8eb9-fe393ba11396",
    submitted_at: "2023-06-04T11:54:58.995Z",
    url: "short_lived_15min_url",
  },
  context: {
    environment: "production",
    customer_id: "123"
  }
}

Informazioni sul contesto

Quando integri SimplePDF nel tuo sito web, potresti voler associare informazioni aggiuntive alle compilazioni.

Ad esempio, potresti voler:

• Sapere se la compilazione è stata avviata da un ambiente di sviluppo (environment) rispetto a uno di production.
• Inviare dettagli aggiuntivi su chi ha compilato il modulo (come un utente connesso) che ti faciliteranno l'elaborazione della compilazione.

Scopri come specificare un context nella documentazione di SimplePDF embed

Playground

A SimplePDF ci piacciono gli esempi, quindi che ne dici di un esempio reale di come funzionano i webhook?

1. Modifica il contesto qui sotto (fai clic per modificare il contenuto)

{"environment":"production","customer_id":"123"}

2. Invia questo modulo

3. Il webhook inviato da SimplePDF apparirà qui

Se hai domande, non esitare a contattarci all'indirizzo support@simplepdf.com