Documentation Trumflow

Tout ce dont vous avez besoin pour intégrer Trumflow dans vos outils. API REST, webhooks, et SDK.

Démarrer gratuitement Voir les intégrations

Démarrage rapide

5 min

Ajoutez Trumflow à votre site en 1 ligne de code. Compatible avec tout site HTML, Shopify, WordPress, Webflow et Next.js.

1. Installez le widget

<!-- Add before </body> — that's it -->
<script
  src="https://www.trumflow.com/widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
></script>

Remplacez YOUR_CHATBOT_ID par l'ID trouvé dans Dashboard → Settings → Chatbot. Le widget apparaît immédiatement.

2. Entraînez votre IA (optionnel)

Dashboard → Settings → Training → ajoutez des URLs, PDFs, ou texte. Votre chatbot répondra avec vos données exactes.

Authentification

Toutes les requêtes API doivent inclure un token Bearer dans le header Authorization.

# Use Supabase Auth to get your session token:
curl -X POST https://xxxxxxxx.supabase.co/auth/v1/token?grant_type=password \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_SUPABASE_ANON_KEY" \
  -d '{"email": "you@company.com", "password": "yourpassword"}'

# Response includes access_token — use it as your Bearer token

Sécurité

Ne jamais exposer votre token dans le code client. Utilisez des variables d'environnement côté serveur.

Chat API

POST/api/chat

Envoyez un message au chatbot et recevez une réponse IA. Peut continuer une conversation existante.

POST /api/chat
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "chatbotId": "chatbot_abc123",
  "message": "I need help with my order",
  "visitorId": "visitor_xyz",        // optional
  "conversationId": "conv_123"       // optional, for continuing a chat
}

# Response:
{
  "message": "Of course! Please share your order number.",
  "conversationId": "conv_456",
  "leadScore": 72
}

Leads API

GET/api/leads

Récupérez et gérez les leads qualifiés par votre IA.

GET /api/leads
Authorization: Bearer YOUR_TOKEN

# Query params:
?status=hot&score_min=70&limit=50&offset=0

# Response:
{
  "leads": [
    {
      "id": "lead_abc",
      "name": "Marie Dupont",
      "email": "marie@example.com",
      "score": 87,
      "stage": "qualified",
      "channel": "whatsapp",
      "created_at": "2026-05-28T10:00:00Z"
    }
  ],
  "total": 142
}

Webhooks

Recevez des événements en temps réel quand une action se produit dans Trumflow. Configurez l'URL dans Dashboard → Settings → Integrations → Webhooks personnalisés.

Événements disponibles

new_lead

new_conversation

lead_score_change

booking_created

automation_triggered

whatsapp_message

// Your endpoint receives:
POST https://yoursite.com/webhook
Content-Type: application/json
X-Trumflow-Signature: sha256=abc...

{
  "event": "new_lead",
  "data": {
    "id": "lead_abc",
    "name": "Marie Dupont",
    "email": "marie@example.com",
    "score": 87,
    "channel": "web"
  },
  "tenant_id": "tenant_xyz",
  "timestamp": "2026-05-28T10:00:00Z"
}

Intégrations

Consultez la page intégrations complète pour les guides WhatsApp (Twilio), Shopify, Calendly, HubSpot et Zapier.

Voir toutes les intégrations →