L’API Starleads

API Starleads :
connectez vos agents à votre logiciel, sans ressaisie.

Reliez votre logiciel métier à Starleads. Votre logiciel transmet les contacts à Starleads et reçoit les résultats des échanges par webhook.

Écoutez-la. Posez-lui vos questions.

Consulter la documentation API
StarleadsUn aller-retour, sans ressaisie
Votre logicielLe contact et son contexte
LéaVotre agent IA
Résultat reçu dans votre logicielWebhook

« Disponibilité souhaitée : mardi à 14 h. »

Rendez-vousDisponibilité relevée
Clé API
Active
Webhook
À la fin de chaque échange
Forfait
Pro et Business
Avant, pendant et après l’échange

Envoyez le contexte.
Récupérez ce qui s’est passé.

L’API confie les contacts à la campagne. Les requêtes HTTP apportent les informations pendant l’appel. Le webhook renvoie le résultat.

Les échanges avec votre logicielStarleads

Le contact rejoint la bonne campagne.

Transmettez un contact ou un lot, avec le prénom et les champs de votre métier. Les règles de campagne déterminent les horaires, les tentatives et leur espacement.

Lire la documentation
Votre logicielCampagne Starleads
Contact
Camille
Campagne
Demandes de démonstration
Besoin
Équiper l’accueil téléphonique
Disponibilité
Mardi après-midi

Vue simplifiée des données. Les formats exacts sont dans la documentation API.

Pour votre équipe technique

Un contact envoyé.
Un résultat exploitable.

La clé s’envoie dans l’en-tête X-Api-Key. Votre serveur ajoute le contact à la campagne, puis reçoit le résultat par webhook.

Les champs de votre métier se placent dans dataBag. Retrouvez le format de chaque route et les réponses attendues dans la documentation publique.

Voir cette route dans la documentation
Un premier échange, côté codeStarleads
POST /CampaignItem/{campaignId}
curl --request POST \
  --url 'https://api.starleads.co/CampaignItem/ID_CAMPAGNE' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: VOTRE_CLE_SECRETE' \
  --data '{
    "phoneNumber": "VOTRE_NUMERO_DE_TEST",
    "dataBag": { "prenom": "Camille" }
  }'

À exécuter côté serveur. Remplacez les valeurs et adaptez dataBag aux champs de votre campagne ; ici, un champ « prenom ». L’ajout déclenche le traitement selon vos règles de campagne.

Votre logiciel reste au courant

Les conversations avancent.
Vos dossiers aussi.

Les contacts partent sans fichier

Votre logiciel ajoute les contacts à la campagne, un par un ou en masse. Votre équipe évite l’export et la ressaisie du matin.

Le résultat revient après l’appel

Résumé, transcription, étiquette, informations relevées et tentatives : les données rejoignent votre logiciel par webhook.

Le client reçoit l’information du dossier

Une commande, une disponibilité, un état d’avancement : l’agent interroge votre logiciel pendant la conversation.

Dans l’autre sens aussi

Un événement dans votre outil.
Un agent prend le relais.

Votre formulaire, votre CRM ou votre campagne publicitaire envoie un contact à l’adresse sécurisée fournie par Starleads.

Un workflow le confie à l’agent. Le même webhook entrant peut déclencher plusieurs workflows, selon l’organisation que vous avez définie.

Organiser les actions avec un workflowVoir le modèle de rappel d’un formulaire
Du formulaire à la conversationStarleads
Votre formulaireUne demande de démonstration
Webhook entrantAdresse fournie par Starleads
WorkflowConfier le contact à Léa
LéaAppel selon les règles de la campagne
Ce que couvre l’API

Les ressources de vos agents,
accessibles depuis votre code.

Ouvrir la référence API

Campagnes et contacts

Créer vos campagnes, ajouter vos contacts un par un ou en masse, les mettre à jour et transmettre les champs de votre métier.

Résultats des échanges

