Documentation Nixia

Tout ce qu'il faut pour
intégrer Nixia

Guides, références et exemples pour déployer vos agents IA, connecter vos canaux et exploiter l'API Nixia — en moins de 5 minutes.

Démarrage rapide

Introduction

Nixia est une plateforme SaaS de CRM conversationnel. Elle vous permet de déployer des agents IA sur votre site web et vos canaux de communication en quelques minutes, sans expertise technique.

✅
Prérequis : Un compte Nixia actif et un abonnement (Starter, Pro ou Enterprise). Voir les tarifs →
Démarrage rapide

Installer le widget

Le widget Nixia s'intègre sur n'importe quel site web en collant un simple script.

1
Récupérez le script de votre agent
Connectez-vous à votre dashboard Nixia → Agents IA → sélectionnez votre agent → onglet Intégration. Le script unique à votre agent s'affiche, prêt à copier.
2
Collez le script dans votre HTML
Ajoutez ce code juste avant la balise </body> de votre site :
html
<!-- Chatbot Widget Integration Script -->
<!-- Intégration simple : Copiez et collez ce script dans votre site web -->
<script src="http://localhost:8000/api/v1/embed/NsgxdmNeZq5bwGASMkW8yRsnU1pTd1bv/chatbot.js"></script>
<!-- Fin du script chatbot -->
3
C'est tout !
Le widget apparaît automatiquement sur votre site. Apparence, couleur et message de bienvenue se configurent directement depuis le dashboard, sans toucher au code.
💡
Le widget est responsive et s'adapte automatiquement aux mobiles. Aucune configuration supplémentaire n'est nécessaire.
Démarrage rapide

Configurer l'agent

Depuis votre dashboard, personnalisez le comportement de votre agent IA.

ParamètreDescriptionExemple
Nom du botPrénom affiché dans le chat"Nixia"
TonStyle de communication de l'IA"professionnel", "amical"
Moteur IALLM utilisé pour les réponsesOpenAI GPT-4
Base de connaissancesFichiers alimentant l'IAPDF, JSON, Markdown, URL
Message de bienvenuePremier message affiché"Bonjour, comment puis-je aider ?"
Démarrage rapide

Tester en live

Avant de déployer, testez votre agent depuis le dashboard.

1
Accédez à la page de démo
Dashboard → Agents IA → Tester le widget. Une prévisualisation en temps réel s'affiche.
2
Posez des questions de test
Envoyez des messages simulant vos clients pour vérifier que les réponses sont correctes et cohérentes avec votre base de connaissances.
3
Ajustez si nécessaire
Si les réponses ne sont pas satisfaisantes, enrichissez votre base de connaissances ou affinez le prompt système de l'agent.
✅
Votre widget est prêt ! Collez le script sur votre site et vos visiteurs peuvent immédiatement interagir avec l'agent.
Authentification

JWT — Admins & Agents

Les administrateurs s'authentifient via JWT (JSON Web Token). Le token est valide 24h et se rafraîchit automatiquement.

javascript
// 1. Login pour obtenir un token JWT
const res = await fetch('http://localhost:8000/api/v1/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'admin@entreprise.com',
    password: 'votre_mot_de_passe'
  })
});

const { access_token } = await res.json();

// 2. Utiliser le token dans vos requêtes
const data = await fetch('http://localhost:8000/api/v1/admin/me', {
  headers: { 'Authorization': `Bearer ${access_token}` }
});
⚠️
Ne stockez jamais votre token JWT dans le code source. Utilisez des variables d'environnement ou un gestionnaire de secrets.
Authentification

API Key — Agents IA

Chaque agent IA possède une API Key unique, utilisée pour les intégrations directes (widget, scripts tiers).

javascript
// Authentification par API Key (pour les agents IA)
const res = await fetch('http://localhost:8000/api/v1/config/by-api-key', {
  headers: {
    'X-API-Key': 'YOUR_AGENT_API_KEY'
  }
});

const config = await res.json();
console.log(config);
HeaderValeurUsage
AuthorizationBearer {jwt}Endpoints admin
X-API-Key{api_key}Endpoints agents
Authentification

OAuth — Facebook & Instagram

La connexion Facebook Messenger et Instagram utilise le flux OAuth 2.0 via l'API Graph de Meta.

1
Obtenez l'URL d'autorisation
Appelez GET /api/v1/channels/facebook/auth-url pour obtenir l'URL OAuth.
2
Redirigez l'utilisateur
Redirigez vers l'URL Facebook pour qu'il autorise l'accès à sa page.
3
Traitez le callback
Nixia reçoit le callback automatiquement sur /api/v1/channels/facebook/callback.
javascript
// 1. Récupérer l'URL d'autorisation Facebook
const res = await fetch('/api/v1/channels/facebook/auth-url', {
  headers: { 'Authorization': 'Bearer YOUR_JWT_TOKEN' }
});
const { auth_url } = await res.json();

