Import CSV
CRMarket importe vos contacts depuis un fichier CSV, de façon asynchrone : vous lancez l'import, puis consultez un rapport (créés / mis à jour / ignorés) une fois le traitement terminé.
Il n'y a pas d'étape de mapping de colonnes. Les colonnes reconnues sont fixes (email, first_name, last_name) ; tout le reste devient automatiquement un attribut personnalisé sur le contact.
Deux façons d'importer
- Déposer un fichier : depuis Contacts, cliquez sur Importer un fichier CSV. Une page dédiée permet de glisser-déposer votre fichier ou de le sélectionner, affiche un aperçu des colonnes détectées, puis lance l'import.
- Coller le contenu : depuis Contacts, cliquez sur Coller du CSV directement pour coller le texte CSV dans un champ, sans passer par un fichier.
Les deux appellent le même traitement côté serveur.
Format du fichier
email,first_name,last_name,plan_type
alice@example.com,Alice,Dupont,premium
bob@example.com,Bob,Smith,free
- Encodage : UTF-8. Un BOM en tête de fichier (ajouté par Excel) est automatiquement retiré.
- Séparateur : virgule
,ou point-virgule;, détecté automatiquement en comparant leur nombre d'occurrences sur la première ligne. - Sans ligne d'en-tête : si la première ligne ne contient pas de colonne
email, le fichier est traité comme une simple liste de valeurs positionnelles (1 colonne = email seul, 2 = email + prénom, 3 ou plus = email + prénom + nom) — utile si vous collez juste une liste d'adresses. - Taille maximale : la requête HTTP est limitée à 8 Mo au total (corps JSON incluant le CSV). Il n'y a pas de limite de nombre de contacts séparée : au-delà de ~8 Mo, l'import est rejeté avant même d'être lancé.
Colonnes reconnues
Seuls ces trois noms de colonnes (insensibles à la casse) sont mappés vers des champs du contact :
| Colonne CSV | Champ CRMarket |
|-------------|-----------------|
| email | Adresse email (obligatoire) |
| first_name | Prénom |
| last_name | Nom de famille |
| Toute autre colonne | Attribut personnalisé, clé = nom de colonne en minuscules |
Il n'existe pas d'alias reconnus (firstname, lastname, phone, language… deviennent des attributs personnalisés, pas les champs correspondants). Une valeur vide pour une colonne donnée n'est pas stockée comme attribut pour cette ligne.
Comportement à l'import
- Une ligne sans email est ignorée, comptée dans le rapport final, jamais insérée.
- Aucune validation de format au-delà de "non vide" : une valeur qui n'a pas la forme d'une adresse email mais n'est pas vide est importée telle quelle.
- Upsert par email, dans votre organisation : si un contact avec le même email existe déjà, il est mis à jour plutôt que dupliqué.
La mise à jour remplace entièrement les attributs personnalisés du contact par ceux de la ligne CSV — elle ne les fusionne pas avec les attributs existants. Un attribut déjà présent sur le contact (ajouté par une autre source) et absent de votre fichier sera perdu si ce contact est ré-importé.
- Le statut d'abonnement n'est jamais modifié par une mise à jour : un contact déjà désinscrit qui apparaît dans votre fichier reste désinscrit — l'import ne le réabonne jamais silencieusement. Un contact nouvellement créé démarre toujours au statut "Inscrit" ; il n'y a pas de moyen d'importer un contact déjà désabonné.
- Aucune liste de destination : l'import crée/met à jour des contacts directement, sans les rattacher à une liste. Pour les ajouter à une liste, utilisez l'ajout à une liste depuis la fiche contact ou l'API après l'import.
Suivre un import
Après le lancement, l'import s'exécute en arrière-plan. La page d'upload interroge automatiquement le résultat et affiche le rapport dès qu'il est prêt :
- Lignes lues : nombre total de lignes de données du fichier
- Créés : nouveaux contacts
- Mis à jour : contacts existants (même email) mis à jour
- Ignorés : lignes sans email exploitable
Via l'API
POST /api/v1/contacts
Authorization: Bearer <token>
Content-Type: application/json
{
"email": "alice@example.com",
"first_name": "Alice",
"attributes": {
"plan_type": "premium"
}
}
Pour un import CSV par programme, envoyez le contenu du fichier directement :
POST /api/v1/contacts/import
Authorization: Bearer <token>
Content-Type: application/json
{ "csv_content": "email,first_name\nalice@example.com,Alice\n" }
La réponse (202 Accepted) contient un job_id. Récupérez le rapport avec :
GET /api/v1/contacts/import/:job_id
status vaut "completed" une fois le traitement terminé ; report contient alors les mêmes compteurs que ci-dessus.
Ne jamais importer des contacts sans leur consentement préalable. En France, l'article L.34-5 du CPCE exige un consentement explicite pour l'envoi d'emails marketing.