Documentation API Meetlane

Introduction

L'API Meetlane permet d'accéder aux fonctionnalités de la plateforme d'automatisation commerciale. Cette API utilise une authentification par token et retourne des données au format JSON.

Format des Réponses :

Toutes les réponses de l'API suivent un format standardisé incluant un indicateur de succès.

Rate Limiting :

L'API est limitée à 100 requêtes par minute par utilisateur pour garantir la stabilité du service.

Limitations importantes :

Les agents en pause (status: paused) peuvent être consultés via l'API mais aucune action d'écriture n'est autorisée. Ces actions retourneront une erreur HTTP 403 avec le message "Agent paused".

Les agents annulés (status: cancelled) peuvent être consultés via l'API mais aucune action d'écriture n'est autorisée (ajout de contacts, validation d'emails/courriers, etc.). Ces actions retourneront une erreur HTTP 403 avec le message "Agent cancelled".

Terminologie et compatibilité :

Meetlane utilise le terme "agent" dans toute son API pour désigner un agent commercial IA.

Par compatibilité technique, l'alias campaign_filter est également accepté mais agent_filter est recommandé.

Si les deux paramètres sont fournis, agent_filter est prioritaire.

Authentification

L'API utilise l'authentification par clé API. Vous devez créer une clé API depuis votre espace utilisateur, et l'utiliser dans vos requêtes d'une des façons suivantes.

Header Authorization : Authorization: Bearer YOUR_API_KEY

Paramètre URL : ?api_key=YOUR_API_KEY

Pour créer une clé API, rendez-vous sur votre espace puis dans la section "API", créez votre clé, et copiez la (elle ne sera affichée qu'une fois). Gardez votre clé API confidentielle et ne la partagez jamais publiquement.

Informations utilisateur

Récupère les informations de l'utilisateur connecté et la liste de ses agents (hors brouillons).

GET


                                                https://meetlane.ai/api/api/me

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/me', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/me');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "user": {
        "id": "aBc123Xy",
        "name": "Pierre Martin",
        "email": "pierre.martin@example.com",
        "created_at": "2024-01-15T10:30:00.000000Z"
    },
    "agents": [
        {
            "id": "dEf456Zw",
            "name": "Meetlane Commercial",
            "firstname": "Meetlane",
            "lastname": "Commercial",
            "status": "active",
            "internal_note": "B2B SaaS",
            "is_active": true,
            "language": "fr"
        },
        {
            "id": "gHi789Uv",
            "name": "Sophie Marketing",
            "firstname": "Sophie",
            "lastname": "Marketing",
            "status": "paused",
            "internal_note": null,
            "is_active": false,
            "language": "en"
        }
    ],
    "meta": {
        "total_agents": 2,
        "active_agents": 1
    }
}

Agents retournés :

Seuls les agents publiés sont retournés (status != draft)

Les brouillons ne sont pas inclus dans les résultats

Champs des agents :

internal_note : Note personnelle pour identifier l'agent (nullable, 20 caractères max)

is_active : true si status = "active"

Statuts d'agent disponibles :

active : Agent actif et opérationnel

paused : Agent en pause

setup : Agent en cours de configuration

inactive : Agent inactif

Liste des contacts

Récupère la liste des contacts avec pagination et filtres.

GET


                                                https://meetlane.ai/api/api/contacts

Paramètres

Nom	Type	Requis	Description
page	integer	Non	Numéro de page
per_page	integer	Non	Éléments par page (1-100)
search	string	Non	Recherche textuelle
status_filter	string	Non	Filtre par statut
source_filter	string	Non	Filtre par source
agent_filter	string	Non	ID hashé de l'agent (recommandé - alias campaign_filter accepté)
targeting_filter	string	Non	ID hashé du ciblage
sort_field	string	Non	Champ de tri
sort_direction	string	Non	Direction (asc/desc)
include_emails	boolean	Non	Inclure les emails
semantic_search	boolean	Non	Recherche par IA

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/contacts', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/contacts');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "data": [
        {
            "id": "aBc123Xy",
            "firstname": "Jean",
            "lastname": "Dupont",
            "companyname": "TechCorp SAS",
            "status": "nurture",
            "source": "linkedin_auto",
            "relevance": 8.5,
            "linkedin_url": "https://linkedin.com/in/jean-dupont",
            "picture": "https://example.com/avatar.jpg",
            "contacts": [
                {
                    "type": "email",
                    "value": "jean.dupont@techcorp.com",
                    "is_validated": true
                }
            ],
            "created_at": "2024-01-15T10:30:00.000000Z",
            "updated_at": "2024-01-20T14:45:00.000000Z",
            "agent": {
                "id": "dEf456Zw",
                "firstname": "Pierre",
                "lastname": "Martin",
                "language": "fr"
            },
            "agent_targeting": {
                "id": "gHi789Uv",
                "summary": "CMO Tech B2B France",
                "status": "active"
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 5,
        "per_page": 12,
        "to": 12,
        "total": 58
    },
    "filters_applied": {
        "search": "TechCorp",
        "status_filter": "nurture",
        "source_filter": null,
        "agent_filter": null,
        "targeting_filter": null,
        "sort_field": "created_at",
        "sort_direction": "desc",
        "semantic_search": false
    }
}

Statuts disponibles :

enrich : Leads en enrichissement

contact : Leads enrichis, prêts pour génération

validation : En attente de validation

nurture : En nurturing actif

won : Convertis en clients

lost : Perdus

later : À recontacter

noanswer : Séquence terminée sans réponse

Champs additionnels :

relevance : Score de pertinence (0-10, nullable)

linkedin_url : URL du profil LinkedIn (nullable)

picture : URL de la photo de profil (nullable)

agent_targeting : Ciblage LinkedIn associé (nullable)

Propriétés de touchpoints :

has_touchpoint_email : Email envoyé au lead (boolean)

has_touchpoint_email_answer : Lead a répondu par email (boolean)

has_touchpoint_letter : Courrier livré au lead (boolean)

has_touchpoint_letter_flash : QR code flashé par le lead (boolean)

has_returned_letter : Courrier retourné (NPAI/PND) (boolean)

Ajouter un contact LinkedIn manuel

Ajoute un contact LinkedIn manuellement à un agent pour enrichissement automatique et envoi d'emails/courriers personnalisés.

POST


                                                https://meetlane.ai/api/api/campaigns/{agent_id}/contacts

Paramètres

Nom	Type	Requis	Description
agent_id	string	Oui	ID hashé de l'agent (doit être en mode linkedin_manual)

Exemple de requête

curl -X POST "https://meetlane.ai/api/api/campaigns/{agent_id}/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "contact_unique_001",
    "linkedin_url": "https://www.linkedin.com/in/jean-dupont-marketing",
    "ai_context": "Rencontré lors de la conférence SaaS Paris 2024, intéressé par nos solutions d'automatisation commerciale et souhaite une démo"
}'

