Seguiment i resultats íntegres d’importacions de contactes
Previsualitza fitxers de contactes, consulta resultats confirmats per fila i descarrega informes d’errors autoritzats.
3 d’octubre de 2026
Les importacions de contactes ofereixen una referència consultable, resultats parcials per fila i un informe d’errors. Les actualitzacions conserven els camps omesos; bank_accounts omès conserva els comptes i [] els esborra. Les noves importacions consumeixen la quota mensual de files del pla; les acceptades amb l’exempció anterior la conserven.
Les noves admissions comparteixen plan-limits.bulk_import_rows_per_month. Les files aplicades create/update/add_role consumeixen quota. Les importacions de contactes admeses amb l’exempció anterior la conserven. Les reserves concurrents impedeixen superar el límit. El rebuig ocorre abans d’escriure o encuar: HTTP 429 import_row_quota_exceeded, tipus rate_limit_error. La quota de files és independent dels bytes emmagatzemats i del límit de peticions.
contacts:read és necessari per consultar i descarregar; import i preview exigeixen contacts:write. Un identificador aliè, inexistent o d’un altre mòdul retorna el mateix 404 import_not_found. Sense scope es retorna 403 insufficient_scope. No s’exposen company_id, identificadors interns ni enllaços anònims.
La resposta síncrona usa el progrés persistit: status, failure_reason i els quatre comptadors coincideixen amb GET. total conserva el nombre de registres d’origen; rows i les categories inclouen només files confirmades, amb result applied/skipped/failed. Un tancament concurrent pot retornar HTTP 200 amb status: failed i unprocessed_count > 0; les files pendents no es presenten com aplicades. Preview/dry-run tenen status: null i ometen result; queued usa status: queued. Els codis 200/202 descrits corresponen a HTTP; MCP retorna el mateix payload JSON.
L’informe respecta la retenció de 90 dies. Si falta el CSV o l’emmagatzematge no permet llegir-lo, es reconstrueix des del ledger sense escriure un altre fitxer. L’estat deixa d’anunciar l’informe quan venç la retenció.
- Previsualitzar una importació de contactes
- Importar contactes
- Consultar una importació de contactes
- Descarregar errors d’importació
Nous endpoints2
| Endpoint | Descripció |
|---|---|
GET/v1/contacts/imports/{id} | Consultar una importació de contactes |
GET/v1/contacts/imports/{id}/errors.csv | Descarregar errors d’importació de contactes |
Endpoints actualitzats2
| Endpoint | Descripció |
|---|---|
POST/v1/contacts/import/preview | Previsualitzar una importació de contactes |
POST/v1/contacts/import | Importar contactes |