Make

En Make (antes Integromat) llamas a Constaia con el módulo HTTP → Make a request, repartes el resultado con un Router según el veredicto y recibes eventos asíncronos con Webhooks → Custom webhook. No hace falta ningún conector específico.

RequisitosCopy Anchor Link

• Una cuenta de Make con un escenario.
• Una clave de test ck_test_… del panel. Consulta Autenticación.
• Un módulo anterior que entregue el fichero (Google Drive Download a file, adjunto de Gmail, Dropbox, un formulario…). En Make, los ficheros se pasan como file name + data.

Analizar un documentoCopy Anchor Link

{
  "expect": "medical_certificate_sport",
  "checks": { "max_age_days": 365, "require_signature": true, "require_stamp": true },
  "language": "es",
  "metadata": { "source": "make" }
}

Alternativa: cuerpo JSONCopy Anchor Link

Si tienes una URL https:// descargable del fichero, cambia Body type a Raw, Content type a JSON (application/json) y usa como Request content:

{
  "file_url": "https://files.example.com/receipts/123.pdf",
  "filename": "payment_receipt.pdf",
  "options": {
    "expect": "payment_receipt",
    "checks": { "expected_amount": 45, "expected_reference": "INSCRIPCION 123" }
  }
}

file_url debe ser https, sin IPs privadas, con un máximo de 20 MB y 15 s de descarga. filename es opcional y sustituye al nombre que Constaia deduce de la URL.

Probar en modo testCopy Anchor Link

Con una clave ck_test_… no se consumen créditos y la respuesta depende del nombre del fichero. En Make puedes fijar el File name del campo file a mano, por ejemplo dni_valid.jpg, dni_expired.jpg o blurry.jpg, aunque el contenido sea otra imagen (tiene que ser un JPEG, PNG, WEBP, HEIC o PDF real). En JSON, usa "filename": "dni_valid.jpg".

Con esos tres nombres pruebas todas las rutas del Router. Más escenarios en Modo test.

Recibir eventos por webhookCopy Anchor Link

El módulo Webhooks → Custom webhook te da una URL a la que Constaia envía los eventos. Make no ofrece una forma nativa de verificar la firma HMAC de Standard Webhooks sobre el cuerpo crudo, así que la integración segura consiste en no fiarte del contenido del evento y volver a leer el recurso con tu clave.

curl https://api.constaia.com/v1/webhook-endpoints \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://hook.eu1.make.com/…","events":["analysis.completed","analysis.failed"]}'

SeguridadCopy Anchor Link

• No pegues una clave ck_live_… en escenarios que compartas o exportes como blueprint: la cabecera viaja con el módulo. Limita quién puede ver y editar el escenario y, si tu plan de Make ofrece conexiones o claves guardadas para el módulo HTTP, guárdala ahí.
• Usa una clave de test mientras montas el escenario y cámbiala por la live solo al activarlo.
• Make guarda los datos de cada ejecución en el historial. Si procesas documentos de identidad, revisa la retención de datos del escenario. Más en Almacenamiento y privacidad.

LímitesCopy Anchor Link

• 20 MB por fichero; PDFs de hasta 30 páginas en síncrono y hasta 200 con async: true.
• 2 peticiones por segundo por clave en el plan gratuito (10 en el de pago). Si un iterador lanza muchas peticiones seguidas, puedes recibir 429 con Retry-After; añade una pausa (módulo Sleep) o usa lotes. Ver Límites de uso.

Siguientes pasosCopy Anchor Link