Reliez FantomHunt à vos outils.

Démarrer : votre clé API

Tout passe par une clé fh_live_…, créée dans Réglages → API & Intégrations (incluse dans les plans payants). La clé s'affiche une seule fois : copiez-la à la création. Par défaut elle lit votre compte. Avec le droit « Modifier le CRM », elle change aussi vos fiches, vos tâches et vos affaires ; avec le droit « Envoyer », elle fait partir des messages, des invitations, des campagnes et des recherches, comme l'application ; avec le droit « Dépenser des crédits », elle rédige, score et trouve des coordonnées, sous deux plafonds mensuels que vous fixez.

1. 1Ouvrez Réglages → API dans votre espace FantomHunt, puis « Créer une clé ».
2. 2Nommez-la selon l’outil qui l’utilisera (« CRM », « Zapier »…). Cochez « Lire le texte des messages et des notes » seulement si cet outil doit lire le contenu des conversations, « Modifier le CRM » seulement s’il doit écrire dans FantomHunt, « Envoyer des messages et lancer des actions » seulement s’il doit agir auprès de vos prospects, et « Dépenser des crédits » (avec ses plafonds du mois) seulement s’il doit utiliser l’IA ou trouver des coordonnées. Copiez la clé.
3. 3Vérifiez-la avec l’appel ci-dessous : il répond votre compte.

curl -H "Authorization: Bearer fh_live_VOTRE_CLE" \
  https://api.fantomhunt.com/v1/moi

{
  "compte": { "email": "vous@entreprise.fr", "plan": "croissance", "cree_le": "…" },
  "cle": { "nom": "CRM", "prefixe": "fh_live_a1b2", "portee": "lecture", "droits": ["lecture"] },
  "credits": {
"ia": { "restants": 842, "par_mois": 1000 },
"contact": { "restants": 250.5, "par_mois": 300 }
  },
  "prospects": { "utilises": 1240, "limite": null },
  "invitations_linkedin": { "envoyees": 312, "par_mois": 800 }
}

Une clé par outil : chacune se révoque dans Réglages sans toucher les autres, et cesse de fonctionner à la requête suivante. Ses droits se choisissent à la création : lecture (toujours) ouvre les fiches, les dates et les compteurs ; messages ouvre en plus le texte des conversations et des notes ; crm permet de modifier le CRM et envoyer de faire partir des envois, credits de dépenser des crédits sous les plafonds de la clé (voir la référence de l’API). Pour changer les droits d’un outil, créez-lui une nouvelle clé et révoquez l’ancienne ; les plafonds de dépense, eux, se modifient dans Réglages sans changer de clé. Le plan du compte est revérifié à chaque appel : un compte repassé en gratuit perd l’accès, clé active ou non.

Recettes sans code

Le chemin le plus court : les webhooks FantomHunt parlent nativement à Zapier, Make ou n8n pour faire sortir vos données, et l’action « Webhooks by Zapier » (ou le module HTTP de Make) appelle l’API pour en faire entrer. Aucune application à installer, aucune ligne de code.

Remplir votre CRM (HubSpot, Pipedrive…) en cinq minutes

1. 1Dans Zapier, créez un Zap dont le déclencheur est « Webhooks by Zapier » → « Catch Hook ». Copiez l’URL fournie.
2. 2Dans FantomHunt, Réglages → API → Webhooks → « Ajouter un webhook » : collez l’URL et cochez vos événements (par exemple « Réponse reçue » et « Rendez-vous pris »).
3. 3Cliquez « Envoyer un test » : Zapier reçoit un message de bienvenue, preuve que la connexion marche. Pour que Zapier découvre les champs de la fiche, déclenchez ensuite un vrai événement — changez par exemple le statut d’un prospect si vous avez coché « Statut changé » — puis rechargez l’exemple dans Zapier.
4. 4Ajoutez l’action de votre CRM (créer ou mettre à jour un contact) et associez les champs : chaque livraison contient la fiche complète — nom, entreprise, poste, adresse LinkedIn, email et sa fiabilité, téléphone, statut, score, offre, étiquettes, campagnes en cours. Un événement WhatsApp ou email porte la fiche sous contact au lieu de prospect.
5. 5Activez le Zap. Votre CRM se remplit désormais tout seul, au fil des événements.

Prévenir votre équipe dans Slack

Même déclencheur « Catch Hook », avec l'événement « Réponse reçue » coché, puis l'action « Slack → Envoyer un message de canal » : « Martin Dupont (Acme) a répondu sur LinkedIn ». L'équipe voit chaque réponse arriver en direct.

Un registre Google Sheets qui se tient à jour

Cochez « Prospect ajouté » et branchez l’action « Google Sheets → Créer une ligne » : chaque nouvelle fiche devient une ligne, avec son entreprise, son score et sa source, quelle que soit la façon dont elle est arrivée. Pour un rapport hebdomadaire, interrogez plutôt GET /v1/stats depuis le tableur.

Faire entrer dans FantomHunt les contacts d’un formulaire ou de votre CRM

1. 1Créez une clé avec le droit « Modifier le CRM », nommée « Zapier ».
2. 2Dans Zapier, choisissez votre déclencheur (nouveau contact HubSpot, réponse Typeform, ligne de tableur…), puis l’action « Webhooks by Zapier » → « POST » vers https://api.fantomhunt.com/v1/prospects.
3. 3En-têtes : Authorization: Bearer fh_live_… et Idempotency-Key avec l’identifiant du déclencheur (un relancement de Zapier ne crée alors pas de doublon). Données : url_linkedin, et si vous voulez etiquettes_ajouter, offre_id ou note. Sans lien LinkedIn, utilisez /v1/contacts-email avec email et nom.
4. 4Testez : la réponse rend la fiche (201), ou deja_present si la personne était déjà là. La fiche LinkedIn se complète quand l’extension lit le profil.

Garder FantomHunt à jour quand une affaire avance dans votre CRM

Déclencheur « affaire gagnée » de votre CRM, puis deux actions « Webhooks by Zapier » : GET /v1/prospects?email=… retrouve la fiche, puis PATCH /v1/prospects/:id avec { "statut": "client" }. La personne sort de vos campagnes et son statut client suit sur WhatsApp et email, comme si vous l’aviez fait dans l’application. Le plus simple est de garder l’id FantomHunt dans votre CRM dès la première synchronisation : il est dans chaque webhook.

Piloter votre prospection depuis Claude ou ChatGPT

Branchez le serveur MCP avec une clé qui a les droits voulus, puis demandez en français : « qui m’a répondu cette semaine et que dois-je leur dire ? », « rédige une relance pour Camille et envoie-la sur LinkedIn », « passe l’affaire Skova en gagnée ». Votre assistant a pour consigne de vous annoncer le coût avant une action payante, et les outils qui modifient ou envoient se déclarent comme tels pour qu’il vous demande confirmation.