Débarras — Lead MVP

📚 Documentation API

Webhooks pour Lead MVP

📥 Webhook Entrant

URL : http://77.42.28.212:8088/api/leads
Méthode : POST | Auth : Aucune

Champs requis : first_name, last_name, phone

Champs optionnels : email, devis_id (UNIQUE), agence_id, agence_name

curl -X POST http://77.42.28.212:8088/api/leads \
  -d "first_name=Marie" \
  -d "last_name=Martin" \
  -d "phone=0612345678" \
  -d "devis_id=25546665" \
  -d "agence_id=96"

📱 Dédoublonnage par téléphone (fenêtre 3 mois)

Si un lead avec le même phone existe et a moins de 90 jours, le pipeline n’est pas relancé. La réponse reste HTTP 200 avec le flag duplicate_phone: true (pas d’erreur côté appelant). Au-delà de 90 jours, le client est considéré comme nouveau → nouveau lead créé + pipeline normal.

Le blocage est tracé dans la timeline du lead existant (visible dans Admin → Leads).

{
  "status": "success",
  "message": "Numero deja traite recemment - pipeline non relance",
  "lead_id": "<UUID du lead existant>",
  "devis_id": "<nouveau devis_id soumis>",
  "phone": "+33612345678",
  "duplicate_phone": true,
  "existing_created_at": "2026-03-12T08:15:42"
}

🛑 Webhook Stop Relance

URL : http://77.42.28.212:8088/api/webhook/stop-relance
Méthode : POST | Auth : Aucune

Quand l'appeler ? Client a pris RDV ou signé le devis

Champ requis : devis_id

Action : Change statut → "converted" + annule relances R1/R2/R3

curl -X POST http://77.42.28.212:8088/api/webhook/stop-relance \
  -d "devis_id=25546665"

Lead MVP — Documentation API

27/02/2026