const response = await fetch('https://meetlane.ai/api/api/campaigns/{agent_id}/contacts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "identifier": "contact_unique_001",
      "linkedin_url": "https://www.linkedin.com/in/jean-dupont-marketing",
      "ai_context": "Rencontré lors de la conférence SaaS Paris 2024, intéressé par nos solutions d'automatisation commerciale et souhaite une démo"
  })
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/campaigns/{agent_id}/contacts');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);

$data = '{
    "identifier": "contact_unique_001",
    "linkedin_url": "https://www.linkedin.com/in/jean-dupont-marketing",
    "ai_context": "Rencontré lors de la conférence SaaS Paris 2024, intéressé par nos solutions d\'automatisation commerciale et souhaite une démo"
}';
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Contact added successfully",
    "data": {
        "contact": {
            "identifier": "contact_unique_001",
            "fields": {
                "identifier": "contact_unique_001",
                "linkedin_url": "https://www.linkedin.com/in/jean-dupont-marketing",
                "ai_context": "Rencontré lors de la conférence SaaS Paris 2024, intéressé par nos solutions d'automatisation commerciale et souhaite une démo"
            },
            "created_at": "2025-11-02T10:30:00.000000Z",
            "updated_at": "2025-11-02T10:30:00.000000Z"
        },
        "campaign": {
            "id": "aBc123Xy",
            "contacts_count": 26
        }
    }
}

Type d'agent : LinkedIn manuel uniquement (leads_sub_source_type = linkedin_manual)

Limitation importante :

Cet endpoint fonctionne UNIQUEMENT pour les agents avec leads_sub_source_type = linkedin_manual.

Les agents avec ciblage automatique (linkedin_auto) retourneront une erreur 400 "Manual contact addition not allowed".

Vérification préalable recommandée :

Avant d'ajouter des contacts, utilisez GET /api/campaigns/{agent_id}/settings pour :

Vérifier que can_add_contacts est à true

Récupérer la liste exacte des champs requis selon votre configuration

Comprendre quels champs sont utilisés dans vos emails/lettres

Champs obligatoires :

linkedin_url : URL complète du profil LinkedIn (format: https://www.linkedin.com/in/nom-prenom)

Champs optionnels :

identifier : Identifiant unique (auto-généré si vide)

ai_context : Contexte personnalisé complémentaire (recommandé)

Variables personnalisées selon la configuration de votre agent

Champ ai_context - Utilisation et fonctionnement :

Le champ ai_context est optionnel mais fortement recommandé. Voici comment il fonctionne :

1. Contexte automatique extrait du profil LinkedIn :

Meetlane extrait automatiquement du profil LinkedIn :

Poste actuel et entreprise

Parcours professionnel et expériences

Compétences et domaines d'expertise

Formation et diplômes

2. Votre contexte personnalisé (ai_context) :

Utilisez ce champ pour ajouter des informations spécifiques qui ne sont PAS sur le profil LinkedIn :

Contexte de rencontre (événement, conférence, recommandation)

Intérêts exprimés lors d'échanges directs

Besoins spécifiques identifiés

Notes de qualification commerciale

3. Fusion intelligente :

Votre contexte personnalisé sera fusionné avec les informations extraites du profil.

L'IA utilisera les deux sources pour générer des emails ultra-personnalisés.

Exemple concret :

Profil LinkedIn : "Directeur Marketing chez TechCorp, 10 ans d'expérience en SaaS B2B"

Votre ai_context : "Rencontré au salon BigData Paris, cherche solution d'automatisation"

Résultat : Email personnalisé mentionnant son poste + le contexte de rencontre + ses besoins

Gestion des crédits Meetlane :

Les contacts manuels LinkedIn consomment vos crédits contacts (leads_available_meetlane).

Si crédits disponibles : Traitement immédiat (dans les 30 min)

Si crédits insuffisants : Contacts ajoutés au sheet mais non traités

Les contacts en attente seront traités automatiquement lors du prochain rechargement de crédits

Traitement asynchrone :

Le contact passe par plusieurs étapes automatiques :

Ajout au sheet : Contact stocké avec vos informations (immédiat)

Enrichissement LinkedIn : Extraction du profil toutes les 30 min via all:leads-create-from-linkedin-manual-sheets

Recherche d'adresse : Localisation de l'adresse postale si envoi de courrier configuré

Création du Lead : Lead enrichi créé avec toutes les informations

Génération des messages : Emails/courriers personnalisés générés selon votre configuration

Le délai total entre l'ajout via API et la prise de contact peut être de 30 minutes maximum.

Ajout en masse :

Pour ajouter plusieurs contacts :

Effectuez une requête par contact

Rate limit : 100 requêtes par minute par utilisateur

Utilisez des identifiers uniques pour éviter les doublons

Champs dynamiques :

Si votre agent utilise des variables {custom} dans les emails/lettres, vous devez inclure les champs correspondants.

Utilisez GET /api/campaigns/{agent_id}/settings pour connaître tous les champs requis.

Gestion des erreurs de validation :

En cas d'erreur de validation (HTTP 422), la réponse inclut :

validation_errors : Objet avec chaque champ en erreur et son message explicite

missing_fields : Tableau des champs obligatoires manquants

invalid_fields : Tableau des champs présents mais invalides (format incorrect, etc.)

Exemple de réponse d'erreur :

{

"success": false,

"error": "Validation failed",

"message": "The provided contact data contains errors",

"validation_errors": {

"linkedin_url": "L'URL LinkedIn est obligatoire pour les campagnes LinkedIn"

},

"missing_fields": ["linkedin_url"],

"invalid_fields": []

}

Bloquer un contact

Bloque un contact et tous ses doublons, annule les contenus en attente et ajoute à la blocklist.

DELETE


                                                https://meetlane.ai/api/api/contacts/{leadId}/block

Paramètres

Nom	Type	Requis	Description
leadId	string	Oui	ID hashé du contact

Exemple de requête

curl -X DELETE "https://meetlane.ai/api/api/contacts/{leadId}/block" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/contacts/{leadId}/block', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/contacts/{leadId}/block');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Lead blocked successfully.",
    "data": {
        "lead_id": "aBc123Xy",
        "blocked_email": "contact@example.com",
        "duplicates_blocked": 2,
        "emails_cancelled": 1,
        "letters_cancelled": 0
    }
}