Retrouver le résumé, la transcription, l’étiquette, les informations recueillies et les tentatives de chaque contact.

Enregistrements audio

Récupérer ou supprimer les enregistrements, notamment pour appliquer votre politique de conservation.

Agents et consignes

Lire vos agents, modifier leurs consignes, connecter ou retirer leurs outils et retrouver l’historique de leurs versions.

Base de connaissances

Créer vos bases documentaires, y déposer vos documents et lancer leur analyse. Avec Business, construire le graphe de connaissances.

Tests et consommation

Créer et lancer vos tests, simuler une conversation avec un agent, suivre vos crédits et votre abonnement.

Le détail des routes et des formats se trouve dans la documentation publique.

Une intégration que vous pouvez maintenir

Des clés secrètes.
Des évolutions documentées.

Votre équipe technique consulte la documentation avant même d’ouvrir un compte. Les changements incompatibles passent par une nouvelle route.

Vous pouvez créer plusieurs clés API. Une clé désactivée est refusée aussitôt et ne peut pas être réactivée.

Les données sont hébergées en France. Gardez vos clés côté serveur : elles ne doivent pas apparaître dans le code envoyé au navigateur.

Lire nos engagements de sécurité
Accès API · côté serveurStarleads
X-Api-Key•••• •••• •••• ••••
Emplacement
Configuration secrète du serveur
Clé exposée par erreur
Désactiver, puis créer une nouvelle clé
Ancienne clé
Refusée après désactivation
Voir l’authentification
+30 000

actions automatiques déclenchées dans les outils de nos clients après un échange

Votre mise en place

Envoyez un premier contact de test.
Commencez par un essai.

  1. 01

    Créez votre clé secrète

    Depuis l’accès API du compte, créez une clé et conservez-la dans la configuration de votre serveur.

  2. 02

    Renseignez votre webhook

    Dans la campagne, indiquez l’adresse de votre logiciel qui recevra les résultats et testez-la.

  3. 03

    Vérifiez un échange complet

    Envoyez un contact de test, contrôlez ce que reçoit votre outil, puis transmettez les autres contacts.

Ajout de contacts par fichier dès Starter. API, webhooks et requêtes HTTP à partir de Pro.

Pour démarrer sereinement

Vos questions,
des réponses concrètes.

En bref. Avec l’API Starleads, votre logiciel confie ses contacts à vos agents IA, sans export ni ressaisie. Un webhook renvoie ensuite le résultat de chaque échange. L’API est incluse à partir de Pro, à 239 € HT par mois avec paiement annuel.

Une autre question ?Léa vous rappelle

La documentation est publique sur docs.starleads.co. Elle présente l’authentification, les routes API et le webhook de résultats. Votre équipe technique peut la lire avant d’ouvrir un compte.

Désactivez-la, puis créez-en une nouvelle depuis l’accès API de votre compte. La clé désactivée est refusée et ne peut pas être réactivée. Ne placez pas de clé dans le code exposé au navigateur.

Oui. Vous pouvez ajouter des contacts un par un ou par fichier, dès Starter.

Votre formulaire, CRM ou campagne publicitaire transmet un contact à une adresse fournie par Starleads. Un workflow le confie à l’agent. Un même webhook peut déclencher plusieurs workflows.

Oui, l’intégration API demande un développeur. Pour les cas courants, les intégrations prêtes à l’emploi et les workflows permettent de connecter vos outils sans développer une intégration API.

L’API est incluse à partir de Pro, à 239 € HT par mois avec paiement annuel. Chaque appel ou message consomme les crédits de son canal.

Pour aller plus loin
Léa, agent IA Téléphone

Et si vous testiez l’agent avant d’écrire une ligne de code ?

Faites-vous appeler par Léa, puis réservez une démo pour voir les données envoyées à votre logiciel.

Testez un agent IA

Léa vous appelle maintenant.

Laissez votre numéro pour échanger avec Léa, l’agent IA de Starleads. Posez-lui vos questions et découvrez sa façon de converser.