Capturia / docs
EN

API v1 · Publique

Démarrage rapide

Capture tes premiers leads via l'API Capturia en 5 minutes. Aucun support à contacter.

  1. 1Créer une clé API

    Dans le dashboard Capturia, va dans Administration → Compte → Clés API. Clique Créer une clé, donne-lui un nom (ex. Funnel Webflow), choisis le preset Capture de leads, et accepte les Conditions CASL/Loi 25. La clé apparaît une seule fois — copie-la maintenant.

  2. 2Vérifier que la clé fonctionne

    Avant tout, teste avec GET /v1/me qui retourne les infos de la clé sans rien modifier. Si tu reçois 200 OK, ta clé est valide.

    curl -X GET 'https://app.capturia.io/api/v1/me' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json'

  3. 3Capturer ton premier lead

    Le lead doit avoir donné son consentement explicite SMS (CASL/Loi 25). Capturia conserve une trace horodatée de cette attestation.

    phone — Formats acceptés : E.164 (+15145551234), NANP 10 chiffres (5145551234), NANP 11 chiffres (15145551234), ou formattés ((514) 555-1234, 514-555-1234). Les numéros à 10 chiffres sont automatiquement préfixés +1.

    sms_consent — Accepte true (booléen) ou les chaînes "true", "yes", "oui", "vrai", "1", "on", "checked" (insensible à la casse). Utile pour les form-builders (Zapier, Make, HubSpot) qui stringifient les booléens.

    curl -X POST 'https://app.capturia.io/api/v1/leads/capture' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json' \
  -d '{
  "phone": "+15145551234",
  "first_name": "Marie",
  "last_name": "Tremblay",
  "sms_consent": true,
  "source_label": "webflow_form"
}'

  4. 4Vérifier l'arrivée dans Mes Prospects

    Le lead apparaît immédiatement dans Mes Prospects dans le dashboard. Si configuré, l'agent IA pré-suasion SMS lance le premier message dans les 30 secondes.

  5. 5Aller plus loin

    Voir Authentification pour le détail des scopes et presets, Conventions pour idempotency, pagination et erreurs, ou Référence API pour les 29 endpoints.

Connecteur MCP

Connecter Capturia à ton assistant IA

Capturia expose un serveur MCP (Model Context Protocol), le standard qui branche les assistants IA comme Claude et ChatGPT sur tes logiciels. Une fois connecté, tu demandes — au texte ou à la voix depuis ton téléphone : « Combien de RDV j'ai aujourd'hui ? », « Trouve-moi le contact Jean Bouchard », « C'est quoi l'état de mon pipeline ? » — et ton assistant répond avec tes vraies données Capturia, après t'avoir demandé la permission d'utiliser chaque outil.

Ce que ton assistant peut consulter

  • Tes rendez-vous du jour, en ordre chronologique.

  • Tes leads récents, du plus nouveau au plus ancien.

  • Le résumé de ton pipeline : chaque étape avec son nombre de deals et leur valeur.

  • La recherche d'un contact par nom, courriel ou entreprise — « Jean Bouchard » trouve prénom + nom, peu importe l'ordre.

  • Tes conversations avec tes agents IA — résumés seulement, jamais le contenu des messages.

  • L'usage de ta clé API : permissions, limite horaire, volume d'appels.

Avec une clé Lecture seule, ton assistant consulte sans rien pouvoir modifier. Avec une clé Lecture + écriture, il agit aussi — une fiche à la fois : créer un contact, booker un RDV, ajouter ou retirer un tag, déplacer un contact dans le pipeline, préparer un brouillon de SMS ou de courriel. Avec une clé Intégration complète, il peut aussi préparer une campagne SMS de relance — mais jamais l'envoyer seul : il te présente l'audience réelle (après consentement), le coût en crédits et des exemples du message, et rien ne part sans ta confirmation explicite (jeton à usage unique, expire en 10 minutes). L'envoi reste toujours un geste humain.

Deux façons de se connecter

OAuth — avec ton compte Capturia

Ajoute un connecteur personnalisé dans ton assistant avec l'URL du serveur, c'est tout : une fenêtre Capturia s'ouvre, tu te connectes avec ton compte habituel et tu autorises l'accès. Aucune clé à copier. L'accès accordé équivaut au preset Lecture seule.

Clé API — pour les intégrations pilotées

Crée une clé avec le preset Lecture seule (consultation) ou Lecture + écriture (actions) dans Administration → Compte → Clés API, puis fournis-la au connecteur dans l'en-tête Authorization. La clé se révoque en tout temps — l'assistant perd l'accès immédiatement.

# URL du serveur MCP
https://app.capturia.io/api/mcp

# Mode clé API seulement — en-tête d'autorisation
Authorization: Bearer cap_votre_cle

Le détail des scopes et presets vit dans Authentification.

Bloqué ?

Le Catalog d'erreurs liste tous les codes avec un hint d'action. Si vraiment ça coince, contact support.