Actions automatiques :

Le contact et tous ses doublons (même email) sont bloqués

L'email est ajouté à votre blocklist

L'adresse postale est ajoutée à la blocklist si disponible

Tous les emails en attente (réponses et followups) sont annulés

Toutes les lettres en attente (avant génération) sont annulées

Retour :

duplicates_blocked : Nombre de doublons bloqués en plus du contact principal

emails_cancelled : Nombre d'emails annulés

letters_cancelled : Nombre de lettres annulées

Statistiques d'un agent

Récupère les statistiques de performance d'un agent.

GET


                                                https://meetlane.ai/api/api/agents/{agentId}/stats

Paramètres

Nom	Type	Requis	Description
agentId	string	Oui	ID hashé de l'agent
period	string	Non	Période d'analyse (7d, 14d, 30d, 60d, 90d, 120d, 180d, 365d)

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/agents/{agentId}/stats" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/agents/{agentId}/stats', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/agents/{agentId}/stats');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "agent": {
        "id": "aBc123Xy",
        "firstname": "Pierre",
        "lastname": "Martin"
    },
    "period": "30d",
    "stats": {
        "sent": {
            "current": 45,
            "previous": 38,
            "change": {
                "value": 18.4,
                "trend": "up",
                "display": "+18.4%"
            },
            "label": "Messages envoyés"
        },
        "received": {
            "current": 32,
            "previous": 25,
            "change": {
                "value": 28,
                "trend": "up",
                "display": "+28.0%"
            },
            "label": "Messages reçus"
        },
        "leads_won": {
            "current": 3,
            "previous": 2,
            "change": {
                "value": 50,
                "trend": "up",
                "display": "+50.0%"
            },
            "label": "Leads gagnés"
        },
        "response_rate": {
            "current": 26.7,
            "label": "Taux de réponse (%)"
        },
        "lead_rate": {
            "current": 6.7,
            "label": "Taux de conversion (%)"
        },
        "relevance": {
            "current": 7.8,
            "label": "Pertinence moyenne"
        }
    }
}

Endpoints disponibles:

/api/agents/{agentId}/stats (recommandé pour Meetlane)

/api/campaigns/{agentId}/stats (alias fonctionnel pour compatibilité)

Liste des emails

Récupère les emails de tous vos agents.

GET


                                                https://meetlane.ai/api/api/emails

Paramètres

Nom	Type	Requis	Description
category	string	Non	Catégorie d'emails
page	integer	Non	Numéro de page
per_page	integer	Non	Éléments par page
search	string	Non	Recherche textuelle
semantic_search	boolean	Non	Recherche par IA
agent_filter	string	Non	ID hashé de l'agent (recommandé - alias campaign_filter accepté)

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/emails" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/emails', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/emails');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Catégories disponibles :

received : Emails reçus

sent : Emails envoyés

to_handle : À traiter

interested : Prospects intéressés

not_interested : Non intéressés

neutral : Neutres

block : À bloquer

auto_reply : Réponses automatiques

antispam : Antispam

unattributed : Non attribués

Emails en attente de validation

Récupère la liste des emails de prise de contact en attente de validation.

GET


                                                https://meetlane.ai/api/api/emails/to-validate

Paramètres

Nom	Type	Requis	Description
page	integer	Non	Numéro de page
per_page	integer	Non	Éléments par page (1-100)
agent_filter	string	Non	ID hashé de l'agent (recommandé - alias campaign_filter accepté)

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/emails/to-validate" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/emails/to-validate', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/emails/to-validate');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "data": [
        {
            "id": "aBc123Xy",
            "type": "lead",
            "lead_name": "Jean Dupont",
            "company": "TechCorp",
            "email": "jean.dupont@techcorp.com",
            "agent": {
                "id": "dEf456Zw",
                "name": "Pierre Martin"
            },
            "subject": "Votre solution d'automatisation",
            "status": "pending_validation",
            "created_at": "2024-01-15T10:30:00.000000Z",
            "has_custom_messages": true
        }
    ],
    "meta": {
        "current_page": 1,
        "total": 58
    }
}

Réponses email à traiter

Récupère la liste des réponses email en attente de traitement.

GET


                                                https://meetlane.ai/api/api/emails/to-handle

Paramètres

