Zapier, Make y n8n
Conectar Dinaup con plataformas de automatización sin una app propia: recibir avisos con un webhook saliente y llamar a la API REST de tu empresa desde un módulo HTTP con el token Bearer.
No hay una app de Dinaup en los catálogos de Zapier, Make ni n8n. Se conecta con un webhook saliente hacia la URL de un disparador por webhook del escenario y, en sentido contrario, con llamadas HTTP a la API REST con el token.
Antes de empezar
- Una clave API con Compatible WebHook marcado, su token Bearer y la URL de tu empresa. Ver El token Bearer.
- Para recibir avisos, la app Desarrollo de Play. Ver Webhooks Salientes.
Recibir avisos de Dinaup en un escenario
Crea el disparador en la plataforma
Crea un disparador por webhook en la plataforma y copia su URL.
Crea el webhook saliente en Play
En Desarrollo → Conectar → Webhooks Salientes, pulsa Nuevo. Elige la sección, marca Disparar nuevos o Disparar modificaciones, pega la URL y rellena Bearer Token con un secreto que tu escenario compruebe. Ver Webhooks salientes.
Prueba con el simulador
En la misma pantalla, elige el webhook y un registro y pulsa Enviar. El escenario recibe el cuerpo real, previousData y newData con cada campo como texto, y con él mapeas los campos.
El disparador tiene que responder 2xx en menos de 30 segundos; si no, Dinaup cuenta un fallo y lo intenta hasta 3 veces en total.
Llamar a la API desde el escenario
Cada petición del módulo HTTP lleva la cabecera Authorization: Bearer <token>.
| Necesitas | Petición |
|---|---|
| Leer datos | POST https://<clave-de-conexion>.dinaup.io/api/reports?id=<id-del-informe>&page=1&resultsPerPage=100 con cuerpo {}. Las filas llegan en data. |
| Renderizar un documento | POST https://<clave-de-conexion>.dinaup.io/api/dynamicdocuments?id=<id-del-documento> |
| Crear o editar un registro | POST https://<clave-de-conexion>.dinaup.io/api/writeoperations?sectionId=<id>&FieldPrimary=id&scripts=true con el registro en el cuerpo |
| Comprobar la conexión | GET https://<clave-de-conexion>.dinaup.io/api/whoami |
Un rechazo del servidor de tu empresa llega con su código 4xx. Un 500 en writeoperations puede ser un registro que no se pudo guardar: lee el motivo del cuerpo antes de repetir la escritura. Parámetros, cuerpos y respuestas: Referencia de la API REST.
Para que Dinaup lance el escenario a un ritmo fijo: Programar peticiones HTTP.