// 2. Rediriger vers Facebook OAuth
window.location.href = auth_url;

// 3. Après callback, connecter la page
await fetch('/api/v1/channels/facebook/connect-page', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ page_id: "FACEBOOK_PAGE_ID" })
});
Intégrations

Widget Web

Le canal le plus simple à déployer — aucune configuration côté infrastructure requise.

Widget Web
Disponible

Compatible avec tous les frameworks : React, Vue, Angular, WordPress, Shopify, Webflow, etc. Le script détecte automatiquement la langue du navigateur.

Pour une intégration React, vous pouvez aussi utiliser le hook dédié :

jsx
import { useNixia } from '@Nixia/react-widget';

export default function App() {
  const { open, close } = useNixia();
  return <button onClick={open}>Ouvrir le chat</button>;
}
Intégrations

WhatsApp Business

Connectez votre numéro WhatsApp Business pour recevoir et répondre aux messages directement depuis Nixia.

WhatsApp Business
Disponible
1
Créer une connexion WhatsApp
Depuis le dashboard → Canaux → Ajouter WhatsApp. Un QR code s'affiche.
2
Scanner le QR code
Ouvrez WhatsApp Business sur votre téléphone → Appareils liés → scannez le QR code.
3
Vérifier la connexion
Le statut passe à Connecté. Les messages entrants sont désormais gérés par votre agent IA.
javascript
// 1. Générer un QR code de connexion WhatsApp
const res = await fetch('/api/v1/channels/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    channel_type: "whatsapp",
    organization_id: "YOUR_ORG_ID"
  })
});

// 2. Scanner le QR code avec WhatsApp Business
const { qr_code, connection_id } = await res.json();
⚠️
La session WhatsApp peut expirer après inactivité prolongée. Nixia vous notifie automatiquement pour renouveler la connexion.
Intégrations

Facebook Messenger

Connectez votre page Facebook pour répondre automatiquement aux messages Messenger.

Facebook Messenger
Disponible

Vous devez être administrateur de la page Facebook à connecter. L'autorisation se fait via OAuth Meta.

javascript
// 1. Récupérer l'URL d'autorisation Facebook
const res = await fetch('/api/v1/channels/facebook/auth-url', {
  headers: { 'Authorization': 'Bearer YOUR_JWT_TOKEN' }
});
const { auth_url } = await res.json();

// 2. Rediriger vers Facebook OAuth
window.location.href = auth_url;

// 3. Après callback, connecter la page
await fetch('/api/v1/channels/facebook/connect-page', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ page_id: "FACEBOOK_PAGE_ID" })
});
💡
Les webhooks Meta sont configurés automatiquement par Nixia. Aucune action manuelle dans Meta Business Suite n'est requise.
Intégrations

Instagram Direct

Automatisez les messages directs Instagram via l'API Graph de Meta.

Instagram Direct
Bientôt disponible

L'intégration Instagram Direct sera disponible prochainement. Elle fonctionnera via le même flux OAuth que Facebook Messenger, car les deux utilisent l'API Graph de Meta.

💡
Prérequis : votre compte Instagram doit être un compte professionnel lié à une page Facebook.
Référence API

Vue d'ensemble

L'API Nixia est une API REST qui retourne des réponses JSON. Elle est conforme à la spécification OpenAPI 3.1.

PropriétéValeur
Base URLhttp://localhost:8000
SpécificationOpenAPI 3.1
Version0.1.0
AuthentificationJWT Bearer / API Key
FormatJSON
HTTPSObligatoire
Documentation interactive/docs (Swagger UI)
Explorer tous les endpoints
150+ endpoints · groupés par domaine · avec exemples
Référence API
Référence API

Codes d'erreur

Toutes les erreurs retournent un objet JSON structuré avec un code HTTP standard.

json
// Structure d'une réponse d'erreur
{
  "detail": "Description de l'erreur",
  "status_code": 401,
  "error_type": "UNAUTHORIZED"
}

// Codes HTTP retournés
// 200 OK           → Succès
// 201 Created      → Ressource créée
// 400 Bad Request  → Données invalides
// 401 Unauthorized → Token manquant ou expiré
// 403 Forbidden    → Permissions insuffisantes
// 404 Not Found    → Ressource introuvable
// 422 Unprocessable→ Validation échouée
// 429 Too Many Req → Quota dépassé
// 500 Server Error → Erreur interne
Référence API

Limites & Quotas

Les limites varient selon votre plan d'abonnement.

LimiteStarterProEnterprise
Messages/mois1 00010 000Illimité
Agents IA13Illimité
Utilisateurs210Illimité
Fichiers base de connaissances550Illimité
Canaux connectés1 (Widget)TousTous + API custom
Rate limit API60 req/min300 req/minSur mesure
💡
En cas de dépassement de quota, l'API retourne une erreur 429 Too Many Requests. Consultez votre dashboard pour suivre votre consommation en temps réel.