Nom	Type	Requis	Description
page	integer	Non	Numéro de page
per_page	integer	Non	Éléments par page (1-100)
agent_filter	string	Non	ID hashé de l'agent (recommandé - alias campaign_filter accepté)

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/emails/to-handle" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/emails/to-handle', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/emails/to-handle');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "data": [
        {
            "id": "gHi789Uv",
            "type": "email_received",
            "lead_id": "jKl012Mn",
            "lead_name": "Marie Durand",
            "company": "Innovation SA",
            "email": "marie@innovation.com",
            "agent": {
                "id": "dEf456Zw",
                "name": "Pierre Martin"
            },
            "subject": "Re: Votre proposition",
            "status": "to_handle",
            "received_at": "2024-01-20T14:45:00.000000Z",
            "sentiment": "positive",
            "intent": "interested",
            "summary": "Le prospect souhaite plus d'informations",
            "relevance": 8.5,
            "answer": {
                "body": "Bonjour Marie, voici les informations...",
                "type": "ai_generated"
            },
            "actions": {
                "validate": "https://meetlane.ai/api/emails/validate-response/gHi789Uv",
                "skip": "https://meetlane.ai/api/emails/skip-response/gHi789Uv"
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 3,
        "per_page": 25,
        "to": 25,
        "total": 72
    }
}

Valider une prise de contact

Valide une prise de contact email pour envoi automatique.

POST


                                                https://meetlane.ai/api/api/emails/validate/{leadId}

Paramètres

Nom	Type	Requis	Description
leadId	string	Oui	ID hashé du lead
custom_messages	object	Non	Messages personnalisés

Exemple de requête

curl -X POST "https://meetlane.ai/api/api/emails/validate/{leadId}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_messages": {
        "subject": "Sujet personnalisé",
        "emails": [
            {
                "body": "Contenu personnalisé"
            }
        ]
    }
}'

const response = await fetch('https://meetlane.ai/api/api/emails/validate/{leadId}', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "custom_messages": {
          "subject": "Sujet personnalisé",
          "emails": [
              {
                  "body": "Contenu personnalisé"
              }
          ]
      }
  })
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/emails/validate/{leadId}');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);

$data = '{
    "custom_messages": {
        "subject": "Sujet personnalisé",
        "emails": [
            {
                "body": "Contenu personnalisé"
            }
        ]
    }
}';
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Lead validated successfully - will be sent automatically in 60min",
    "data": {
        "lead_id": "aBc123Xy",
        "scheduled_validate_at": "2024-01-22T11:30:00.000000Z",
        "validation_delay_minutes": 60
    }
}

Délai de carence :

Le lead sera validé définitivement après 60 minutes.

Pendant ce délai, vous pouvez encore le refuser.

Personnalisation optionnelle :

Vous pouvez modifier les messages personnalisés en passant un objet custom_messages.

Refuser une prise de contact

Refuse une prise de contact email.

POST


                                                https://meetlane.ai/api/api/emails/reject/{leadId}

Paramètres

Nom	Type	Requis	Description
leadId	string	Oui	ID hashé du lead

Exemple de requête

curl -X POST "https://meetlane.ai/api/api/emails/reject/{leadId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/emails/reject/{leadId}', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/emails/reject/{leadId}');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Lead rejected successfully - will be deleted automatically in 60min",
    "data": {
        "lead_id": "aBc123Xy",
        "scheduled_delete_at": "2024-01-22T11:30:00.000000Z",
        "validation_delay_minutes": 60
    }
}

Délai de carence :

Le lead sera supprimé définitivement après 60 minutes.

Pendant ce délai, vous pouvez encore le valider.

Valider une réponse email

Valide ou modifie une réponse email générée par l'IA pour envoi automatique.

POST


                                                https://meetlane.ai/api/api/emails/validate-response/{emailId}

Paramètres

Nom	Type	Requis	Description
emailId	string	Oui	ID hashé de l'email reçu
content	string	Non	Contenu personnalisé de la réponse (optionnel)
cc	email	Non	Email en copie pour transfert (optionnel)

Exemple de requête

curl -X POST "https://meetlane.ai/api/api/emails/validate-response/{emailId}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Merci pour votre intérêt. Voici les informations complémentaires...",
    "cc": "commercial@entreprise.com"
}'

const response = await fetch('https://meetlane.ai/api/api/emails/validate-response/{emailId}', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "content": "Merci pour votre intérêt. Voici les informations complémentaires...",
      "cc": "commercial@entreprise.com"
  })
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/emails/validate-response/{emailId}');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);

$data = '{
    "content": "Merci pour votre intérêt. Voici les informations complémentaires...",
    "cc": "commercial@entreprise.com"
}';
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Email response saved successfully - waiting to be sent",
    "data": {
        "email_id": "gHi789Uv",
        "answer_status": "waiting",
        "cc_added": true
    }
}

Paramètres optionnels :

Si content n'est pas fourni, utilise la réponse IA existante

Si cc est fourni, le lead est automatiquement marqué comme gagné (status: won)

Statuts de réponse :

waiting : En attente d'envoi automatique

La réponse sera envoyée par la commande meetlane:emails-send-replies

Type de réponse :

ai_validated : Si la réponse IA est conservée

manual : Si le contenu a été modifié

Ignorer une réponse email

Ignore une réponse email générée par l'IA sans y répondre.

POST


                                                https://meetlane.ai/api/api/emails/skip-response/{emailId}

Paramètres

Nom	Type	Requis	Description
emailId	string	Oui	ID hashé de l'email reçu

Exemple de requête

curl -X POST "https://meetlane.ai/api/api/emails/skip-response/{emailId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/emails/skip-response/{emailId}', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/emails/skip-response/{emailId}');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Email response skipped successfully",
    "data": {
        "email_id": "gHi789Uv",
        "answer_status": "skipped"
    }
}

Utilisation :

Marque l'email comme traité sans envoyer de réponse.

Utile pour les emails qui ne nécessitent pas de réponse (auto-reply, antispam, etc.).

Liste des courriers

Récupère les courriers de tous vos agents.

GET


                                                https://meetlane.ai/api/api/letters

