🚀 Intégration automatisée entre une plateforme d’appels (JobPhoning) et noCRM.io

🧠 Contexte du projet

Dans le cadre d’un projet d’automatisation commerciale, j’ai développé une intégration permettant de synchroniser automatiquement les données issues d’une plateforme d’appels sortants (type JobPhoning) avec le CRM noCRM.io.

L’objectif était simple :

Lorsqu’un téléopérateur marque un appel comme “Projet détecté”, une opportunité se crée automatiquement dans le CRM, sans action manuelle.

Ce projet m’a permis de travailler sur :

• La gestion et la validation de webhooks entrants en PHP,
• Le traitement et nettoyage de données JSON complexes,
• L’écriture de fichiers CSV de suivi,
• Et l’intégration via API REST vers noCRM.io.

---

🧩 Architecture technique

🔸 1. Webhook PHP

La plateforme d’appels envoie une requête HTTP POST contenant un JSON complet vers un script PHP :

https://example.com/jobphoningtonocrm/receive_json.php

Le webhook reçoit des structures JSON de ce type :

{
  "Client": {
    "Nom": "Dupont",
    "Societe": "Entreprise Test",
    "TelephoneFixe": "+33123456789"
  },
  "HistoriqueAppel": [
    {
      "Etat": "Projet détecté",
      "DateAppel": "2025-07-02 15:00:00",
      "Teleoperateur": { "Login": "Yohan" },
      "Commentaire": "Client intéressé par un devis."
    }
  ]
}

Le script a pour rôle de :

1. Lire la requête et enregistrer les données brutes,
2. Enregistrer tous les appels dans un CSV global (webhook_output_all.csv),
3. Enregistrer uniquement les projets détectés dans un autre CSV (webhook_output_projet_detecte.csv),
4. Déclencher la création d’un lead dans noCRM.io lorsque Etat = "Projet détecté".

---

🔸 2. Traitement et stockage des données

Les données sont nettoyées, formatées et enrichies avant écriture.
Chaque ligne du CSV représente un appel et contient :

| timestamp | ip | client_id | nom | societe | siret | adresse | ville | code_postal | activité | téléphone | email | état_appel | durée | date_appel | téléopérateur | commentaire |

Les fichiers CSV servent de :

• Journal d’audit pour retracer chaque appel,
• Source de secours en cas d’erreur réseau,
• Support de monitoring pour le suivi d’intégration.

---

🔸 3. Intégration avec l’API noCRM.io

Dès qu’un appel est identifié comme “Projet détecté”, le script envoie une requête POST à l’API noCRM.io :

POST https://example.nocrm.io/api/v2/leads

Authentification :

X-API-KEY: [masquée]

Corps de la requête :

{
  "title": "Entreprise Test",
  "description": "Client : M. Dupont - Téléphone : +33123456789 - Commentaire : Client intéressé",
  "tags": ["Projet détecté", "JobPhoning"],
  "step": "Infos OK"
}

Résultat : une opportunité apparaît automatiquement dans le pipeline “Infos OK” du CRM, associée au commercial correspondant.

---

⚙️ Stack et environnement

Élément	Description
Langage	PHP 8.2
Serveur	Nginx + PHP-FPM (Debian)
Authentification API	X-API-KEY (clé noCRM.io)
Format de stockage	CSV
Journalisation	Logs détaillés avec IP et horodatage
Sécurité	Validation JSON + filtrage d’adresses IP JobPhoning

---

🧪 Tests & validation

Pour valider la bonne intégration, j’ai utilisé cURL pour simuler les requêtes envoyées par la plateforme d’appels :

curl -X POST https://example.com/jobphoningtonocrm/receive_json.php \
  -H "Content-Type: application/json" \
  -d '{
    "Client": {"Nom": "Dupont", "Societe": "Entreprise Test"},
    "HistoriqueAppel": [{"Etat": "Projet détecté"}]
  }'

✅ Résultats attendus :

• webhook_output_all.csv → enregistrement complet,
• webhook_output_projet_detecte.csv → ajout du lead,
• Création automatique d’une opportunité CRM visible dans noCRM.io.

---

📈 Résultat final

Avant : Les téléopérateurs notaient manuellement les prospects détectés et les commerciaux les saisissaient ensuite dans le CRM.
Après : Les appels “Projet détecté” sont automatiquement transformés en opportunités en temps réel.

⏱ Temps de traitement : moins d’une seconde entre la fin de l’appel et l’apparition dans noCRM.io.

Ce projet a permis :

• Un gain de productivité significatif,
• Une meilleure traçabilité des appels,
• Et une intégration fiable sans tâche manuelle.

---

🧰 Exemple de code (extrait simplifié)

if (mb_strtolower($appel['Etat']) === 'projet détecté') {
    $leadData = [
        'title' => $client['Societe'] ?? 'Prospect',
        'description' => sprintf(
            "Nom: %s\nTéléphone: %s\nCommentaire: %s",
            $client['Nom'] ?? '',
            $client['TelephoneFixe'] ?? '',
            $appel['Commentaire'] ?? ''
        ),
        'tags' => ['Projet détecté', 'JobPhoning'],
        'step' => 'Infos OK'
    ];

    $ch = curl_init('https://example.nocrm.io/api/v2/leads');
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            "X-API-KEY: [masquée]",
            "Content-Type: application/json"
        ],
        CURLOPT_POSTFIELDS => json_encode($leadData),
        CURLOPT_SSL_VERIFYPEER => true
    ]);

    $response = curl_exec($ch);
    curl_close($ch);
}

---

🔗 Ressources et code source

• 🧱 Code complet sur GitHub :
  https://github.com/dtrabelsi/Int-gration-JobPhoning-noCRM.io
• 🌐 Mon portfolio développeur :
  https://dhaker-trabelsi.com
• 🧰 Technos clés :
  PHP · REST API · JSON · Webhooks · cURL · Automation · noCRM.io API

---

💬 Conclusion

Ce projet illustre une intégration temps réel entre un outil de prospection et un CRM, permettant de :

• Automatiser la conversion des leads qualifiés,
• Centraliser les informations de contact,
• Et fluidifier le passage entre équipes marketing et commerciales.

Une automatisation simple, robuste et efficace — entièrement réalisée en PHP natif et API REST.

---