Rellena las plantillas de contactos antes de importar

4 de octubre de 2026

Las plantillas de contactos conservan sus cabeceras al previsualizarlas sin filas de datos. POST /v1/contacts/import/preview devuelve 200 con total=0, rows=[] y source_headers en el orden del origen; dry_run=true se comporta igual.

Descarga la plantilla, escribe tus contactos, sube el archivo rellenado y revisa la correspondencia de columnas antes de aplicarlo. El CSV descargado usa UTF-8 con BOM y comas. Si conviertes la plantilla a XLSX, conserva sus cabeceras originales.

POST /v1/contacts/import rechaza un archivo sin filas de datos con HTTP 422, business_rule_violation, subcódigo empty_import y parámetro file. No se crea un registro de importación ni se encola trabajo. Rellena la plantilla y vuelve a intentarlo.

Ambas operaciones siguen requiriendo contacts:write. MCP preview_contacts_import e import_contacts mantienen la misma distinción entre previsualizar y aplicar.