Paramètres

Nom	Type	Requis	Description
category	string	Non	Catégorie de courriers
page	integer	Non	Numéro de page
per_page	integer	Non	Éléments par page (1-100)
search	string	Non	Recherche textuelle
agent_filter	string	Non	ID hashé de l'agent (recommandé - alias campaign_filter accepté)

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/letters" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/letters', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/letters');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "data": [
        {
            "id": "aBc123Xy",
            "lead_id": "dEf456Zw",
            "lead_name": "Jean Dupont",
            "company_name": "TechCorp SAS",
            "format": "a6",
            "status": "delivered",
            "status_label": "Livré",
            "tracking_code": "BATCH-20240115-abc123",
            "content_preview": "Bonjour Jean, je vous contacte...",
            "has_qr_code": true,
            "qr_code_scanned": true,
            "qr_code_scanned_at": "2024-01-20T14:30:00.000000Z",
            "qr_code_scan_count": 3,
            "is_returned": false,
            "is_printed": false,
            "printed_at": null,
            "sent_at": "2024-01-16T09:00:00.000000Z",
            "delivered_at": "2024-01-18T14:30:00.000000Z",
            "scheduled_at": null,
            "address": {
                "line1": "TechCorp SAS",
                "line2": "Jean Dupont",
                "line3": "123 rue de Rivoli",
                "zip": "75001",
                "city": "Paris",
                "country": "FRANCE"
            },
            "agent": {
                "id": "gHi789Uv",
                "firstname": "Pierre",
                "lastname": "Martin"
            },
            "created_at": "2024-01-15T10:30:00.000000Z",
            "updated_at": "2024-01-20T14:45:00.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 3,
        "per_page": 25,
        "to": 25,
        "total": 72
    }
}

Catégories disponibles :

to_validate : Courriers en attente de validation

validated : Courriers validés en attente d'envoi

rejected : Courriers refusés en attente de suppression

error : Courriers en erreur

insufficient_funds : Courriers en attente de crédits

in_preparation : Courriers en génération, impression ou attente d'envoi

transiting : Courriers en transit postal

delivered : Courriers délivrés

returned : Courriers retournés (NPAI/PND)

scanned : Courriers avec QR code flashé

not_scanned : Courriers avec QR code non flashé

Statuts disponibles :

validating : En attente de validation utilisateur

generating : En cours de génération des visuels

printing : En attente d'impression

sending : En attente d'envoi

transiting : En transit chez la poste

delivered : Livré

returned : Retourné (NPAI/PND)

cancelled : Annulé

error : Erreur technique

Courriers en attente de validation

Récupère la liste des courriers en attente de validation.

GET


                                                https://meetlane.ai/api/api/letters/to-validate

Paramètres

Nom	Type	Requis	Description
page	integer	Non	Numéro de page
per_page	integer	Non	Éléments par page (1-100)
agent_filter	string	Non	ID hashé de l'agent (recommandé - alias campaign_filter accepté)

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/letters/to-validate" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/letters/to-validate', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/letters/to-validate');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "data": [
        {
            "id": "aBc123Xy",
            "lead_id": "dEf456Zw",
            "lead_name": "Jean Dupont",
            "company_name": "TechCorp SAS",
            "format": "a6",
            "status": "validating",
            "tracking_code": "BATCH-20240115-abc123",
            "content_preview": "Bonjour Jean, je vous contacte...",
            "has_qr_code": true,
            "agent": {
                "id": "gHi789Uv",
                "firstname": "Pierre",
                "lastname": "Martin"
            },
            "address": {
                "line1": "TechCorp SAS",
                "line2": "Jean Dupont",
                "line3": "123 rue de Rivoli",
                "zip": "75001",
                "city": "Paris",
                "country": "FRANCE"
            },
            "created_at": "2024-01-15T10:30:00.000000Z",
            "autovalidated_at": null,
            "actions": {
                "validate": "https://meetlane.ai/api/letters/validate/aBc123Xy",
                "reject": "https://meetlane.ai/api/letters/reject/aBc123Xy"
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 2,
        "per_page": 12,
        "to": 12,
        "total": 23
    }
}

Valider un courrier

Valide un courrier pour envoi automatique.

POST


                                                https://meetlane.ai/api/api/letters/validate/{letterId}

Paramètres

Nom	Type	Requis	Description
letterId	string	Oui	ID hashé du courrier
blocks	array	Non	Blocs de contenu personnalisés

Exemple de requête

curl -X POST "https://meetlane.ai/api/api/letters/validate/{letterId}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "blocks": [
        {
            "id": "block_123",
            "content": "Contenu personnalisé"
        }
    ]
}'

const response = await fetch('https://meetlane.ai/api/api/letters/validate/{letterId}', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "blocks": [
          {
              "id": "block_123",
              "content": "Contenu personnalisé"
          }
      ]
  })
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/letters/validate/{letterId}');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);

$data = '{
    "blocks": [
        {
            "id": "block_123",
            "content": "Contenu personnalisé"
        }
    ]
}';
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Letter validated successfully - will be sent automatically in 60min",
    "data": {
        "letter_id": "aBc123Xy",
        "scheduled_validate_at": "2024-01-22T11:30:00.000000Z",
        "validation_delay_minutes": 60
    }
}

Délai de carence :

Le courrier sera validé définitivement après 60 minutes.

Pendant ce délai, vous pouvez encore le refuser.

Personnalisation optionnelle :

Vous pouvez modifier les blocs de contenu en passant un tableau blocks.

Chaque bloc doit avoir un id et un content.

Refuser un courrier

Refuse un courrier.

POST


                                                https://meetlane.ai/api/api/letters/reject/{letterId}

Paramètres

Nom	Type	Requis	Description
letterId	string	Oui	ID hashé du courrier

Exemple de requête

