Documentation Buska

Tout ce dont vous avez besoin pour installer, configurer et tirer le meilleur parti de Buska.

Qu'est-ce que Buska ?

Buska est une plateforme de social listening conue pour la generation de leads B2B. Elle surveille plus de 30 plateformes sociales (Twitter/X, Reddit, LinkedIn, YouTube, Hacker News, etc.) pour detecter les signaux d'intention d'achat, attribue un score IA a chaque mention et livre des leads qualifies prets pour la prospection.

Contrairement aux outils de veille comme Mention ou Brand24, Buska est concu pour trouver des acheteurs, pas pour suivre la reputation. Il ajoute le scoring d'intention par IA, le matching ICP, un Reply Studio pour l'engagement instantane et des integrations CRM pour agir sur les signaux des leur apparition.

Fonctionnalites cles

• Surveillez plus de 30 plateformes pour detecter les signaux d'achat en temps reel
• L'IA attribue un score de 0 a 100 a chaque lead selon l'intention, la fraicheur et le matching ICP
• Associez automatiquement les leads a votre profil client ideal
• Generez des reponses contextuelles par IA en un clic avec Reply Studio
• Exportez vers votre CRM, vos outils de prospection ou vos webhooks
• Creez des workflows automatises de la detection du signal a la prospection

Demarrage rapide

Comment configurer Buska en 5 minutes :

1. Creez votre compte sur app.buska.io/register (essai gratuit de 7 jours, sans carte bancaire)
2. Entrez votre site web - L'IA de Buska analyse votre activite et suggere des mots-cles, concurrents et ICPs
3. Verifiez vos mots-cles - Ajoutez ou supprimez des mots-cles. Incluez les noms de concurrents, les points de douleur et les expressions d'achat
4. Selectionnez les plateformes - Choisissez les plateformes sociales a surveiller (Twitter, Reddit, LinkedIn actives par defaut)
5. Lancez - Buska commence a scanner immediatement. Les premiers leads arrivent en moins d'une heure

Plans et limites

Buska propose trois plans. Tous les plans incluent un essai gratuit de 7 jours. La facturation annuelle permet d'economiser 2 mois (payez 10, obtenez 12).

Que comprend l'essai gratuit ?

Buska offre un essai gratuit de 7 jours sans carte bancaire. Chaque nouveau compte obtient un acces immediat pour commencer a trouver des leads. L'essai est concu pour vous permettre de decouvrir l'ensemble du processus de generation de leads avant de passer a un plan payant.

Ce que vous obtenez gratuitement

