Aide — Qualifai

💬

Connecter ManyChat

Envoie automatiquement chaque DM Instagram à Qualifai pour qualification GPT-4o

Récupère ton URL webhook dans Qualifai

Dans Qualifai, clique sur Webhooks dans le menu gauche. Tu verras ton URL et le JSON à copier-coller directement.

✅ Qualifai → Webhooks : ton URL unique + le body JSON prêt à copier

Dans ManyChat → Automation → Instagram Default Reply

Va dans Automation → ouvre le flow Instagram Default Reply. C'est le flow qui se déclenche automatiquement quand quelqu'un t'envoie un DM.

Clique sur l'étape Actions, puis sur External Request (déjà configuré si tu vois l'URL Qualifai).

ManyChat → Automation → Instagram Default Reply → Actions → External Request

Configure l'External Request — Headers

Dans la fenêtre Edit Request :

Champ	Valeur
Request Type	POST
Request URL	Colle l'URL Qualifai
Header Key	Content-Type
Header Value	application/json

Onglet "Body" — colle le JSON avec les variables

Clique sur l'onglet Body et colle ce JSON (les étiquettes bleues sont les variables ManyChat — elles se remplissent automatiquement) :

Les variables bleues (Full Name, Instagram Username…) sont remplacées automatiquement par les vraies données du contact

⚠️ Le message "Invalid JSON / Variables are not defined" à droite est normal en mode édition — ça fonctionne parfaitement en production.

Clique Save → Publish → Teste

Sauvegarde, publie le flow, puis envoie un DM Instagram à ton compte. Le lead apparaît dans Qualifai en quelques secondes avec son score 🔥 Hot / 🌡️ Warm / ❄️ Cold.

✅ ManyChat n'envoie le webhook qu'une seule fois par conversation (au premier message). Les messages suivants du même contact mettent à jour le lead existant.

🟠

Connecter HubSpot

Chaque lead scoré par Qualifai est créé ou mis à jour dans HubSpot automatiquement

Va dans Paramètres HubSpot → Intégrations

Connecte-toi sur app.hubspot.com. Clique sur l'icône ⚙️ Paramètres en haut, puis dans le menu gauche clique sur Intégrations.

⚙️ Paramètres → Intégrations (dans le menu gauche)

Ouvre "Applications privées" et crée une app

Dans Intégrations → Applications privées, clique "Créer une application privée". Donne-lui un nom (ex: Qualifai).

ℹ️ L'option Applications privées est disponible sur les comptes HubSpot payants. Si tu ne la vois pas, cherche Clés de service ou passe sur un plan Starter ou supérieur.

Active les portées (Scopes) nécessaires

Dans l'onglet Portées de ton app, active :

Portée	Accès
crm.objects.contacts	Lecture + Écriture
crm.schemas.contacts	Lecture + Écriture

Copie le token d'accès

Une fois l'app créée, copie le Token d'accès qui commence par pat-eu1-... ou pat-na1-....

⚠️ Ce token ne s'affiche qu'une seule fois. Copie-le immédiatement avant de fermer la page.

Colle le token dans Qualifai

Dans Qualifai → Intégrations CRM → clique Connecter sur HubSpot → colle ton token → valide.

✅ Qualifai → Intégrations CRM : HubSpot connecté (indicateur vert)

✅ Qualifai crée automatiquement les propriétés HubSpot nécessaires (Score, Raison, Instagram, Tags) dès la connexion.

🔵

Connecter Airtable

Tes leads Qualifai synchronisés dans ta base Airtable en temps réel

Va sur airtable.com/create/tokens

Connecte-toi à Airtable, puis accède directement à airtable.com/create/tokens (ou via le menu Développeurs → Jetons d'accès personnels).

Clique sur "+ Créer un jeton".

airtable.com/create/tokens → "+ Créer un jeton"

Configure le token : nom + portées + accès à ta base

Dans le formulaire de création :

Champ	Valeur
Nom	Qualifai
Portées à ajouter	data.records:read, data.records:write, schema.bases:read, schema.bases:write
Accès	Clique "+ Ajouter une base" et sélectionne ta base Leads

⚠️ Copie le token immédiatement après création — il ne sera plus visible après fermeture de la page.

Trouve ton Base ID dans l'URL Airtable

Ouvre ta base Airtable dans le navigateur. L'URL ressemble à :

airtable.com/appja4lQVZAE6PJ3K/tblXXXXXX/...

Le Base ID, c'est la partie qui commence par app — juste après airtable.com/.

Ta base Airtable — le Base ID (appXXX) se trouve dans l'URL du navigateur

Connecte Airtable dans Qualifai

Dans Qualifai → Intégrations CRM → clique Connecter sur Airtable. Il te demande 2 informations :

{"token": "patXXXXXXXXXXXXXX", "base_id": "appXXXXXXXXXXXXXX"}

💡 Colle les deux valeurs dans le champ. Qualifai va automatiquement tester la connexion et créer les colonnes nécessaires dans ta table.

Colonnes créées automatiquement dans ta base

Qualifai ajoute ces colonnes dans ta table Airtable (si elles n'existent pas déjà) :

Colonne	Contenu
Nom complet	Prénom + Nom du lead
Email / Téléphone / Adresse	Infos de contact
Score Qualifai	HOT / WARM / COLD
Raison du score	Explication GPT-4o
Instagram Handle	@username Instagram
Tags Qualifai	Tags générés automatiquement

✅ Chaque nouveau lead est ajouté à Airtable. Si le lead revient, sa fiche est mise à jour — aucun doublon.