Documentation technique d’intégration des leads

Cette documentation a pour objectif d’aider les courtiers et leurs fournisseurs de leads à transmettre des leads de manière fiable, propre et compatible avec AssurElite Network.

1. Objectif de l’intégration

L’intégration permet à un fournisseur de leads d’envoyer directement des prospects dans votre CRM via une URL d’insertion. Chaque lead transmis doit contenir les informations nécessaires pour être exploitable commercialement et respecter les exigences minimales de qualité et de consentement.

Les leads envoyés via cette intégration sont destinés à alimenter automatiquement la table leads de votre espace.

2. Informations importantes avant intégration

  • Le fournisseur doit transmettre des données exactes, exploitables et à jour.
  • Le prospect doit avoir donné son consentement pour être contacté.
  • Les champs obligatoires doivent toujours être renseignés.
  • L’URL doit être testée avant mise en production.
  • Les caractères spéciaux dans l’URL doivent être correctement encodés.
Une URL mal encodée ou incomplète peut empêcher l’enregistrement correct du lead.

3. À propos du champ admin_id

Le champ admin_id permet de rattacher le lead au bon espace client. Cet identifiant vous est envoyé par email lors de la création de votre compte.

Merci de vérifier votre boîte de réception ainsi que votre dossier Spam ou Courrier indésirable.

Si vous ne retrouvez pas cet email, vous pouvez contacter le support à l’adresse support@assurelitenetwork.com.

Bonne pratique recommandée : fournir au courtier une URL complète à copier-coller, déjà préremplie avec son identifiant d’intégration.

4. Champs attendus par le CRM

Champ Type Obligatoire Description
admin_id int Oui Identifiant de l’espace client auquel rattacher le lead.
type_assurance varchar(100) Oui Type de demande : Auto, Habitation, Santé, Moto, etc.
nom_prospect varchar(150) Oui Nom complet du prospect.
telephone varchar(20) Oui Numéro de téléphone du prospect avec indicatif si possible.
email varchar(150) Non Adresse email du prospect.
message text Non Détail libre sur le besoin, la demande ou le contexte.
marque_vehicule varchar(100) Non Champ utile pour les leads Auto ou Moto.
motif_resiliation varchar(255) Non Motif de résiliation éventuel de l’ancien contrat.
statut enum Non Le statut est généralement laissé par défaut à EN-ATTENTE.
rgpd_consentement tinyint(1) Oui Valeur attendue : 1 si le prospect a donné son consentement.
date_insertion datetime Non Générée automatiquement par le système.
Les champs id et date_insertion sont gérés automatiquement par la base de données.

5. Champs obligatoires minimum recommandés

Pour garantir un enregistrement correct et exploitable, l’URL doit au minimum transmettre :

  • admin_id
  • type_assurance
  • nom_prospect
  • telephone
  • rgpd_consentement=1

6. Exemple d’URL d’insertion

Exemple d’URL à transmettre à un fournisseur de leads. Les valeurs ci-dessous sont fournies à titre d’exemple et doivent être adaptées à votre configuration réelle.

https://assurelitenetwork.com/insert-lead.php?admin_id=99930002218812&type_assurance=Auto&nom_prospect=Karim%20Benali&telephone=%2B212612345678&email=karim.benali%40example.com&message=Recherche%20une%20assurance%20auto&marque_vehicule=Renault%20Clio&motif_resiliation=Tarif%20trop%20%C3%A9lev%C3%A9&rgpd_consentement=1

7. Exemple minimal recommandé

Si le fournisseur ne dispose pas de tous les champs, voici une version minimale compatible avec les champs obligatoires :

https://assurelitenetwork.com/insert-lead.php?admin_id=99930002218812&type_assurance=Auto&nom_prospect=Karim%20Benali&telephone=%2B212612345678&rgpd_consentement=1

8. Bonnes pratiques techniques

  • Utiliser l’encodage URL pour les espaces, accents et caractères spéciaux.
  • Toujours envoyer le téléphone dans un format exploitable, idéalement avec indicatif.
  • Limiter les valeurs de type_assurance à des libellés simples et cohérents.
  • Ne pas transmettre de lead sans consentement.
  • Tester l’URL avec un lead réel de test avant diffusion au fournisseur.
  • Éviter les doublons côté fournisseur lorsque cela est possible.

9. Recommandations métier

Pour améliorer la qualité des leads reçus, il est recommandé de demander au fournisseur :

  • un nom complet proprement renseigné ;
  • un téléphone joignable ;
  • un besoin formulé clairement ;
  • le type d’assurance exact ;
  • un consentement explicite du prospect.

10. En cas de difficulté

Si vous avez besoin de votre identifiant d’intégration, d’un test technique ou d’une validation de votre URL d’insertion, contactez notre support :

Email support : support@assurelitenetwork.com

Notre recommandation est de faire valider une première URL de test avant de lancer les envois en production avec votre fournisseur de leads.