Transmission des leads

Ce kit présente un exemple minimal fonctionnel permettant de transmettre un lead à un programme via l'API Adlead.

Périmètre

• Envoi d'un lead généré sur l'un de vos sites ou formulaires vers un programme du CRM
• Authentification par clé API
• Échanges en JSON (Content-Type: application/json, Accept: application/json)
• Exemples en PHP natif (cURL) et Laravel

Ce guide n’aborde pas les cas avancés ni la totalité des champs disponibles. Pour ces sujets, se référer à la documentation API complète.

Points clés

Clé API et Tenant
Les valeurs $tenantKey et $apiKey sont fournies par Adlead lors de l'ouverture des accès API.
Une clé API est une clé secrète qui ne doit jamais être visible dans du code accessible côté client.

Résultat attendu Succès : code HTTP 200 OK et success: true. Erreur : code HTTP différent de 200 ou success: false.

Exemples d'implémentation

<?php
// Vérification basique de cURL
if (!function_exists('curl_version')) {
    die("Erreur : L’extension cURL n’est pas installée sur ce serveur.");
}

// Configuration (fournie avec vos accès API)
$tenantKey  = 'xxxxxxxxxxxx';
$apiKey     = 'xxxxxxxxxxxx';
$programId  = 0;

$endpoint = "https://api.adlead.immo/v1/{$tenantKey}/programs/{$programId}/leads";

// Données simulées (à remplacer par vos valeurs réelles ou champs de formulaire)
$payload = [
    'contact' => [
        "name" => "Dupont",
        "firstname" => "Jean",
        "email1" => "jean.dupont@gmail.com",
        "phone1" => "0600000000",
        "zipcode" => "75001",
        "optin_email" => true,
        "optin_sms" => true
    ],
    'lead' => [
        "request_type" => "information",
        "project" => "investment",
        "message" => "Bonjour, je cherche à investir en IDF.",
        "tracking_origin" => "landing",
        "tracking_source" => "google",
        "tracking_medium" => "cpc",
        "tracking_campaign" => "relance-140925"
    ],
];

// Requête cURL
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "Accept: application/json",
        "X-API-Key: " . $apiKey,
    ],
    CURLOPT_POST            => true,
    CURLOPT_POSTFIELDS      => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_SSL_VERIFYPEER  => false, // Nécessaire si votre environnement de développement ne dispose pas d’un certificat SSL valide
    CURLOPT_RETURNTRANSFER  => true,
    CURLOPT_TIMEOUT         => 10,
]);

$return = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error    = curl_error($ch);
curl_close($ch);

$response = json_decode($return, true);

if($httpCode !== 200 || !isset($response['success']) || !$response['success']) {
    echo "❌ Erreur lors de la transmission du lead.";
    var_dump($response);
    var_dump($return);
    exit;
}

echo "✅ Lead transmis avec succès";
echo "<pre>" . print_r($response, true) . "</pre>";

<?php
use Illuminate\Support\Facades\Http;

// Configuration - Fournie à l'ouverture des accès API
$tenantKey  = 'xxxxxxxxxxxx';
$apiKey     = 'xxxxxxxxxxxx';
$programId  = 0;

$endpoint = "https://api.adlead.immo/v1/{$tenantKey}/programs/{$programId}/leads";

// Données simulées (à remplacer par vos valeurs réelles ou champs de formulaire)
$payload = [
    'contact' => [
        "name" => "Dupont",
        "firstname" => "Jean",
        "email1" => "jean.dupont@gmail.com",
        "phone1" => "0600000000",
        "zipcode" => "75001",
        "optin_email" => true,
        "optin_sms" => true
    ],
    'lead' => [
        "request_type" => "information",
        "project" => "investment",
        "message" => "Bonjour, je cherche à investir en IDF.",
        "tracking_origin" => "landing",
        "tracking_source" => "google",
        "tracking_medium" => "cpc",
        "tracking_campaign" => "relance-140925"
    ],
];

// Appel API
$response = Http::withHeaders([
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
    'X-API-Key'    => $apiKey,
])->timeout(10)->post($endpoint, $payload);

// Réponse minimale (même logique que ton natif: code + success)
if (!$response->ok() || ($response->json('success') !== true)) {
    echo "❌ Erreur lors de la transmission du lead.";
    echo "<pre>" . print_r(json_decode($response->body()), true) . "</pre>";
    exit();
}

echo "✅ Lead transmis avec succès.";
echo "<pre>" . print_r(json_decode($response->body()), true) . "</pre>";