Plateforme - Fichier CSV / Excel | PINPO Academy

Qu'est-ce que l'importation au format CSV/Excel via la plateforme des prospects/leads/contacts ?

Vous pouvez envoyer votre fichier CSV/Excel via notre API.
Les prospects seront immédiatement importés dans Pinpo.
Veuillez noter que la limite quotidienne de prospects activés définie sur la plateforme reste applicable.

Comment réaliser l'importation au format CSV/Excel via API des prospects/leads/contacts ?

Se rendre sur la section “Intégrations" (bandeau latéral gauche).
Sélectionner la section “CSV” , puis cliquer sur le bouton “Accéder” .
Récupérer le fichier d’exemple.
Remplissez le fichier en faisant bien attention aux différentes spécificités de chaque colonnes.
<aside>
💡
Conseil : N’oubliez pas de bien précisiez si ceci sont des qualifications de tests ou non (true ou false)
</aside>
<aside>
💡
Conseil : LA focntoin
</aside>
Agent

Colonne	Description	Obligatoire	Format	Exemple
`agent.id`	Identifiant unique de l'agent IA auquel le lead sera assigné	✅ Oui	UUID	`123e4567-e89b-12d3-a456-426614174001`

ℹ️ - Vous pouvez retrouver l’agent.id de l’agent désiré en vous rendant sur la section “Agents” (bandeau latéral gauche), puis en cliquant sur le crayon.

Contact

Colonne	Description	Obligatoire	Format	Exemple
`contact.firstname`	Prénom du contact	Non	Texte libre	`John`
`contact.lastname`	Nom de famille du contact	Non	Texte libre	`Doe`
`contact.phone`	Numéro de téléphone mobile du contact	⚠️ Oui*	Format international avec indicatif pays	`+33606060606`
`contact.whatsAppUserId`	Identifiant WhatsApp du contact	⚠️ Oui*	Identifiant WhatsApp	`user.9373795779eb6441c8adb2eaee5b848e7dd174ddd302d7db62142f4722d574b6`
`contact.mail`	Adresse e-mail du contact	Non	E-mail valide	`[email protected]`
`contact.externalId`	Identifiant du contact dans votre CRM (si différent de l'ID du lead)	Non	Texte libre	`contact-789`
`contact.gender`	Genre du contact	Non	`male`, `female`, `other` ou `unknown`	`male`

*⚠️ Au moins un des deux champs contact.phone ou contact.whatsAppUserId est requis pour chaque ligne. Si aucun des deux n'est renseigné, la ligne sera rejetée à l'import.

Commercial (Salesperson)

Colonne	Description	Obligatoire	Format	Exemple
`salesperson.firstname`	Prénom du commercial assigné au lead	Non	Texte libre	`Michelle`
`salesperson.lastname`	Nom du commercial assigné au lead	Non	Texte libre	`Scott`
`salesperson.phone`	Numéro de téléphone du commercial	Non	Format international avec indicatif pays	`+33707070707`
`salesperson.mail`	Adresse e-mail du commercial	Non	E-mail valide	`[email protected]`
`salesperson.externalId`	Identifiant du commercial dans votre CRM	Non	Texte libre	`sales-456`
`salesperson.gender`	Genre du commercial	Non	`male`, `female`, `other` ou `unknown`	`female`
`salesperson.iCalUrl`	URL iCal du calendrier du commercial (utilisée pour vérifier ses disponibilités lors de la prise de rendez-vous)	Non	URL iCal valide	`https://michelle.scott.dundermifflin.ical.fr`

Qualification

Colonne	Description	Obligatoire	Format	Exemple
`qualification.externalId`	Identifiant externe du lead dans votre CRM ou système source	Non	Texte libre	`ext-123456`
`qualification.source`	Source d'origine du lead (canal ou campagne d'acquisition)	Non	Texte libre	`Facebook leads`
`qualification.test`	Marquer le lead comme lead de test (ne sera pas traité dans le flux normal de qualification)	Non	`true` ou `false`	`true`

Champs personnalisés (Custom Fields)

Les champs personnalisés permettent d'enrichir vos leads avec des données propres à votre activité. Ajoutez autant de colonnes que nécessaire en utilisant le préfixe qualification.customFields. suivi du nom exact du champ configuré dans votre espace Pinpo.

Colonne	Description	Obligatoire	Format	Exemple
`qualification.customFields.city`	Ville du lead	Non	Texte libre	`Paris`
`qualification.customFields.country`	Pays du lead	Non	Texte libre	`France`
`qualification.customFields.budget`	Budget du lead	Non	Texte libre ou numérique	`500000`
`qualification.customFields.[votre champ]`	Tout autre champ personnalisé de votre choix	Non	Texte libre	—

💡 Important : les noms de champs personnalisés sont sensibles à la casse. qualification.customFields.City et qualification.customFields.city sont considérés comme deux champs différents. Vérifiez l'orthographe exacte dans les paramètres de votre espace.

Enregistrer votre fichier.
Importer votre fichier.

<aside>
ℹ️

En cas d’erreur, vous retrouver ligne par ligne la raison pour laquelle la qualification n’a pas été importée.

</aside>

💡 RAPPEL :

Règle #1 : Lorsque vous confiez un lead/prospect/contact à votre agent PINPO, le lead est importé immédiatement et le 1ᵉʳ message est envoyé immédiatement*.

Il vous incombe d'envoyer le prospect au moment opportun.
*Par défaut, pour les prospects reçus par PINPO tard dans la nuit ou tôt le matin, le premier message est reporté au lendemain matin (ce comportement peut être personnalisé).
</aside>

Agent