Make (Integromat): scenari con MaxScanner
Usa i moduli HTTP e Webhooks di Make per convertire, comprimere ed eseguire l'OCR dei file con MaxScanner all'interno di qualsiasi scenario.
Risposta breve
In Make, aggiungi il modulo HTTP "Make a request" con metodo POST, URL https://maxscanner.app/api/v1/jobs/, un header Authorization: Bearer <key>, body type Raw e content type JSON. Conserva la chiave in una connessione o in un data store di Make, non in campi del modulo in chiaro condivisi con altri. Per il completamento, crea uno scenario Webhooks "Custom webhook" e sottoscrivi il suo URL a processing.completed.
Guida rapida
- 1Crea una chiave API MaxScanner chiamata "Make".
- 2Aggiungi HTTP → Make a request: POST https://maxscanner.app/api/v1/jobs/, header Authorization e Idempotency-Key, corpo JSON con url, filename, format. Attiva "Parse response".
- 3Crea uno scenario separato che inizi con Webhooks → Custom webhook e copia l'indirizzo del webhook.
- 4Sottoscrivi l'indirizzo una sola volta con POST /api/v1/hooks/subscribe/ (evento processing.completed).
- 5Nello scenario del webhook, aggiungi HTTP → Make a request: GET {{data.statusUrl}} con l'header Authorization, poi passa output.downloadUrl al modulo successivo.
Corpo della richiesta
Mappa Idempotency-Key su un valore univoco per ogni elemento, come l'ID del record del bundle, così rieseguire uno scenario non riuscito non crea job duplicati.
{
"url": "{{1.attachment.url}}",
"filename": "{{1.attachment.name}}",
"format": "pdf"
}Polling all'interno di un solo scenario
Se un webhook non è un'opzione, aggiungi un modulo Sleep (5–10 secondi) e un Repeater con un router che si ferma quando status è completed o failed. Questo approccio consuma più operazioni e più richieste MaxScanner rispetto allo schema con webhook, quindi riservalo ai volumi bassi.
Gestione degli errori
Collega un gestore degli errori al modulo HTTP: Break con tentativi automatici per le risposte 429 e 5xx, e Ignore o Rollback per le risposte 4xx che richiedono una correzione. Make mostra il codice di errore di MaxScanner nell'output del modulo.
Domande frequenti
Posso inviare il file in binario invece di un URL?
Sì: chiama /extension/upload/ per ottenere un URL firmato, carica il binario con PUT tramite un secondo modulo HTTP, poi usa l'objectKey restituito come sourceKey.