Carica e analizza un file VCard
POST/api/partner-gateway/v1/contacts/upload/vcard
Carica un file VCard (.vcf) e importa le sue voci come contatti nel tuo account. Il file deve essere inviato come multipart/form-data, con il file nel campo 'file' e il nome originale del file (deve avere estensione .vcf) nel campo 'fileName'. I file VCard possono contenere una o più voci di contatto. Ogni voce vCard viene analizzata e mappata a un record contatto usando i campi vCard standard (FN, TEL, EMAIL, ecc.). L'importazione viene eseguita in modalità CREATE_UPDATE: i nuovi contatti vengono creati e i contatti esistenti (individuati tramite numero di telefono) vengono aggiornati con i dati della VCard. Se viene fornito un listId, tutti i contatti importati correttamente vengono aggiunti automaticamente a quella lista contatti. Il parametro limit controlla quanti contatti analizzati vengono restituiti nell'anteprima della risposta (predefinito 10), ma non limita il numero effettivo di contatti importati. Questo endpoint è particolarmente utile per importare contatti esportati da rubriche telefoniche, Outlook, Google Contacts o altri strumenti CRM che supportano lo standard VCard. Restituisce 400 se il file non ha estensione .vcf o non è un file VCard valido. Restituisce 500 se si verifica un errore imprevisto del server durante l'elaborazione dell'importazione.
Richiesta
Risposte
- 200
- 400
- 500
File VCard importato: conteggi dei contatti aggiunti, aggiornati e non riusciti
File non valido o tipo di file non supportato (solo .vcf consentito)
Errore interno del server