curl -X POST "https://meetlane.ai/api/api/letters/reject/{letterId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/letters/reject/{letterId}', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/letters/reject/{letterId}');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Letter rejected successfully - will be deleted automatically in 60min",
    "data": {
        "letter_id": "aBc123Xy",
        "scheduled_delete_at": "2024-01-22T11:30:00.000000Z",
        "validation_delay_minutes": 60
    }
}

Délai de carence :

Le courrier sera supprimé définitivement après 60 minutes.

Pendant ce délai, vous pouvez encore le valider.

Liste de blocage

Récupère la liste de blocage.

GET


                                                https://meetlane.ai/api/api/blocklist

Paramètres

Nom	Type	Requis	Description
type	string	Non	Type de blocage (email, domain, company, siren, address, all)
page	integer	Non	Numéro de page
per_page	integer	Non	Éléments par page

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/blocklist" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/blocklist', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/blocklist');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "data": [
        {
            "id": "aBc123Xy",
            "type": "email",
            "value": "spam@example.com",
            "created_at": "2024-01-15T10:30:00.000000Z",
            "updated_at": "2024-01-15T10:30:00.000000Z"
        },
        {
            "id": "dEf456Zw",
            "type": "domain",
            "value": "spammer.com",
            "created_at": "2024-01-15T09:45:00.000000Z",
            "updated_at": "2024-01-15T09:45:00.000000Z"
        },
        {
            "id": "jKl012Ab",
            "type": "company",
            "value": "concurrent sarl",
            "created_at": "2024-01-14T15:20:00.000000Z",
            "updated_at": "2024-01-14T15:20:00.000000Z"
        },
        {
            "id": "mNo345Cd",
            "type": "siren",
            "value": "123456789",
            "created_at": "2024-01-14T14:10:00.000000Z",
            "updated_at": "2024-01-14T14:10:00.000000Z"
        },
        {
            "id": "pQr678Ef",
            "type": "address",
            "value": "jean|dupont|75001",
            "created_at": "2024-01-13T11:30:00.000000Z",
            "updated_at": "2024-01-13T11:30:00.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 25,
        "to": 25,
        "total": 25
    }
}

Types disponibles :

email : Adresse email exacte

domain : Nom de domaine

company : Nom d'entreprise (recherche approximative)

siren : Numéro SIREN (9 chiffres)

address : Identité complète (format: firstname_slug|lastname_slug|zip)

Note sur le type address :

Le type address utilise un format spécial pour bloquer une personne par son identité complète.

Format de la valeur : firstname_slug|lastname_slug|code_postal

Exemple : jean|dupont|75001

La slugification utilise Str::slug() avec locale 'fr' pour gérer les accents français.

Ajouter à la blocklist

Ajoute un élément à bloquer.

POST


                                                https://meetlane.ai/api/api/blocklist

Paramètres

Nom	Type	Requis	Description
type	string	Oui	Type (email, domain, company, siren, address)
value	string	Oui	Valeur à bloquer

Exemple de requête

curl -X POST "https://meetlane.ai/api/api/blocklist" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "email",
    "value": "unwanted@spam.com"
}'

const response = await fetch('https://meetlane.ai/api/api/blocklist', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "type": "email",
      "value": "unwanted@spam.com"
  })
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/blocklist');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);

$data = '{
    "type": "email",
    "value": "unwanted@spam.com"
}';
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Item added to blocklist successfully",
    "data": {
        "id": "aBc123Xy",
        "type": "email",
        "value": "unwanted@spam.com",
        "created_at": "2024-01-22T10:30:00.000000Z"
    }
}

Types supportés :

email : Adresse email complète (ex: spam@example.com)

domain : Nom de domaine (ex: competitor.com)

company : Nom d'entreprise (ex: Concurrent SARL)

siren : Numéro SIREN à 9 chiffres (ex: 123456789)

address : Identité complète au format firstname_slug|lastname_slug|zip (ex: jean|dupont|75001)

Validation automatique :

Le type est détecté automatiquement selon le format de la valeur.

Pour le type address, la valeur doit être pré-formatée avec les slugs.

Supprimer de la blocklist

Supprime un élément de la blocklist par ID ou par valeur.

DELETE


                                                https://meetlane.ai/api/api/blocklist

Paramètres

Nom	Type	Requis	Description
id	string	Non	ID hashé de l'élément à supprimer
value	string	Non	Valeur à débloquer (alternative à id)

Exemple de requête

curl -X DELETE "https://meetlane.ai/api/api/blocklist" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Par ID": {
        "id": "aBc123Xy"
    },
    "Par valeur": {
        "value": "unwanted@spam.com"
    }
}'

const response = await fetch('https://meetlane.ai/api/api/blocklist', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "Par ID": {
          "id": "aBc123Xy"
      },
      "Par valeur": {
          "value": "unwanted@spam.com"
      }
  })
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/blocklist');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);

$data = '{
    "Par ID": {
        "id": "aBc123Xy"
    },
    "Par valeur": {
        "value": "unwanted@spam.com"
    }
}';
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "message": "Item removed from blocklist successfully"
}

Méthodes de suppression :

Par ID : Utilisez le paramètre id avec l'ID hashé récupéré depuis GET /api/blocklist

Par valeur : Utilisez le paramètre value avec la valeur exacte

Note : Au moins un des deux paramètres (id ou value) doit être fourni. Si les deux sont fournis, id est prioritaire.

Historique des rendez-vous calendrier

Récupère l'historique des rendez-vous pris via la page de booking calendrier d'un agent.

GET


                                                https://meetlane.ai/api/api/agents/{agentId}/calendar-events

Paramètres

Nom	Type	Requis	Description
agentId	string	Oui	ID hashé de l'agent
page	integer	Non	Numéro de page
per_page	integer	Non	Éléments par page (1-50)

Exemple de requête

curl -X GET "https://meetlane.ai/api/api/agents/{agentId}/calendar-events" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://meetlane.ai/api/api/agents/{agentId}/calendar-events', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://meetlane.ai/api/api/agents/{agentId}/calendar-events');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);

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

