Comment configurer des webhooks pour être notifié des nouvelles soumissions de formulaires PDF

Benjamin André-Micolon

Une manière puissante d'envoyer les soumissions à votre application ou de connecter SimplePDF avec d'autres services comme Zapier ou Activepieces est d'utiliser des webhooks.

Webhooks ?

Les webhooks permettent de connecter des applications entre elles en envoyant des données en temps réel d'une application à une ou plusieurs autres lorsqu'un événement spécifique se produit.

Dans SimplePDF, chaque fois qu'un PDF est soumis via votre portail d'entreprise, soit en utilisant des liens de formulaire ou en l'intégrant dans votre site web, un événement est envoyé contenant le nom du document et l'URL de la soumission, entre autres.

De là, les possibilités sont infinies et vous pouvez laisser libre cours à votre imagination.

Par exemple, vous pourriez enregistrer ces informations dans une feuille Google ou l'intégrer avec Zapier ou Activepieces pour déverrouiller encore plus de possibilités !

Configurer des webhooks dans SimplePDF

La configuration des webhooks est disponible avec le plan STANDARD

• Connectez-vous à votre compte
• Accédez à la vue des paramètres du compte

• Cliquez sur Mettre à jour la configuration
• Entrez l'URL du webhook du service ou de l'application à laquelle vous souhaitez envoyer les événements

• Optionnel : spécifiez les en-têtes à envoyer avec le webhook

C'est fait ! Un événement sera envoyé chaque fois qu'il y aura une nouvelle soumission

Événements des webhooks

Vous trouverez ci-dessous les événements envoyés par SimplePDF au webhook que vous avez configuré.

• Nouvelle soumission

Contenu

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"
  }
}

À propos du contexte

Lorsque vous intégrez SimplePDF dans votre site web, vous pouvez vouloir associer des informations supplémentaires aux soumissions.

Par exemple, vous pourriez vouloir :

• Savoir si la soumission a été initiée depuis un environnement de développement vs un production.
• Envoyer des détails supplémentaires sur qui a soumis le formulaire (comme un utilisateur connecté) pour faciliter le traitement de la soumission.

Apprenez comment spécifier un contexte dans la documentation de SimplePDF embed

Terrain de jeu

Nous aimons les exemples chez SimplePDF, alors pourquoi ne pas voir un exemple réel de ce à quoi ressemblent les webhooks ?

1. Modifiez le contexte ci-dessous (cliquez pour éditer le contenu)

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

2. Soumettez ce formulaire

3. Le webhook envoyé par SimplePDF apparaîtra ici

Si vous avez des questions, n'hésitez pas à contacter support@simplepdf.com