• 5 mots-cles surveilles sur les plateformes sociales
• 30 leads par semaine livres dans votre tableau de bord
• 7 sources : Twitter/X, Reddit, YouTube, Hacker News, Bluesky, Stack Overflow, LinkedIn
• Scoring IA sur chaque lead (score d'intention de 0 a 100)
• 2 profils ICP pour le matching des leads
• 3 recherches Prospect Finder
• 10 requetes API pour tester l'API Buska
• 1 workflow d'automatisation (ex. : nouveau lead vers webhook)
• Frequence de scan quotidienne

Ce qui necessite un plan payant

• AI Reply Studio (generation de reponses contextuelles)
• Export CSV
• Notifications Slack et Discord
• Integrations CRM (HubSpot, Salesforce, Pipedrive)
• Integrations prospection (Lemlist, Apollo, Instantly)
• Sources supplementaires : TikTok, Facebook, Instagram, G2, Trustpilot et 15+ autres
• Frequence de scan plus rapide (toutes les 3 heures ou toutes les heures)
• Plus de mots-cles, leads et membres d'equipe

Que se passe-t-il a la fin de l'essai ?

Lorsque votre essai de 7 jours se termine, votre compte est verrouille mais vos donnees sont conservees. Vous pouvez passer a un plan payant a tout moment pour reprendre le monitoring. Vos mots-cles, ICPs et historique de leads restent intacts.

L'essai gratuit est unique par utilisateur. Si vous creez une nouvelle equipe apres avoir utilise un essai, elle ne beneficiera pas d'une nouvelle periode d'essai.

Mots-cles et monitoring

Les mots-cles sont les termes de recherche que Buska surveille sur toutes les plateformes selectionnees. Chaque mot-cle est suivi independamment et genere son propre ensemble de leads.

Comment ajouter des mots-cles

1. Allez dans Settings > Keywords
2. Cliquez sur "Add keyword"
3. Entrez le mot-cle (ex. : "alternative to Monday.com")
4. Optionnel : ajoutez des mots-cles negatifs pour exclure les resultats non pertinents
5. Optionnel : definissez un filtre de langue

Bonnes pratiques pour les mots-cles

• Utilisez les noms de concurrents : "alternative to [concurrent]"
• Utilisez les points de douleur : "frustrated with [probleme]"
• Utilisez les expressions d'achat : "looking for a [solution]"
• Utilisez votre nom de marque pour la veille de reputation
• Gardez les mots-cles specifiques (3 a 5 mots fonctionnent le mieux)

Scoring IA et intention

Chaque lead recoit un score de 0 a 100 a l'aide d'un algorithme multi-facteurs. Le score combine la qualification par IA, le type d'intention, la fraicheur, le matching ICP et le poids de la plateforme.

Types d'intention

Comment fonctionne le scoring ?

Chaque lead recoit un score de 0 a 100 grace a un modele IA proprietaire entraine sur des milliers de signaux d'achat depuis decembre 2023. Le score combine plusieurs facteurs pour faire remonter les opportunites les plus pertinentes :

• Qualification IA : Notre modele analyse le contenu et attribue un score d'intention d'achat
• Type d'intention : Les signaux de demande active obtiennent un score superieur aux questions generales ou mentions de marque
• Fraicheur : Les publications recentes sont prioritaires sur les plus anciennes
• Matching ICP : Les leads correspondant a votre profil client ideal recoivent un bonus significatif
• Pertinence de la plateforme : Les plateformes professionnelles comme LinkedIn sont mieux ponderees

Niveaux de chaleur

• Hot (60+) : Forte intention d'achat, agissez immediatement
• Warm (35-59) : Interet modere, engagement recommande
• Cold (<35) : Intention faible, a surveiller pour de futurs signaux

ICP Matching

Le matching ICP (Ideal Customer Profile) vous permet de filtrer les leads selon votre profil d'acheteur ideal. Buska evalue chaque lead par rapport a votre ICP et augmente significativement le score des leads correspondants.

Comment creer un ICP

1. Allez dans Settings > ICP
2. Cliquez sur "Add ICP"
3. Entrez un nom (ex. : "Head of Marketing at B2B SaaS")
4. Ajoutez les roles cibles, industries, points de douleur et mots-cles d'intention
5. Enregistrez. Buska optimise automatiquement le matching pour votre profil

Methodes de matching

• Matching par mots-cles : Detecte les roles cibles, industries, points de douleur et mots-cles d'intention dans le contenu du lead
• Similarite IA : Notre modele compare le contenu du lead avec la description de votre ICP pour trouver des correspondances conceptuellement pertinentes

Reply Studio

Reply Studio est un generateur de reponses IA integre qui vous aide a interagir avec les leads instantanement. Disponible a partir du plan Growth.

Comment ca fonctionne

• Affiche vos 30 meilleurs leads qualifies avec la plus forte intention d'achat
• Choisissez parmi 3 tons : Expert, Pair ou Leader d'opinion
• L'IA genere une reponse contextuelle basee sur le contenu du lead et votre produit
• Copie en un clic + ouverture du post original pour repondre directement
• Les reponses sont mises en cache par lead + ton pour eviter la regeneration et economiser les tokens

Prospect Finder

Prospect Finder vous permet de lancer des recherches en langage naturel sur les plateformes sociales a la demande. Au lieu d'attendre que le monitoring par mots-cles fasse remonter des leads, vous decrivez ce que vous cherchez et Buska trouve les resultats correspondants.

Comment ca fonctionne

1. Entrez une requete en langage naturel (ex. : "Find founders looking for a project management tool")
2. Notre IA extrait les mots-cles et les plateformes cibles automatiquement
3. Buska lance jusqu'a 8 requetes en parallele sur les plateformes
4. Les resultats recoivent un score de 0 a 100 selon leur pertinence par rapport a votre requete

Disponible sur le plan Growth (20 recherches/mois) et le plan Scale (illimite).

Integration Slack

Description

Slack est une plateforme de messagerie d'equipe. Buska envoie des notifications de leads en temps reel directement dans votre espace Slack des qu'un nouveau lead qualifie est detecte. Chaque notification inclut le nom du lead, la plateforme, le type d'intention, le score IA et un lien vers le post original pour que votre equipe puisse agir immediatement.

Plan requis : Tous les plans (Starter, Growth, Scale)

Comment ca fonctionne

1. Buska detecte un nouveau lead correspondant a vos mots-cles
2. Le lead est evalue et qualifie par l'IA
3. Une notification enrichie est publiee dans le canal Slack de votre choix
4. Votre equipe voit le lead avec tout le contexte et peut interagir immediatement

Etapes de configuration

1. Allez dans Settings > Integrations dans Buska
2. Cliquez sur "Connect Slack"
3. Autorisez Buska dans votre espace Slack via OAuth
4. Selectionnez le canal ou vous souhaitez recevoir les notifications
5. Optionnel : definissez un seuil de score minimum pour filtrer les leads a faible intention

Donnees envoyees

Integration Discord

Description

Discord est une plateforme de communication communautaire et d'equipe. Buska envoie des notifications de leads dans un canal Discord via des webhooks. Chaque notification contient le nom du lead, la plateforme, le type d'intention, le score IA et un lien direct vers le post original.

Plan requis : Tous les plans (Starter, Growth, Scale)

Comment ca fonctionne

1. Buska detecte un nouveau lead qualifie
2. Les donnees du lead sont formatees en embed Discord
3. Buska publie l'embed dans votre canal Discord via webhook
4. Votre equipe voit le lead et peut en discuter ou agir directement dans le fil

Etapes de configuration

1. Dans Discord, faites un clic droit sur le canal cible et allez dans Edit Channel > Integrations > Webhooks
2. Cliquez sur "New Webhook" et copiez l'URL du webhook
3. Dans Buska, allez dans Settings > Integrations
4. Cliquez sur "Connect Discord"
5. Collez l'URL du webhook et cliquez sur "Test"

Donnees envoyees

Integration Microsoft Teams

Description

Microsoft Teams est une plateforme de communication d'entreprise. Buska envoie des notifications de leads dans les canaux Teams via des webhooks entrants, pour que votre equipe commerciale voie les leads qualifies apparaitre directement dans leur outil de travail. Chaque carte inclut le nom du lead, la plateforme, l'intention, le score IA et un lien direct vers le post original.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte et evalue un nouveau lead
2. Les donnees du lead sont formatees en Adaptive Card Teams
3. Buska publie la carte dans votre canal Teams via webhook
4. Votre equipe examine le lead et passe a l'action

Etapes de configuration

1. Dans Microsoft Teams, allez dans le canal cible, cliquez sur "..." > Connectors
2. Recherchez "Incoming Webhook" et cliquez sur "Configure"
3. Nommez le webhook (ex. : "Buska Leads") et copiez l'URL du webhook
4. Dans Buska, allez dans Settings > Integrations
5. Cliquez sur "Connect Microsoft Teams"
6. Collez l'URL du webhook et cliquez sur "Test"

Donnees envoyees

Webhooks

Description

Les webhooks vous permettent d'envoyer les donnees de leads vers n'importe quelle URL en temps reel. Utilisez-les pour connecter Buska a vos outils internes, pipelines personnalises ou tout service acceptant les requetes HTTP POST. Les webhooks sont la base pour connecter Buska a Make, n8n, Clay et toute autre plateforme d'automatisation.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte et qualifie un nouveau lead
2. Buska envoie une requete JSON POST a votre URL de webhook
3. Votre endpoint recoit le payload complet du lead avec tous les champs
4. Votre systeme traite le lead (envoi vers le CRM, declenchement de prospection, enregistrement en base, etc.)

Etapes de configuration

1. Allez dans Settings > Integrations dans Buska
2. Cliquez sur "Add Webhook"
3. Entrez l'URL de votre endpoint (doit accepter les requetes POST)
4. Optionnel : ajoutez un header personnalise pour l'authentification (ex. : Authorization: Bearer your-token)
5. Cliquez sur "Test" pour envoyer un payload de test et verifier que votre endpoint repond avec un code 200

Payload JSON complet

Buska envoie une requete JSON POST a votre endpoint pour chaque nouveau lead. Voici la structure complete du payload :

{
  "event": "new_lead",
  "timestamp": "2026-03-14T10:15:00Z",
  "lead": {
    "name": "John Doe",
    "channel": "linkedin",
    "intent": "ACTIVE",
    "aiScore": 8,
    "aiReason": "Shows intent to buy CRM solution",
    "icpMatch": "CTO",
    "contentPreview": "Looking for a better CRM...",
    "postUrl": "https://...",
    "link": "https://linkedin.com/in/...",
    "keyword": "CRM",
    "publishedAt": "2026-03-14T09:00:00Z"
  },
  "enriched": {
    "email": "john@company.com",
    "phone": "+1234567890",
    "fullName": "John Doe",
    "company": "Acme Corp",
    "title": "CTO",
    "linkedinUrl": "https://linkedin.com/in/johndoe"
  }
}

Mapping des donnees

Integration Make

Description

Make (anciennement Integromat) est une plateforme d'automatisation visuelle. Buska se connecte a Make via des webhooks, vous permettant de creer des workflows en glisser-deposer qui se declenchent a chaque nouveau lead qualifie detecte. Vous pouvez diriger les leads vers n'importe laquelle des 1 500+ integrations d'applications de Make sans ecrire de code.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte un lead qualifie et envoie les donnees a votre webhook Make
2. Make recoit le payload et analyse tous les champs du lead comme variables
3. Votre scenario redirige le lead selon des conditions (score, intention, plateforme)
4. Make envoie le lead vers votre CRM, outil de prospection, tableur ou toute application connectee

Etapes de configuration

1. Dans Make, creez un nouveau scenario et ajoutez un module de declenchement "Webhooks > Custom webhook"
2. Cliquez sur "Add" pour creer un nouveau webhook et copiez l'URL
3. Dans Buska, allez dans Settings > Integrations > Webhooks
4. Ajoutez l'URL du webhook Make comme endpoint
5. Cliquez sur "Test" dans Buska pour envoyer un payload de test
6. Dans Make, cliquez sur "Redetermine data structure" pour analyser les champs du payload
7. Ajoutez des modules en aval (ex. : HubSpot, Google Sheets, Slack) et mappez les champs du lead

Donnees envoyees

Integration n8n

Description

n8n est une plateforme d'automatisation de workflows open source et auto-hebergeable. Buska se connecte a n8n via des webhooks, vous permettant de construire des pipelines automatises de traitement de leads sur votre propre infrastructure. Ideal pour les equipes qui ont besoin d'un controle total sur le flux de donnees et souhaitent eviter les plateformes d'automatisation tierces.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte un lead qualifie et envoie les donnees a votre webhook n8n
2. n8n recoit le payload et rend tous les champs du lead disponibles comme expressions
3. Votre workflow traite le lead (filtrage, enrichissement, transformation)
4. n8n envoie le resultat vers votre CRM, base de donnees ou outil de prospection

Etapes de configuration

1. Dans n8n, creez un nouveau workflow et ajoutez un noeud Webhook comme declencheur
2. Definissez la methode HTTP sur POST
3. Copiez l'URL de webhook de production de n8n (pas l'URL de test)
4. Dans Buska, allez dans Settings > Integrations > Webhooks
5. Collez l'URL du webhook n8n et cliquez sur "Test"
6. Dans n8n, verifiez l'execution pour confirmer que le payload a ete recu
7. Ajoutez des noeuds en aval (ex. : noeud IF pour filtrer par score, noeud HTTP pour appeler l'API de votre CRM)

Donnees envoyees

Integration HubSpot

Description

HubSpot est une plateforme CRM et marketing. Buska envoie les leads qualifies directement dans votre CRM HubSpot sous forme de nouveaux contacts, et cree optionnellement des deals associes dans votre pipeline. Chaque contact inclut les donnees enrichies, les signaux d'intention et le scoring IA pour que votre equipe commerciale ait tout le contexte des le depart.

Plan requis : Growth, Scale

Comment ca fonctionne

Lorsque Buska detecte quelqu'un publiant "looking for a CRM", il enrichit le lead avec Apollo, puis cree un contact HubSpot avec l'email, l'entreprise, le type d'intention et le score IA comme proprietes personnalisees. Votre equipe commerciale voit le lead chaud apparaitre dans son pipeline avec tout le contexte.

1. Buska detecte un signal d'achat et enrichit le lead
2. Un nouveau contact HubSpot est cree (ou mis a jour si l'email existe deja)
3. Un deal est cree dans le pipeline et l'etape de votre choix
4. Votre equipe commerciale voit le lead dans HubSpot avec le score IA, l'intention et le post original

Etapes de configuration

1. Allez dans Settings > Integrations dans Buska
2. Cliquez sur "Connect HubSpot"
3. Autorisez Buska via OAuth (vous serez redirige vers HubSpot)
4. Selectionnez le pipeline et l'etape de deal pour les nouveaux leads
5. Mappez les champs Buska aux proprietes HubSpot (mapping automatique par defaut)
6. Optionnel : creez des proprietes HubSpot personnalisees pour le score IA, le type d'intention et le mot-cle

Donnees envoyees

Integration Salesforce

Description

Salesforce est une plateforme CRM d'entreprise. Buska exporte les leads qualifies vers Salesforce sous forme de Leads ou Contacts, avec tous les signaux d'intention et les donnees de scoring IA. Cela donne a vos commerciaux une visibilite immediate sur les signaux d'achat sociaux dans l'outil qu'ils utilisent au quotidien.

Plan requis : Scale

Comment ca fonctionne

1. Buska detecte un signal d'achat et enrichit le lead
2. Un nouvel enregistrement Lead ou Contact est cree dans Salesforce
3. Les champs personnalises (score IA, intention, mot-cle) sont remplis automatiquement
4. Une activite est enregistree avec l'URL du post original et le raisonnement IA

Etapes de configuration

1. Allez dans Settings > Integrations dans Buska
2. Cliquez sur "Connect Salesforce"
3. Autorisez Buska via OAuth (vous serez redirige vers Salesforce)
4. Choisissez de creer des Leads ou des Contacts
5. Mappez les champs (mapping automatique par defaut) ou personnalisez le mapping
6. Optionnel : definissez des regles d'attribution pour diriger vers des commerciaux specifiques

Donnees envoyees

Integration Pipedrive

Description

Pipedrive est un CRM oriente vente. Buska envoie les leads qualifies dans Pipedrive sous forme de Personnes et de Deals, pour que votre pipeline commercial se remplisse automatiquement de leads chauds ayant exprime une intention d'achat sur les reseaux sociaux. Chaque deal est place dans l'etape de pipeline de votre choix avec tout le contexte.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte un signal d'achat et enrichit le lead
2. Une Personne est creee dans Pipedrive avec les coordonnees
3. Un Deal est cree et lie a la Personne dans le pipeline selectionne
4. Une Note est ajoutee avec le score IA, l'intention et le lien vers le post original

Etapes de configuration

1. Dans Pipedrive, allez dans Settings > Personal preferences > API et copiez votre token API
2. Dans Buska, allez dans Settings > Integrations
3. Cliquez sur "Connect Pipedrive"
4. Collez votre token API Pipedrive
5. Selectionnez le pipeline cible et l'etape de deal
6. Mappez les champs ou utilisez les valeurs par defaut

Donnees envoyees

Integration Lemlist

Description

Lemlist est une plateforme d'emailing a froid et de prospection. Lorsque Buska detecte un lead qualifie sur les reseaux sociaux, il peut automatiquement ajouter ce lead a une campagne Lemlist. Le lead arrive avec son email, nom, entreprise et des variables personnalisees comme le score IA et le type d'intention, pret pour votre sequence de prospection.

Plan requis : Growth, Scale

Comment ca fonctionne en pratique

1. Buska detecte un signal d'achat sur Twitter, Reddit ou LinkedIn
2. Le workflow d'automatisation enrichit le lead via Apollo (pour obtenir son email)
3. Si un email est trouve, Buska envoie le lead vers votre campagne Lemlist
4. Lemlist lance la sequence de prospection automatiquement
5. Vous repondez aux prospects chauds qui ont deja exprime une intention

Etapes de configuration

1. Obtenez votre cle API Lemlist depuis Lemlist > Settings > Integrations
2. Dans Buska, allez dans Settings > Integrations > Connect Lemlist
3. Collez votre cle API et testez la connexion
4. Creez un workflow d'automatisation : Declencheur "new_lead" > Etape 1 : Enrichir avec Apollo > Etape 2 : Exporter vers Lemlist
5. Selectionnez votre campagne cible dans la configuration de l'etape
6. Definissez les conditions : score IA minimum >= 7, types d'intention ACTIVE ou COMPETITOR

Donnees envoyees a Lemlist

Integration Apollo

Description

Apollo est une plateforme d'enrichissement de donnees B2B et d'engagement commercial. Buska utilise Apollo de deux facons : comme source d'enrichissement pour trouver les adresses email, numeros de telephone et informations d'entreprise de vos leads, et comme destination de prospection pour ajouter les leads enrichis a des sequences Apollo de suivi automatise.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte un lead et envoie l'URL du profil ou le nom a Apollo pour enrichissement
2. Apollo retourne l'email, le telephone, l'entreprise, le titre et l'URL LinkedIn
3. Les donnees enrichies sont stockees avec le lead dans Buska
4. Optionnellement, le lead est ajoute a une sequence Apollo pour de la prospection automatisee

Etapes de configuration

1. Dans Apollo, allez dans Settings > Integrations > API Keys et creez une nouvelle cle
2. Dans Buska, allez dans Settings > Integrations
3. Cliquez sur "Connect Apollo"
4. Collez votre cle API Apollo
5. Activez l'enrichissement pour enrichir automatiquement les nouveaux leads
6. Optionnel : selectionnez une sequence Apollo pour y ajouter les leads enrichis

Donnees envoyees / recues

Integration Instantly

Description

Instantly est une plateforme de prospection par email a froid optimisee pour la delivrabilite. Buska envoie les leads enrichis et qualifies directement dans vos campagnes Instantly, pour que vous puissiez demarrer la prospection aupres de personnes ayant deja exprime une intention d'achat sur les reseaux sociaux.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte un signal d'achat et enrichit le lead (via Apollo)
2. Si un email est trouve, Buska ajoute le lead a votre campagne Instantly
3. Instantly lance la sequence email automatiquement
4. Vous relancez les prospects qui repondent

Etapes de configuration

1. Dans Instantly, allez dans Settings > API > API Keys et generez une nouvelle cle
2. Dans Buska, allez dans Settings > Integrations
3. Cliquez sur "Connect Instantly"
4. Collez votre cle API Instantly
5. Selectionnez la campagne ou ajouter les leads
6. Mappez les champs du lead aux variables Instantly

Donnees envoyees

Integration La Growth Machine

Description

La Growth Machine (LGM) est une plateforme de prospection multi-canal qui combine LinkedIn, email et Twitter dans une seule sequence. Buska envoie les leads qualifies dans les audiences LGM, ou ils sont automatiquement inscrits dans votre campagne de prospection multi-canal.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte un lead qualifie et enrichit son profil
2. Le lead est envoye dans votre audience LGM avec l'URL LinkedIn, l'email et le telephone
3. LGM inscrit automatiquement le lead dans la campagne selectionnee
4. LGM contacte le lead via LinkedIn, email et Twitter en sequence

Etapes de configuration

1. Dans LGM, allez dans Settings > API et generez votre cle API
2. Dans Buska, allez dans Settings > Integrations
3. Cliquez sur "Connect La Growth Machine"
4. Collez votre cle API LGM
5. Selectionnez l'audience ou ajouter les leads
6. Optionnel : choisissez une campagne pour inscrire les leads immediatement

Donnees envoyees

Integration Clay

Description

Clay est une plateforme d'enrichissement de donnees et de workflows avec acces a plus de 75 fournisseurs de donnees. Buska envoie les leads dans des tables Clay via webhooks, ou Clay peut ajouter des enrichissements supplementaires (taille de l'entreprise, financement, stack technique, etc.) puis envoyer le lead completement enrichi vers votre CRM ou outil de prospection.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte un lead qualifie et l'envoie a votre webhook de table Clay
2. Clay recoit le lead et execute vos colonnes d'enrichissement (recherche d'email, recherche d'entreprise, etc.)
3. Clay envoie le lead completement enrichi vers votre CRM ou outil de prospection

Etapes de configuration

1. Dans Clay, creez une nouvelle table et cliquez sur "Add source" > "Webhook"
2. Copiez l'URL du webhook Clay
3. Dans Buska, allez dans Settings > Integrations > Webhooks
4. Ajoutez l'URL du webhook Clay comme endpoint
5. Cliquez sur "Test" pour envoyer un payload de test et enregistrer le schema dans Clay
6. Dans Clay, ajoutez des colonnes d'enrichissement (ex. : "Find email", "Company info", "LinkedIn profile")
7. Ajoutez une destination de push (ex. : HubSpot, Lemlist, Google Sheets)

Donnees envoyees

Integration Airtable

Description

Airtable est une plateforme de base de donnees flexible et collaborative. Buska exporte les leads dans des bases Airtable sous forme de nouvelles lignes, offrant a votre equipe une vue tableur de tous les leads qualifies. Ideal pour le suivi personnalise, le reporting et les workflows qui ne s'integrent pas facilement dans un CRM traditionnel.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte un lead qualifie
2. Les donnees du lead sont envoyees dans votre table Airtable sous forme de nouvelle ligne
3. Chaque champ correspond a une colonne Airtable (nom, score, intention, etc.)
4. Votre equipe peut filtrer, trier et creer des vues sur les donnees

Etapes de configuration

1. Dans Airtable, allez dans Account > Developer hub > Personal access tokens et creez un token avec acces en lecture/ecriture a votre base
2. Dans Buska, allez dans Settings > Integrations
3. Cliquez sur "Connect Airtable"
4. Collez votre token Airtable ou autorisez via OAuth
5. Selectionnez la base et la table
6. Mappez les champs Buska aux colonnes Airtable (ou utilisez le mapping automatique)

Donnees envoyees

Integration Notion

Description

Notion est une plateforme de workspace et de documentation avec des bases de donnees puissantes. Buska envoie les leads dans des bases de donnees Notion sous forme de nouvelles pages, avec toutes les proprietes du lead mappees aux colonnes de la base. Ideal pour les equipes qui utilisent Notion comme espace de travail central et veulent voir les leads a cote de leurs autres projets.

Plan requis : Growth, Scale

Comment ca fonctionne

1. Buska detecte un lead qualifie
2. Une nouvelle page est creee dans votre base de donnees Notion avec toutes les proprietes du lead
3. Le corps de la page contient l'apercu du contenu, le raisonnement IA et le lien vers le post
4. Votre equipe peut filtrer, trier et ajouter des tags de statut directement dans Notion

Etapes de configuration

1. Dans Notion, allez dans Settings > Connections > Develop or manage integrations et creez une nouvelle integration
2. Partagez votre base de donnees cible avec l'integration (cliquez sur "..." sur la base, puis "Connect to")
3. Dans Buska, allez dans Settings > Integrations
4. Cliquez sur "Connect Notion"
5. Autorisez Buska dans votre espace Notion
6. Selectionnez la base de donnees ou envoyer les leads
7. Mappez les champs Buska aux proprietes Notion

Donnees envoyees

Export CSV

Exportez vos leads sous forme de fichier CSV pour une analyse hors ligne, du reporting personnalise ou l'importation dans n'importe quel outil acceptant les fichiers CSV. Disponible a partir du plan Growth.

Comment exporter

1. Allez dans Settings > Export
2. Selectionnez la periode et les filtres (optionnel)
3. Cliquez sur "Export CSV"
4. Telechargez le fichier

Colonnes CSV

• Name
• Channel
• Keyword
• Intent
• ICP Match
• AI Score
• AI Reason
• Content
• Post URL
• Profile URL
• Published At

Editeur de workflows

L'editeur de workflows vous permet de creer des pipelines automatises qui s'executent chaque fois qu'un nouveau lead correspond a vos criteres. Chainez declencheurs, conditions et actions pour construire des workflows de traitement de leads personnalises.

Declencheurs

• new_lead : Se declenche lorsqu'un nouveau lead est detecte
• new_competitor_mention : Se declenche lorsqu'un concurrent est mentionne
• scheduled : S'execute a intervalle defini (toutes les heures, quotidien, hebdomadaire)
• manual : Declenche manuellement depuis le tableau de bord

Conditions

• Score IA minimum : Ne traiter que les leads au-dessus d'un seuil (ex. : score >= 7)
• Types d'intention : Filtrer par ACTIVE, COMPETITOR, PAIN, QUESTION ou MENTION
• Canaux : Filtrer par plateforme (Twitter, Reddit, LinkedIn, etc.)
• Mots-cles : Filtrer par mots-cles specifiques
• Noms ICP : Filtrer par profil ICP correspondant

Actions

• Notifier : Envoyer vers Slack, Discord ou un webhook
• Exporter : Envoyer vers un CRM (HubSpot, Salesforce, Pipedrive) ou un outil de prospection (Lemlist, Instantly, Apollo, LGM)
• Enrichir : Enrichir les donnees du lead avec Apollo ou Clay avant l'export

Modeles d'automatisation

Commencez avec un modele pre-construit et personnalisez-le pour votre workflow. Les modeles sont disponibles dans l'editeur de workflows sous l'onglet "Templates".

Modeles disponibles

Declencheurs et conditions

Les declencheurs definissent quand un workflow s'execute. Les conditions filtrent les leads qui passent a l'etape suivante. Combinez-les pour construire des regles d'automatisation precises.

Types de declencheurs

Operateurs de condition

• equals : Le champ correspond exactement (ex. : intent = "ACTIVE")
• greater_than : Comparaison numerique (ex. : aiScore > 7)
• contains : La chaine inclut une sous-chaine (ex. : keyword contient "CRM")
• in : Le champ est dans une liste (ex. : channel dans ["twitter", "linkedin"])
• not_empty : Le champ a une valeur (ex. : enriched.email n'est pas vide)

Authentification API

Toutes les requetes API necessitent une cle API transmise dans le header x-api-key.

x-api-key: your-api-key-here

Obtenir votre cle API

1. Allez dans Settings > API dans le tableau de bord Buska
2. Cliquez sur "Generate API Key"
3. Copiez la cle et conservez-la en lieu sur

Limites de requetes

GET /v1/usage

Retourne votre utilisation actuelle de l'API et les informations de plan.

Cas d'usage : Utilisez cet endpoint pour surveiller votre quota API avant de faire des requetes en masse, ou pour afficher les informations d'utilisation dans votre propre tableau de bord.

Requete

curl -H "x-api-key: YOUR_KEY" https://api.buska.io/api/v1/usage

Reponse

{
  "team": "Acme Corp",
  "plan": "growth",
  "usage": {
    "used": 45,
    "limit": 500,
    "remaining": 455
  }
}

Champs de la reponse

POST /v1/mentions/search

Recherchez des mentions sociales par mot-cle et plateforme. Retourne des leads scores correspondant a votre requete.

Cas d'usage : Utilisez cet endpoint pour rechercher des mentions sur une plateforme specifique en temps reel. Par exemple, recherchez sur Twitter les personnes mentionnant votre concurrent.

Parametres

Requete

curl -X POST https://api.buska.io/api/v1/mentions/search \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "project management tool", "platform": "twitter", "limit": 10}'

Reponse

{
  "results": [
    {
      "name": "Jane Smith",
      "channel": "twitter",
      "intent": "ACTIVE",
      "aiScore": 9,
      "aiReason": "Actively searching for a project management solution",
      "contentPreview": "Looking for a better project management tool for our remote team...",
      "postUrl": "https://twitter.com/janesmith/status/123456",
      "link": "https://twitter.com/janesmith",
      "keyword": "project management tool",
      "publishedAt": "2026-03-14T08:30:00Z"
    }
  ],
  "total": 1,
  "usage": { "used": 46, "limit": 500, "remaining": 454 }
}

POST /v1/leads/score

Evaluez n'importe quel contenu textuel pour l'intention d'achat. Transmettez un post social, un commentaire ou un message et recevez un score de qualification de lead par IA.

Cas d'usage : Utilisez cet endpoint pour qualifier du contenu de n'importe quelle source. Soumettez un post de reseau social et obtenez un score d'intention, un matching ICP et un raisonnement IA.

Parametres

Requete

curl -X POST https://api.buska.io/api/v1/leads/score \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Looking for a CRM that integrates with Slack", "keyword": "CRM"}'

Reponse

{
  "qualified": true,
  "score": 8,
  "intent": "ACTIVE",
  "icpMatch": "CTO",
  "reason": "Shows buying signal for CRM solutions"
}

Champs de la reponse

GET /v1/signals

Recuperez les leads qualifies avec des filtres. Retourne des resultats pagines tries par score (du plus eleve au plus bas).

Cas d'usage : Utilisez cet endpoint pour recuperer vos derniers leads qualifies dans votre propre tableau de bord, CRM ou outil d'analyse.

Parametres de requete

Requete

curl "https://api.buska.io/api/v1/signals?minScore=7&intent=ACTIVE&limit=10" \
  -H "x-api-key: YOUR_KEY"

Reponse

{
  "signals": [
    {
      "name": "Mike Chen",
      "channel": "reddit",
      "intent": "ACTIVE",
      "aiScore": 9,
      "aiReason": "Actively evaluating tools in this category",
      "icpMatch": "Head of Marketing",
      "contentPreview": "We need a tool that can track competitor mentions across social...",
      "postUrl": "https://reddit.com/r/saas/comments/abc123",
      "link": "https://reddit.com/u/mikechen",
      "keyword": "social listening",
      "publishedAt": "2026-03-14T07:45:00Z"
    }
  ],
  "total": 47,
  "limit": 10,
  "offset": 0,
  "usage": { "used": 47, "limit": 500, "remaining": 453 }
}

Installation du serveur MCP

Le serveur MCP (Model Context Protocol) de Buska permet aux assistants IA comme Claude d'acceder directement a vos donnees Buska. Il expose la recherche, le scoring et la recuperation de signaux sous forme d'outils que les agents IA peuvent appeler.

Configuration

Ajoutez la configuration suivante dans votre fichier de configuration du client MCP (ex. : claude_desktop_config.json pour Claude Desktop) :

{
  "mcpServers": {
    "buska": {
      "command": "npx",
      "args": ["-y", "@buska/mcp-server"],
      "env": {
        "BUSKA_API_KEY": "your-api-key"
      }
    }
  }
}

Prerequis

• Node.js 18 ou version ulterieure
• Une cle API Buska valide (plan Growth ou Scale)
• Un client IA compatible MCP (Claude Desktop, Claude Code ou similaire)

Tester la connexion

Apres avoir ajoute la configuration, redemarrez votre client IA. Vous devriez voir "buska" liste comme serveur MCP disponible. Essayez de demander : "Recherche sur Twitter les personnes qui cherchent un outil CRM."

Outils MCP disponibles

Le serveur MCP de Buska expose 3 outils que les assistants IA peuvent appeler :

1. search_mentions

Recherchez des mentions sociales par mot-cle et plateforme. Equivalent a l'endpoint API POST /v1/mentions/search.

2. score_lead

Qualification de leads B2B par IA. Equivalent a l'endpoint API POST /v1/leads/score.

3. get_signals

Recuperez les leads qualifies avec des filtres. Equivalent a l'endpoint API GET /v1/signals.

Exemple d'utilisation avec Claude

Une fois le serveur MCP connecte, vous pouvez poser a Claude des questions en langage naturel comme :

• "Recherche sur Twitter les personnes qui cherchent un outil CRM et evalue les resultats"
• "Trouve les 5 meilleurs leads chauds de LinkedIn cette semaine"
• "Evalue ce post Reddit pour l'intention d'achat : [coller le texte]"
• "Recupere tous les signaux ACTIVE avec un score superieur a 7 des dernieres 24 heures"

Exemple pratique : workflow multi-etapes avec agent IA

Essayez de poser a Claude une requete complexe qui chaine plusieurs outils :

Demandez a Claude : "Recherche sur Twitter les personnes qui cherchent un outil CRM, evalue les meilleurs resultats et montre-moi ceux avec une intention d'achat superieure a 70"

Claude va automatiquement :

1. Appeler search_mentions avec le mot-cle "CRM tool" sur Twitter
2. Appeler score_lead pour chaque resultat afin d'obtenir un scoring detaille
3. Filtrer les resultats dont le score depasse 70
4. Presenter un tableau recapitulatif avec les leads qualifies, leurs scores et le raisonnement

Besoin d'aide ?

Si vous avez des questions sur l'integration de Buska dans votre workflow, nous sommes la pour vous aider.

• Email : hello@buska.io
• Chat en direct : Disponible dans le coin inferieur droit de l'application
• Reservez une demo : Planifier un appel