Genera un plugin WordPress que sincroniza formularios con Airtable
Airtable es la hoja compartida para equipos que ya superan una hoja de cálculo pero no están para base de datos o CRM completos. A la gente no técnica le encanta editar ahí, y todo equipo acaba queriendo que los envíos WordPress aterricen en Airtable automáticos. La API de Airtable perdona poco con tipos de campo: un link a otra tabla espera record IDs, un adjunto espera URL que Airtable pueda descargar, un select exige la etiqueta exacta.
Un plugin Airtable generado maneja las rarezas de cada tipo. Usamos la API v0 con Personal Access Token (Airtable deprecó la legacy API key en 2024), respetamos el límite de 5 req/s por base y encolamos cada envío para que los posts de formulario nunca esperen a Airtable.
¿Por qué generarlo en vez de instalar un plugin existente?
Airtable se alió con Make (ex Integromat) como recomendación oficial, más Zapier y Pipedream. Geniales para flujos interactivos. Sync WP → Airtable automatizado por ellos cuesta 20-50€/mes con volumen, y cada envío viaja por los servidores del conector.
Un plugin directo son 200 líneas de PHP. Pagas solo el hosting, controlas los logs y el payload es exactamente lo que tu base espera. Sin intermediario que a veces empuja test records no relacionados al lanzar features.
Los adjuntos Airtable son un gotcha clásico. La API quiere URL pública accesible. Un plugin que guarda uploads en tu /uploads/ y pasa la URL pública a Airtable Just Works. Los conectores lo complican.
Prompt de ejemplo
Este es el tipo de descripción que genera este plugin. Puedes partir de aquí y ajustar lo que necesites antes de generar.
Nombre del plugin: Acme Airtable Sync
API: Airtable v0 con Personal Access Token (PAT).
Mapeo:
- Formulario "Project brief" (Fluent Forms ID 7) → base "Client Projects" (appXXX), tabla "Inbound".
- Name (Single line text) ← "name"
- Email (Email) ← "email"
- Company ← "company"
- Budget (Single select: "<5k", "5-20k", ">20k") ← "budget"
- Needs (Multiple select) ← "needs"
- Attachments ← "brief_file" (subido por Fluent Forms a /uploads/)
- Source (Single select) ← "Website form" hardcoded
- Created (Date) ← timestamp actual
Por envío:
1. Guardar archivo en /uploads/acme-airtable/ con nombre aleatorio.
2. POST a https://api.airtable.com/v0/appXXX/Inbound con la URL pública del adjunto.
3. Loguear record ID al éxito.
Rate limit: 5 req/s por base.
Admin: PAT, base ID, tabla, UI mapeo.
Sin tablas propias.Qué suele incluir el plugin generado
- Cliente Airtable v0 con wp_remote_post y Bearer
- Conversor consciente de tipo (text, number, select, multi-select, attachment, date, checkbox)
- Handler de adjuntos que guarda public y pasa URL
- Rate limiter 5 req/s por base
- Upsert idempotente vía external_id para evitar duplicados
- Log últimos 50 syncs con record IDs
- UI admin validando labels de select contra schema en vivo
Linked records, awareness de campos formula, vistas por usuario — todo posible. Describe schema y el plugin lo respeta.
Preguntas frecuentes
¿Y el rate limit?
Airtable permite 5 req/s por base. El plugin encola picos y drena a ese ritmo. Con envíos ocasionales no lo tocas.
¿Cómo maneja adjuntos?
Archivos en tu /uploads/ y Airtable recibe la URL pública. Airtable los descarga asincrónicamente. Si tu sitio está tras firewall, Airtable no llega — en ese caso sube a S3 y pasa URL S3.
¿Puedo sincronizar envíos antiguos?
Sí. Comando WP-CLI que recorre envíos desde una fecha y los replica. Idempotente.
¿Funciona con cualquier plugin de formulario?
De caja: Contact Form 7, WPForms, Gravity Forms, Fluent Forms. Para otros, pasa el hook "after submission" y lo cableamos.