echo $response;

Exemple de réponse

{
    "success": true,
    "agent": {
        "id": "aBc123Xy",
        "firstname": "Pierre",
        "lastname": "Martin"
    },
    "data": [
        {
            "id": "xYz789Qw",
            "contact_name": "Marie Durand",
            "contact_email": "marie.durand@example.com",
            "contact_firstname": "Marie",
            "contact_lastname": "Durand",
            "contact_phone": "+33612345678",
            "scheduled_at": "2024-01-25T10:00:00.000000Z",
            "timezone": "Europe/Paris",
            "google_event_id": "abc123xyz",
            "google_event_link": "https://calendar.google.com/event?eid=abc123xyz",
            "status": "success",
            "created_at": "2024-01-22T14:30:00.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 2,
        "per_page": 10,
        "to": 10,
        "total": 15
    }
}

Endpoints disponibles :

/api/agents/{agentId}/calendar-events (recommandé pour Meetlane)

/api/campaigns/{campaignId}/calendar-events (alias fonctionnel pour compatibilité)

Statuts possibles :

success : Événement créé avec succès dans Google Calendar

failed : Échec de création dans Google Calendar (événement sauvegardé localement)

calendar_disconnected : Calendrier Google non connecté (événement sauvegardé localement)

Important :

Cet historique est un log local des réservations effectuées via la page de booking.

Il n'est pas synchronisé avec Google Calendar et sert uniquement de journal d'audit.

Webhooks

Les webhooks permettent de recevoir des notifications en temps réel des événements de vos agents Meetlane.

Configuration : Interface Meetlane > Paramètres > Webhooks

Webhooks disponibles :

Filtrage par agent configurable
Stockés dans votre compte utilisateur
Configuration d'URL par type d'événement

Format général des webhooks : Chaque webhook est envoyé en POST avec le format JSON suivant :

Format général

{
    "event": "event_type",
    "timestamp": "2024-01-20T14:30:00.000000Z",
    "user_id": "aBc123Xy",
    "data": []
}

Événements emails disponibles :

1. lead_ready_for_validation - Lead prêt à être validé

Déclenché lorsqu'un nouveau contact est prêt pour une prise de contact email.

Payload lead_ready_for_validation

{
    "event": "lead_ready_for_validation",
    "timestamp": "2024-01-20T14:30:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "lead": {
            "id": "dEf456Zw",
            "firstname": "Jean",
            "lastname": "Dupont",
            "email": "jean.dupont@entreprise.com",
            "company": "TechCorp SAS"
        }
    }
}

2. new_email_received - Nouvel email important reçu

Déclenché lorsqu'un email nécessitant attention est reçu d'un prospect.

Payload new_email_received

{
    "event": "new_email_received",
    "timestamp": "2024-01-20T15:20:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "email": {
            "id": "gHi789Uv",
            "from_name": "Marie Durand",
            "from_email": "marie.durand@example.com",
            "subject": "Intéressé par votre solution",
            "preview": "Bonjour, j'aimerais en savoir plus sur..."
        }
    }
}

3. opportunity_transferred - Opportunité commerciale détectée

Déclenché lorsque Meetlane détecte une opportunité commerciale à transférer.

Payload opportunity_transferred

{
    "event": "opportunity_transferred",
    "timestamp": "2024-01-20T16:10:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "opportunity": {
            "id": "jKl012Mn",
            "firstname": "Sophie",
            "lastname": "Martin",
            "email": "sophie.martin@company.com",
            "company": "Innovation SAS",
            "status": "won",
            "transfer_reason": "Forte intention d'achat détectée"
        }
    }
}

4. lead_lost - Prospect perdu

Déclenché lorsque Meetlane détecte qu'un prospect n'est pas intéressé.

Payload lead_lost

{
    "event": "lead_lost",
    "timestamp": "2024-01-20T17:00:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "lead": {
            "id": "pQr345St",
            "firstname": "Pierre",
            "lastname": "Durand",
            "email": "pierre.durand@test.com",
            "company": "TechStart",
            "previous_status": "nurture",
            "loss_reason": "Pas intéressé détecté par IA"
        }
    }
}

5. lead_blocked - Lead bloqué automatiquement

Déclenché lorsqu'un lead est bloqué automatiquement (antispam, blocklist).

Payload lead_blocked

{
    "event": "lead_blocked",
    "timestamp": "2024-01-20T17:15:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "lead": {
            "id": "uVw678Xy",
            "firstname": "Marc",
            "lastname": "Lambert",
            "email": "spam@domain.com",
            "company": "Unknown",
            "previous_status": "contact",
            "block_reason": "Bloqué automatiquement par IA"
        }
    }
}

6. reply_sent - Réponse envoyée à un prospect

Déclenché lorsqu'une réponse (auto ou manuelle) est envoyée à un prospect.

Payload reply_sent

{
    "event": "reply_sent",
    "timestamp": "2024-01-20T18:00:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "reply": {
            "id": "yZa901Bc",
            "lead_id": "dEf456Zw",
            "to_email": "contact@company.com",
            "subject": "Re: Demande d'information",
            "type": "auto",
            "has_cc": true,
            "lead_name": "Jean Dupont",
            "lead_company": "TechCorp SAS"
        }
    }
}

7. auto_reply_prepared - Réponse automatique préparée

Déclenché lorsque Meetlane prépare une réponse automatique en attente de validation.

Payload auto_reply_prepared

{
    "event": "auto_reply_prepared",
    "timestamp": "2024-01-20T18:30:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "reply": {
            "id": "dEf234Gh",
            "lead_id": "jKl012Mn",
            "from_email": "prospect@startup.io",
            "subject": "Re: Votre proposition",
            "category": "interested",
            "has_cc": false,
            "lead_name": "Sophie Martin",
            "lead_company": "Innovation SAS",
            "manager_verified": false
        }
    }
}

