Cómo configurar webhooks para recibir notificaciones de nuevos envíos de formularios PDF

Benjamin André-Micolon

Una forma potente de enviar los envíos a su aplicación o conectar SimplePDF con otros servicios como Zapier o Activepieces es usar webhooks.

¿Webhooks?

Los webhooks permiten conectar aplicaciones entre sí enviando datos en tiempo real de una aplicación a otra(s) cada vez que ocurre un evento determinado.

En SimplePDF, cada vez que se envía un PDF a través de su portal de empresa, ya sea usando enlaces de formulario o integración en su sitio web, se envía un evento que contiene el nombre del documento y la URL del envío entre otras cosas.

A partir de ahí, las posibilidades son infinitas y puede dejar volar su imaginación.

Podría, por ejemplo, guardar esa información en una hoja de Google o integrarlo con Zapier o Activepieces y desbloquear aún más posibilidades.

Configurar webhooks en SimplePDF

La configuración de webhooks está disponible con el plan BASIC

Inicie sesión en su cuenta
Navegue a la vista de configuración de la cuenta

Configurar webhooks en la vista de cuenta

Haga clic en Update configuration
Introduzca la URL del webhook del servicio o aplicación al que desea enviar eventos

Configurar webhooks: detalles de configuración

Opcional: especifique los headers a enviar como parte del webhook

¡Eso es todo! Se enviará un evento cada vez que haya un nuevo envío

Eventos de webhook

A continuación encontrará los eventos que SimplePDF envía al webhook que configuró.

Nuevo envío

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

Sobre el contexto

Cuando integra SimplePDF en su sitio web, puede querer asociar información adicional a los envíos.

Por ejemplo, puede querer:

Saber si el envío fue iniciado desde un entorno de desarrollo (environment) o uno de producción (production).
Enviar detalles adicionales sobre quién envió el formulario (como un usuario con sesión iniciada) que le faciliten el procesamiento del envío.

Aprenda cómo especificar un context en la documentación de SimplePDF embed

Zona de pruebas

En SimplePDF nos gustan los ejemplos, así que ¿qué tal un ejemplo real de cómo funcionan los webhooks?

Modifique el contexto a continuación (haga clic para editar el contenido)

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

Envíe este formulario
El webhook enviado por SimplePDF aparecerá aquí