Saltar al contenido principal

Encuentra tu próxima herramienta

Documentación/Automatización/Make (Integromat): escenarios con MaxScanner
Automatización

Make (Integromat): escenarios con MaxScanner

Usa los módulos HTTP y Webhooks de Make para convertir, comprimir y aplicar OCR a archivos con MaxScanner dentro de cualquier escenario.

Respuesta breve

En Make, añade el módulo HTTP "Make a request" con el método POST, la URL https://maxscanner.app/api/v1/jobs/, un encabezado Authorization: Bearer <key>, body type Raw y content type JSON. Guarda la clave en una conexión o un data store de Make, no en campos normales de módulos que compartes con otras personas. Para la finalización, crea un escenario con Webhooks "Custom webhook" y suscribe su URL a processing.completed.

Inicio rápido

  1. 1Crea una clave de API de MaxScanner llamada "Make".
  2. 2Añade HTTP → Make a request: POST https://maxscanner.app/api/v1/jobs/, encabezados Authorization e Idempotency-Key, cuerpo JSON con url, filename, format. Activa "Parse response".
  3. 3Crea un escenario aparte que empiece con Webhooks → Custom webhook y copia la dirección del webhook.
  4. 4Suscribe la dirección una sola vez con POST /api/v1/hooks/subscribe/ (evento processing.completed).
  5. 5En el escenario del webhook, añade HTTP → Make a request: GET {{data.statusUrl}} con el encabezado Authorization y pasa output.downloadUrl al módulo siguiente.

Cuerpo de la solicitud

Asigna a Idempotency-Key un valor único por elemento, como el ID de registro del bundle, para que volver a ejecutar un escenario fallido no cree trabajos duplicados.

{
  "url": "{{1.attachment.url}}",
  "filename": "{{1.attachment.name}}",
  "format": "pdf"
}

Sondeo dentro de un mismo escenario

Si un webhook no es una opción, añade un módulo Sleep (5–10 segundos) y un Repeater con un router que se detenga cuando status sea completed o failed. Esto consume más operaciones y solicitudes de MaxScanner que el patrón con webhook, así que resérvalo para volúmenes bajos.

Gestión de errores

Añade un gestor de errores al módulo HTTP: Break con reintentos automáticos para las respuestas 429 y 5xx, e Ignore o Rollback para las respuestas 4xx que requieren una corrección. Make muestra el código de error de MaxScanner en la salida del módulo.

Preguntas frecuentes

¿Puedo enviar el binario de un archivo en lugar de una URL?

Sí: llama a /extension/upload/ para obtener una URL firmada, haz PUT del binario con un segundo módulo HTTP y usa el objectKey devuelto como sourceKey.

Guías relacionadas