Airtable

En Airtable, una automatización puede analizar el adjunto de un registro en cuanto se sube: la acción Run a script envía la URL del adjunto a Constaia como file_url y escribe el veredicto y los datos extraídos en campos del mismo registro.

RequisitosCopy Anchor Link

• Una base de Airtable con permisos para crear automatizaciones.
• Una clave de test ck_test_… del panel. Consulta Autenticación.
• Una tabla, por ejemplo Solicitudes, con estos campos:

Crear la automatizaciónCopy Anchor Link

const API_KEY = "ck_test_..."; // ver "Seguridad" más abajo
const table = base.getTable("Solicitudes");
const { recordId } = input.config();

const record = await table.selectRecordAsync(recordId);
const attachments = record?.getCellValue("Documento") ?? [];

if (attachments.length === 0) {
  output.set("status", "sin_documento");
} else {
  const attachment = attachments[0];
  const res = await fetch("https://api.constaia.com/v1/analyze", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      file_url: attachment.url,
      filename: attachment.filename,
      options: {
        expect: ["es_dni", "es_nie", "passport"],
        checks: { min_age_years: 18 },
        language: "es",
        metadata: { airtable_record_id: recordId },
      },
    }),
  });
  const analysis = await res.json();

  if (!res.ok) {
    const e = analysis.error;
    await table.updateRecordAsync(recordId, { Veredicto: "error", Motivos: `${e.code}: ${e.message} (${e.request_id})` });
    throw new Error(e.message);
  }

  const verdict = analysis.verdict;
  const number = analysis.fields.document_number ?? analysis.fields.nie_number;
  await table.updateRecordAsync(recordId, {
    Veredicto: verdict ? verdict.status : analysis.status,
    Motivos: (verdict?.reasons ?? [])
      .filter((r) => r.severity !== "info")
      .map((r) => r.message)
      .join("\n"),
    "Nº documento": number?.value ?? "",
    "ID análisis": analysis.id,
  });
  output.set("status", verdict?.status ?? analysis.status);
}

Documentos largos: async y webhookCopy Anchor Link

Los scripts de automatización tienen un tiempo máximo de ejecución. Para PDFs de muchas páginas, envía "async": true en las opciones: la API responde 202 al momento y te avisa por webhook al terminar.

1. Crea otra automatización con el disparador When webhook received y registra su URL en el panel o con POST /v1/webhook-endpoints (ver Webhooks).
2. Airtable no permite verificar la firma HMAC del evento, así que no te fíes de su contenido: en un Run a script, toma data.id del cuerpo, comprueba que empieza por an_, vuelve a leer el análisis con GET https://api.constaia.com/v1/analyses/{id} y tu clave, y actualiza el registro indicado en metadata.airtable_record_id de esa respuesta.
3. Constaia reintenta las entregas fallidas: si el registro ya tiene veredicto, no hagas nada.

No uses keep_results: false en este flujo, o la relectura devolverá 404.

Probar en modo testCopy Anchor Link

Con una clave ck_test_… no se consumen créditos y la respuesta depende del nombre del fichero (filename). Sube como adjunto cualquier imagen real con uno de estos nombres:

Más escenarios en Modo test.

SeguridadCopy Anchor Link

• La clave queda escrita en el script y cualquiera con permisos de creador en la base puede verla. Usa claves ck_live_… solo en bases con acceso restringido, no en bases compartidas con externos ni en plantillas. Si no puedes restringir el acceso, haz que el script llame a un backend tuyo que guarde la clave.
• Monta y prueba la automatización con una clave de test.
• Airtable guarda los datos que escribes en el registro y el adjunto original. Escribe solo los campos que necesites. Constaia borra su copia del fichero al terminar con storage: "none" (por defecto); ver 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 importas muchos registros de golpe y se disparan muchas automatizaciones, puedes recibir 429 con Retry-After. Ver Límites de uso y, para cargas masivas, lotes.

Siguientes pasosCopy Anchor Link