Documentation utilisateur

Retour configuration

Guide Utilisateur Prospekt

1. Objectif

Prospekt est une application interne de prospection B2B.
Elle aide a:

  • importer des entreprises,
  • enrichir les donnees,
  • proposer/valider des prospects,
  • preparer les messages d'outreach,
  • exporter vers Odoo.

Important:

  • LinkedIn n'est pas scrape automatiquement.
  • La validation des profils LinkedIn reste manuelle.

2. Prise en main rapide

Parcours recommande:

  1. Ouvrir le Dashboard.
  2. Verifier l'etat des services.
  3. Passer les services en marche si necessaire.
  4. Aller dans Configuration et lancer le pipeline.
  5. Traiter la file Validation.
  6. Suivre les actions dans Outreach.
  7. Exporter depuis Export Odoo.

3. Ecrans principaux

  • Dashboard: KPI globaux + etat ON/OFF des services.
  • Entreprises: liste des comptes importes.
  • Carte: vue geographique des entreprises geocodees.
  • Validation: qualification et validation des prospects.
  • Outreach: suivi kanban des interactions.
  • Pipeline: historique d'execution des jobs.
  • Export Odoo: export CSV et push Odoo.
  • Configuration: filtres pipeline + zone dangereuse (reset donnees).

4. Interrupteur Services (ON/OFF)

Le Dashboard contient un controle global:

  • Demarrer tous les services
  • Arreter tous les services

Effet:

  • Si OFF: les jobs manuels et periodiques ne s'executent pas.
  • Si ON: les jobs peuvent etre lances normalement.

Toujours verifier cet etat avant de depanner un pipeline.

5. Workflow operateur recommande

Etape A - Lancer l'acquisition

  1. Ouvrir Configuration.
  2. Choisir departements / codes NAF / effectif.
  3. Lancer le pipeline.
  4. Verifier les executions dans Pipeline.

Etape B - Valider les prospects

  1. Ouvrir Validation.
  2. Filtrer par score/statut.
  3. Verifier le contact suggere.
  4. Coller une URL LinkedIn valide, puis Valider.
  5. Sinon passer en mode Pas de LinkedIn si necessaire.

Etape C - Executer l'outreach

  1. Ouvrir Outreach.
  2. Utiliser le kanban pour suivre chaque etape.
  3. Logger les evenements (invite, reponse, rendez-vous, etc.).

Etape D - Export

  1. Ouvrir Export Odoo.
  2. Generer le CSV.
  3. Optionnel: push direct vers Odoo si configure.

6. Reference Jobs

| Job | Role principal | Quand l'utiliser | Sortie attendue | |---|---|---|---| | ingest_companies | Import entreprises | Debut pipeline | Nouvelles entreprises | | resolve_domains | Trouver domaines web | Apres ingestion | Domaine + confiance | | enrich_companies | Enrichissement web public | Apres domaine | Signaux + resume | | resolve_linkedin_profiles | Aider la resolution profil | En support validation | URLs suggerees | | build_contact_strategy | Generer personas/cibles | Apres enrichissement entreprise | Strategie contact | | enrich_contact_data | Completer donnees contact | Apres strategie | Email/phone/noms nettoyes | | generate_descriptions | Description structuree | Apres validation | Description prospect | | generate_messages | Messages LinkedIn | Apres validation | Invite + message + relance | | generate_email_messages | Messages email-only | Si pas de LinkedIn | Sujet/corps email | | enrich_lead_scores | Scoring LLM | Priorisation | Score plus fin | | export_odoo_csv | Export CRM | Fin de cycle | CSV Odoo | | push_to_odoo | Push direct Odoo | Fin de cycle | Leads crees dans Odoo | | cleanup_stale_jobs | Housekeeping | Automatique | Jobs bloques marques failed |

7. Carte Entreprises

La carte affiche les entreprises geocodees.

Points importants:

  • une adresse incomplete peut empecher le placement sur la carte;
  • le geocodage est mis en cache local pour accelerer les chargements suivants;
  • cliquer un marqueur ouvre la fiche entreprise.

8. Zone dangereuse (Reset Data)

Dans Configuration, la zone dangereuse permet de purger les donnees operationnelles.

Suppression inclut notamment:

  • entreprises et pages,
  • prospects et outreach,
  • jobs, exports, audit.

Confirmation obligatoire:

  • saisir exactement delete avant de valider.

9. Depannage rapide

"Le pipeline ne fait rien"

  • verifier services ON sur Dashboard;
  • verifier Pipeline pour voir les jobs en echec;
  • verifier la configuration des filtres.

"Aucun prospect exportable"

  • verifier que les prospects sont valides;
  • verifier le statut email/LinkedIn;
  • relancer generation messages si necessaire.

"La carte est vide"

  • verifier que les entreprises ont des adresses exploitables;
  • verifier la cle Google Maps;
  • recharger apres premier geocodage/caching.

10. Checklist quotidienne

  1. Verifier services ON.
  2. Verifier les jobs en erreur.
  3. Lancer pipeline si besoin.
  4. Traiter les prospects a valider.
  5. Suivre les colonnes outreach critiques.
  6. Exporter les prospects qualifies.
  7. Arreter les services si fenetre de production terminee.