Documentation API — sem.chat | API REST pour les développeurs

Premiers pas

L'API sem.chat vous permet de gérer par programmation les conversations, d'envoyer des messages et d'accéder analytique. Toutes les requêtes API nécessitent une authentification à l'aide d'une clé API.

URL de base

https://api.sem.chat/v1

Authentification

Incluez votre clé API dans l'en-tête Autorisation de toutes les requêtes :

Authorization: Bearer your_api_key_here

Conversations

Répertorier les conversations

GET /conversations

Récupérez une liste de toutes les conversations de votre compte.

Paramètre	Type	Descriptif
limite	entier	Nombre de résultats à renvoyer (max 100)
décalage	entier	Nombre de résultats à ignorer Statut
	chaîne	Filtrer par statut : actif, fermé, en attente

Obtenir une conversation

GET /conversations/{id}

Récupérer les détails d'une conversation spécifique, y compris tous les messages.

Créer une conversation

POST /conversations

Démarrez une nouvelle conversation par programmation.

Messages

Envoyer un message

POST /conversations/{id}/messages

Envoyer un message à une conversation existante.

// Example request body
{
  "content": "Hello, how can I help you today?",
  "sender": "agent"
}

Webhooks

Configurez des webhooks pour recevoir des notifications en temps réel sur les événements de conversation.

Événements disponibles

Événement	Descriptif
conversation.démarrée	Une nouvelle conversation a été lancée
message.reçu	Un nouveau message a été reçu d'un visiteur
conversation fermée	Une conversation a été fermée
prospect.capturé	Les coordonnées ont été collectées

Limites de débit

Les requêtes API sont limitées pour garantir une utilisation équitable :

Forfait	Limite de débit
Essai	100 requêtes/heure
Professionnel	1 000 requêtes/heure
Entreprise	10 000 requêtes/heure