Guide d'intégration

Make.com

Capture des leads depuis Facebook Lead Ads, Typeform, Webhook custom via le module HTTP de Make — pas-à-pas avec captures d'écran.

Configuration

Crée un scénario avec ta source en trigger et le module HTTP > Make a request en action.

Créer un nouveau scénario

Dans Make.com, clique Create a new scenario. Choisis un trigger (Facebook Lead Ads, Webhook custom, Typeform — selon ta source).

Ajouter le module HTTP

Après le trigger, ajoute le module HTTP > Make a request. Pas le module générique "Webhook response" — celui-ci est pour recevoir, pas envoyer.

Configurer URL, méthode et headers

URL : https://app.capturia.io/api/v1/leads/capture

Method : POST

Headers :

Authorization : Bearer cap_live_xxxxxxxx
Content-Type : application/json

Body type : Raw

Content type : JSON (application/json)

Construire le body JSON

Dans Request content, écris le JSON littéral avec les variables Make entre {{ }} :

{
  "phone": "{{1.phone_number}}",
  "sms_consent": true,
  "first_name": "{{1.first_name}}",
  "email": "{{1.email}}",
  "source_label": "make_scenario",
  "utm": {
    "source": "{{1.utm_source}}",
    "campaign": "{{1.utm_campaign}}"
  }
}

{{1.fieldname}} réfère au module 1 (le trigger). Adapter selon le numéro de module dans ton scénario.

Capturer le consentement SMS

Si ta source a un champ de consentement, mappe-le : "sms_consent": "{{1.consent_field}}" (Capturia accepte true, "yes", "oui", etc.).

Si pas de champ source, hardcode "sms_consent": true mais conserve une preuve externe (case landing page, copie d'archive). Voir la section LCAP plus bas.

Tester et activer

Clique Run once pour exécuter le scénario sur le dernier lead trigger. Vérifie le module HTTP : output 200 avec body { "status": "created", ... } confirme la connexion. Active le scénario via le toggle ON en bas à gauche.

Mapping des champs

Le mapping ci-dessous est pour un trigger Facebook Lead Ads. Pour d'autres triggers (Typeform, Webhook custom), adapter les noms de champ — la cible Capturia reste identique.

Champ Capturia	Obligatoire	Champ source	Notes
phone	Oui	{{1.phone_number}}	E.164 (+15145551234), NANP 10 ou 11 chiffres, ou formattés (514) 555-1234 / 514-555-1234. Les 10 chiffres sont auto-préfixés +1.
sms_consent	Oui	{{1.consent}} ou true	Boolean true OU string 'true' / 'yes' / 'oui' / 'vrai' / '1' / 'on' / 'checked' (insensible à la casse). Accepté à la racine du body ou dans l'objet `customData` (webhooks GoHighLevel).
first_name	Non	{{1.first_name}}	Prénom du lead
last_name	Non	{{1.last_name}}	Nom de famille
email	Non	{{1.email}}	Email valide RFC 5322
source_label	Non	"make_scenario"	Étiquette libre (ex. 'webflow_form', 'fb_lead_ads')
utm.source	Non	{{1.utm_source}}	Objet utm imbriqué (pas flat)
utm.medium	Non	{{1.utm_medium}}	Objet utm imbriqué
utm.campaign	Non	{{1.utm_campaign}}	Objet utm imbriqué
tags	Non	[]	Tableau de strings
pipeline.id	Non	(optionnel)	UUID du pipeline cible
pipeline.stage_id	Non	(optionnel)	UUID du stage cible

Consentement SMS — LCAP / Loi 25

Le champ sms_consent est obligatoire. La loi canadienne anti-pourriel (LCAP/CASL) et la Loi 25 québécoise exigent un consentement explicite avant tout SMS commercial. Capturia conserve une trace horodatée de cette attestation pour ta protection légale.

Pattern recommandé — consentement capturé à la source

Ajoute une question custom de consentement directement dans le formulaire source (FB Lead Form custom question, champ Typeform, case GHL form). Mappe ce champ vers sms_consent. Le consentement est explicite, daté, et lié au lead qui l'a donné.

Pattern alternatif — case sur la landing page

Si le formulaire source ne permet pas de question custom, ajoute une case à cocher de consentement sur la landing page qui précède la pub. Conserve une copie de la page (Wayback Machine, screenshot daté) en preuve.

Zone grise légale

Hardcoder sms_consent: true sans attestation réelle du lead = risque légal. En cas de plainte, Capturia peut être tenue de fournir la preuve du consentement. Sans preuve, la responsabilité revient au PO de la PME.

Test step-by-step

Catalogue d'erreurs

Code	Erreur	Cause	Fix
401	missing_api_key	Header Authorization absent ou mal formé	Ajouter le header `Authorization: Bearer cap_live_...`
401	invalid_api_key	Clé révoquée, expirée ou typo	Vérifier la clé dans le dashboard, en générer une nouvelle si nécessaire
403	terms_acceptance_required	CGU pas acceptées (ou bump de version forcant un ré-consent)	Le PO de la PME doit re-accepter les CGU dans le dashboard
403	insufficient_scope	La clé n'a pas le scope `leads:capture`	Créer une nouvelle clé avec le preset 'Capture de leads'
422	invalid_phone	Format téléphone non reconnu	Utiliser E.164 (+15145551234) ou NANP 10 chiffres (5145551234)
422	missing_consent	sms_consent absent, false, ou valeur non reconnue — le champ est cherché à la racine du body ET dans l'objet `customData` (GHL)	Mapper le champ de consentement vers sms_consent (true / yes / oui). Depuis GHL : valeur fixe `true` derrière une condition sur la checkbox de consentement
422	invalid_payload	Autre champ mal formé (email, utm objet vs flat, etc.)	Vérifier le format du body — voir la doc API leads:capture
429	rate_limited_key	Quota par clé dépassé (souvent 100 req/min)	Throttler côté source, ou demander un upgrade de tier au support
429	rate_limited_ip	Quota par IP dépassé	Réduire le débit ou contacter le support
400	invalid_payload	Body n'est pas du JSON valide (Form ou form-urlencoded à la place)	Configurer Payload Type = JSON / Content-Type = application/json

FAQ — pièges récurrents

Symptôme	Cause
Test plateforme vert (200 OK) mais le lead n'apparaît pas dans le pipeline	Téléphone identique à un contact existant — réponse `status: idempotent_replay`. Le lead existe déjà mais n'est pas dupliqué. Le mode test sandbox réutilise souvent le même numéro.
400 "Body is not valid JSON"	Payload Type configuré sur Form au lieu de JSON, ou body envoyé en x-www-form-urlencoded au lieu d'application/json.
Réponse 200 OK mais pas de SMS envoyé au lead	sms_consent: true mais agent IA non configuré, ou agent IA SMS désactivé, ou pas de numéro Twilio provisionné côté client.
Lead créé sans tracking UTM	Champ utm envoyé en flat (utm_source) au lieu d'objet imbriqué (utm.source). Le serveur attend un objet.
403 terms_acceptance_required après une mise à jour qui marchait avant	Bump de version CGU côté Capturia force le PO de la PME à re-accepter dans le dashboard avant que la clé refonctionne.