Événements courriers disponibles :

8. letter_ready_for_validation - Courrier prêt à être validé

Déclenché lorsqu'un courrier a été généré et attend validation.

Payload letter_ready_for_validation

{
    "event": "letter_ready_for_validation",
    "timestamp": "2024-01-20T14:30:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "lead": {
            "id": "dEf456Zw",
            "firstname": "Jean",
            "lastname": "Dupont",
            "email": "jean.dupont@entreprise.com",
            "company": "TechCorp SAS"
        }
    }
}

9. letter_sent - Courrier envoyé au service postal

Déclenché lorsqu'un courrier validé est envoyé à l'impression et à la poste.

Payload letter_sent

{
    "event": "letter_sent",
    "timestamp": "2024-01-20T14:30:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "letter": {
            "id": "gHi789Uv",
            "lead_id": "dEf456Zw",
            "recipient_name": "Jean Dupont",
            "recipient_company": "TechCorp SAS",
            "recipient_address": "123 rue de Rivoli, 75001 Paris",
            "tracking_number": "BATCH-20240120-abc123",
            "sent_at": "2024-01-20T14:30:00.000000Z"
        }
    }
}

10. letter_delivered - Courrier livré au destinataire

Déclenché lorsque le courrier est confirmé livré par La Poste.

Payload letter_delivered

{
    "event": "letter_delivered",
    "timestamp": "2024-01-22T10:15:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "letter": {
            "id": "gHi789Uv",
            "lead_id": "dEf456Zw",
            "recipient_name": "Jean Dupont",
            "recipient_company": "TechCorp SAS",
            "tracking_number": "BATCH-20240120-abc123",
            "delivered_at": "2024-01-22T10:15:00.000000Z"
        }
    }
}

11. letter_returned - Courrier retourné (NPAI/PND)

Déclenché lorsqu'un courrier est retourné par La Poste (adresse incorrecte).

Payload letter_returned

{
    "event": "letter_returned",
    "timestamp": "2024-01-25T09:30:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "letter": {
            "id": "gHi789Uv",
            "lead_id": "dEf456Zw",
            "recipient_name": "Jean Dupont",
            "recipient_company": "TechCorp SAS",
            "tracking_number": "BATCH-20240120-abc123",
            "return_reason": "Adresse incorrecte",
            "returned_at": "2024-01-25T09:30:00.000000Z"
        }
    }
}

12. qr_code_scanned - QR code flashé sur un courrier

Déclenché lorsqu'un destinataire scanne le QR code sur un courrier.

Payload qr_code_scanned

{
    "event": "qr_code_scanned",
    "timestamp": "2024-01-21T16:45:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "scan": {
            "letter_id": "gHi789Uv",
            "lead_id": "dEf456Zw",
            "recipient_name": "Jean Dupont",
            "recipient_company": "TechCorp SAS",
            "scan_location": {
                "country": "France",
                "city": "Paris",
                "latitude": 48.8566,
                "longitude": 2.3522
            },
            "scan_device": {
                "platform": "iOS",
                "browser": "Safari"
            },
            "scanned_at": "2024-01-21T16:45:00.000000Z"
        }
    }
}

13. new_calendar_event - Nouveau rendez-vous calendrier

Déclenché lorsqu'un rendez-vous est pris via la page de réservation calendrier.

Payload new_calendar_event

{
    "event": "new_calendar_event",
    "timestamp": "2024-01-22T14:30:00.000000Z",
    "user_id": "aBc123Xy",
    "data": {
        "appointment": {
            "id": "xYz456Qw",
            "contact_firstname": "Marie",
            "contact_lastname": "Durand",
            "contact_email": "marie.durand@example.com",
            "contact_phone": "+33612345678",
            "scheduled_at": "2024-01-25T10:00:00.000000Z",
            "timezone": "Europe/Paris",
            "google_event_id": "abc123xyz",
            "google_event_link": "https://calendar.google.com/event?eid=abc123xyz",
            "status": "success"
        }
    }
}

Statuts possibles :

success : Événement créé avec succès dans Google Calendar
failed : Échec de création dans Google Calendar (événement sauvegardé localement)
calendar_disconnected : Calendrier Google non connecté (événement sauvegardé localement)

Webinar découverte

Documentation API Meetlane - v1.0

Introduction

Authentification

Informations utilisateur

Exemple de requête

Exemple de réponse

Liste des contacts

Paramètres

Exemple de requête

Exemple de réponse

Ajouter un contact LinkedIn manuel

Paramètres

Exemple de requête

Exemple de réponse

Bloquer un contact

Paramètres

Exemple de requête

Exemple de réponse

Statistiques d'un agent

Paramètres

Exemple de requête

Exemple de réponse

Liste des emails

Paramètres

Exemple de requête

Emails en attente de validation

Paramètres

Exemple de requête

Exemple de réponse

Réponses email à traiter

Paramètres

Exemple de requête

Exemple de réponse

Valider une prise de contact

Paramètres

Exemple de requête

Exemple de réponse

Refuser une prise de contact

Paramètres

Exemple de requête

Exemple de réponse

Valider une réponse email

Paramètres

Exemple de requête

Exemple de réponse

Ignorer une réponse email

Paramètres

Exemple de requête

Exemple de réponse

Liste des courriers

Paramètres

Exemple de requête

Exemple de réponse

Courriers en attente de validation

Paramètres

Exemple de requête

Exemple de réponse

Valider un courrier

Paramètres

Exemple de requête

Exemple de réponse

Refuser un courrier

Paramètres

Exemple de requête

Exemple de réponse

Liste de blocage

Paramètres

Exemple de requête

Exemple de réponse

Ajouter à la blocklist

Paramètres

Exemple de requête

Exemple de réponse

Supprimer de la blocklist

Paramètres

Exemple de requête

Exemple de réponse

Historique des rendez-vous calendrier

Paramètres