Zapier

Zapier no necesita un conector propio para usar Constaia: la acción Webhooks by Zapier envía la petición a la API y el disparador Catch Hook recibe los eventos. Si el fichero no está en una URL descargable, Code by Zapier lo puede convertir a base64.

RequisitosCopy Anchor Link

• Una cuenta de Zapier con acceso a Webhooks by Zapier (y a Code by Zapier si usas la opción con código). Consulta qué incluye tu plan.
• Una clave de test ck_test_… del panel. Consulta Autenticación.
• Un paso anterior que aporte el documento: un adjunto de Gmail, un fichero de Google Drive, un formulario (Typeform, Jotform…). Zapier suele exponer los ficheros como una URL https:// descargable.

Opción 1: Webhooks by Zapier con file_urlCopy Anchor Link

{
  "file_url": "https://files.example.com/uploads/dni.jpg",
  "filename": "dni.jpg",
  "options": {
    "expect": ["es_dni", "es_nie", "passport"],
    "checks": { "min_age_years": 18, "holder": { "full_name": "María García López" } },
    "language": "es",
    "metadata": { "source": "zapier" }
  }
}

Opción 2: Code by Zapier (base64)Copy Anchor Link

Si el paso anterior no te da una URL que Constaia pueda descargar (por ejemplo, requiere tu sesión), descarga el fichero en un paso Code by Zapier → Run JavaScript y envíalo como file_base64.

En Input Data define file_url (el fichero del paso anterior), file_name y api_key, y usa:

const file = await fetch(inputData.file_url);
if (!file.ok) throw new Error(`No se pudo descargar el fichero: ${file.status}`);
const base64 = Buffer.from(await file.arrayBuffer()).toString("base64");

const res = await fetch("https://api.constaia.com/v1/analyze", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${inputData.api_key}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    file_base64: base64,
    filename: inputData.file_name,
    options: { expect: "payment_receipt", checks: { expected_amount: 45 } },
  }),
});

const analysis = await res.json();
if (!res.ok) {
  throw new Error(`${analysis.error.code}: ${analysis.error.message} (${analysis.error.request_id})`);
}

return {
  id: analysis.id,
  status: analysis.status,
  verdict: analysis.verdict?.status ?? null,
  reasons: (analysis.verdict?.reasons ?? []).map((r) => r.message).join(" | "),
  amount: analysis.fields.amount?.value ?? null,
};

Devuelve solo lo que usarán los pasos siguientes. Los pasos de código tienen un tiempo máximo de ejecución que depende del plan de Zapier; si tus documentos son PDFs largos o el análisis se acerca a ese límite, usa async: true y recibe el resultado por webhook.

Probar en modo testCopy Anchor Link

Con una clave ck_test_… no se consumen créditos y la respuesta depende del nombre del fichero (el fichero tiene que ser un JPEG, PNG, WEBP, HEIC o PDF real). En el cuerpo JSON fija "filename" a uno de estos nombres:

Para la opción 2 prueba con payment_receipt.pdf y expected_amount: 45. Todos los escenarios en Modo test.

Recibir eventos con Catch HookCopy Anchor Link

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

SeguridadCopy Anchor Link

• Nunca pegues una clave ck_live_… en Zaps compartidos o en plantillas. Quien pueda editar el Zap puede ver las cabeceras y los Input Data.
• Monta y prueba el Zap con una clave de test; cámbiala por la live al activarlo.
• Zapier guarda los datos de cada ejecución en el historial de Zaps. Tenlo en cuenta con documentos de identidad. 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); ante un 429 respeta Retry-After. Para muchos ficheros a la vez usa lotes. Ver Límites de uso.

Siguientes pasosCopy Anchor Link