Make (Integromat): cenários com o MaxScanner
Use os módulos HTTP e Webhooks do Make para converter, comprimir e aplicar OCR em arquivos com o MaxScanner dentro de qualquer cenário.
Resposta curta
No Make, adicione o módulo HTTP "Make a request" com método POST, URL https://maxscanner.app/api/v1/jobs/, um cabeçalho Authorization: Bearer <key>, body type Raw e content type JSON. Guarde a chave em uma conexão ou data store do Make, não em campos comuns de módulos compartilhados com outras pessoas. Para a conclusão, crie um cenário com Webhooks "Custom webhook" e inscreva a URL dele em processing.completed.
Início rápido
- 1Crie uma chave de API do MaxScanner chamada "Make".
- 2Adicione HTTP → Make a request: POST https://maxscanner.app/api/v1/jobs/, cabeçalhos Authorization e Idempotency-Key, corpo JSON com url, filename, format. Ative "Parse response".
- 3Crie um cenário separado que comece com Webhooks → Custom webhook e copie o endereço do webhook.
- 4Inscreva o endereço uma vez com POST /api/v1/hooks/subscribe/ (evento processing.completed).
- 5No cenário do webhook, adicione HTTP → Make a request: GET {{data.statusUrl}} com o cabeçalho Authorization e passe output.downloadUrl para o próximo módulo.
Corpo da requisição
Mapeie Idempotency-Key para algo único por item, como o ID de registro do bundle, para que executar de novo um cenário com falha não crie jobs duplicados.
{
"url": "{{1.attachment.url}}",
"filename": "{{1.attachment.name}}",
"format": "pdf"
}Polling dentro de um único cenário
Se um webhook não for uma opção, adicione um módulo Sleep (5–10 segundos) e um Repeater com um router que pare quando status for completed ou failed. Isso consome mais operações e requisições do MaxScanner do que o padrão com webhook, então reserve-o para volumes baixos.
Tratamento de erros
Associe um error handler ao módulo HTTP: Break com novas tentativas automáticas para respostas 429 e 5xx, e Ignore ou Rollback para respostas 4xx que precisam de correção. O Make mostra o código de erro do MaxScanner na saída do módulo.
Perguntas frequentes
Posso enviar o binário do arquivo em vez de uma URL?
Sim: chame /extension/upload/ para obter uma URL assinada, faça PUT do binário com um segundo módulo HTTP e use o objectKey retornado como sourceKey.