Dinaup DocsZapier, 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. La conexión se hace con las dos piezas estándar que traen las tres plataformas: un disparador por webhook, que recibe los avisos de Dinaup, y un módulo HTTP, que llama 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. Cómo se obtienen: API REST: cómo funciona.
- Para recibir avisos, la app Desarrollo de Play. Ver Webhooks Salientes.
Recibir avisos de Dinaup en un escenario
Crea el disparador en la plataforma
Añade un disparador de tipo webhook (Webhook en Zapier y n8n, Custom webhook en Make) y copia la URL que te da.
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. Con ese ejemplo mapeas los campos en los pasos siguientes del escenario.
Responde 2xx en el disparador. Un escenario que tarda más de 30 segundos en confirmar cuenta como fallo, y Dinaup lo intenta hasta 3 veces en total.
Llamar a la API desde el escenario
En el módulo HTTP de la plataforma, cada petición 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 {} |
| 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 |
Los parámetros, los cuerpos y las respuestas están en Referencia de la API REST. Un rechazo del servidor de tu empresa llega con su código 4xx, que la plataforma no repite como un fallo temporal. Un 500 en writeoperations puede ser un registro que el servidor no pudo guardar: revisa el motivo del cuerpo antes de repetir una escritura.
n8n paso a paso
Crea una credencial Header Auth
En Credentials, pulsa Add credential y elige Header Auth.
Rellena la credencial
En Name escribe Authorization. En Value escribe Bearer seguido del token. Ponle un nombre que identifique la empresa y pulsa Save.
Añade un nodo HTTP Request
En Authentication elige Generic Credential Type, en Generic Auth Type elige Header Auth y selecciona la credencial. Escribe el método y la URL del endpoint, con la URL de tu empresa.
Ejecuta el nodo
Pulsa Test step. Con un informe, la salida trae data con las filas; añade un nodo Split Out sobre data para tratar cada fila como un elemento.
Relacionado
- Programar peticiones HTTP: que Dinaup llame a la URL del escenario cada cierto tiempo.
- Cloudflare Worker: un intermediario para guardar el token fuera de la plataforma o adaptar el formato de las peticiones.