Live Chat Documentation - Jetweb API Reference

Aperçu

Jetweb Live Chat fournit une solution complète de support client en temps réel pour les sites WordPress. Le widget de chat connecte les visiteurs à votre équipe de support via la messagerie WebSocket avec livraison instantanée et indicateurs de saisie.

Tous les messages sont automatiquement traduits entre les langues du visiteur et de l'agent grâce à la traduction par IA. Le système comprend un tableau de bord agent complet, des réponses prédéfinies, un historique des conversations et un système de tickets intégré pour le support hors ligne.

Fonctionnalités

Messagerie en Temps Réel

Messagerie instantanée alimentée par WebSocket avec indicateurs de saisie et confirmations de livraison.

Tableau de Bord Agent

Tableau de bord complet avec gestion des files d'attente, routage des conversations et collaboration d'équipe.

Widget Personnalisable

Widget de chat intégrable avec personnalisation du thème, contrôle de position et optimisation mobile.

Système de Tickets

Système de tickets intégré pour les messages hors ligne avec suivi des statuts et notifications par e-mail.

Traduction IA

Traduction automatique des messages entre 46 langues grâce à un moteur de traduction alimenté par l'IA.

Réponses prédéfinies

Modèles de réponses prédéfinis avec insertion par raccourci pour des réponses plus rapides des agents.

Widget de chat

Le widget Live Chat est un composant léger et intégrable qui peut être ajouté à n'importe quel site web. Il se connecte au serveur WebSocket Jetweb pour la messagerie en temps réel.

Options de personnalisation

Paramètre	Description	Par défaut
Position	Placement du widget sur la page	En bas à droite
Couleur du thème	Couleur principale de l'interface du widget	#00D4FF
Message de bienvenue	Salutation initiale affichée aux visiteurs	Bonjour ! Comment pouvons-nous vous aider ?
Mode hors ligne	Comportement lorsqu'aucun agent n'est disponible	Afficher le formulaire de ticket

Tableau de bord des agents

Le tableau de bord des agents sur agents.jetweb.app offre une interface complète pour gérer les conversations clients, visualiser la file d'attente et collaborer avec les membres de l'équipe.

Fonctionnalités du tableau de bord

File de conversations en temps réel avec informations sur les visiteurs et temps d'attente

Routage automatique et manuel des conversations entre agents

Historique complet des conversations avec fonctionnalités de recherche et de filtrage

Chat interne d'équipe pour la communication entre agents

Gestion des réponses prédéfinies avec catégories et raccourcis

Analyses de base incluant les temps de réponse et les métriques de conversation

Système de tickets

Lorsqu'aucun agent n'est disponible, les visiteurs peuvent créer des tickets de support. Les tickets sont suivis avec des mises à jour de statut et des notifications par e-mail.

Statuts des tickets

Ouvert

Nouveau ticket en attente de réponse d'un agent

En cours

Un agent travaille sur le ticket

Résolu

Le problème a été résolu

Fermé

Le ticket est fermé et archivé

WordPress Plugin

Le plugin Jetweb Live Chat WordPress intègre le widget de chat sur votre site WordPress avec un processus de configuration simple.

Installation

Téléchargez le plugin depuis votre tableau de bord Jetweb sous Live Chat > WordPress Plugin.

Dans WordPress, allez dans Plugins > Ajouter > Téléverser un plugin et sélectionnez le fichier ZIP.

Cliquez sur Activer une fois l'installation terminée.

Accédez à Réglages > Jetweb Live Chat dans l'administration de WordPress.

Saisissez votre clé API et votre jeton de site depuis le tableau de bord Jetweb.

Paramètres du Plugin

Paramètre	Description	Par défaut
Clé API	Votre clé API Jetweb pour l'authentification	Requis
Jeton de Site	Identifiant unique pour votre canal de chat	Requis
Position du Widget	Position du widget de chat sur la page	En bas à droite
Ouverture automatique	Ouvrir automatiquement le widget après un délai	Désactivé
Tickets hors ligne	Afficher le formulaire de ticket lorsqu'aucun agent n'est disponible	Activé

API REST

L'API REST Live Chat vous permet de gérer programmatiquement les conversations, d'envoyer des messages et de créer des tickets. Toutes les requêtes API nécessitent une authentification via une clé API.

Démarrer une conversation

                POST /chat/start
                
              

                POST https://livechat.api.jetweb.app/chat/start
Authorization: Bearer YOUR_API_KEY

{
  "site_token": "lc_abc123...",
  "visitor_name": "John",
  "visitor_email": "[email protected]"
}

# Réponse
{
  "success": true,
  "conversation_id": "conv_xyz...",
  "socket_url": "wss://livechat.api.jetweb.app"
}
              

Envoyer un message

                POST /chat/message
                
              

                POST https://livechat.api.jetweb.app/chat/message
Authorization: Bearer YOUR_API_KEY

{
  "conversation_id": "conv_xyz...",
  "message": "Hello, I need help with..."
}

# Réponse
{
  "success": true,
  "message_id": "msg_abc...",
  "timestamp": "2026-01-15T10:30:00Z"
}
              

Obtenir les conversations

                GET /chat/conversations
                
              

                GET https://livechat.api.jetweb.app/chat/conversations?status=active
Authorization: Bearer YOUR_API_KEY

# Réponse
{
  "conversations": [
    {
      "id": "conv_xyz...",
      "visitor_name": "John",
      "status": "active",
      "agent": "Agent Smith"
    }
  ]
}
              

Créer un ticket

                POST /tickets
                
              

                POST https://livechat.api.jetweb.app/tickets
Authorization: Bearer YOUR_API_KEY

{
  "site_token": "lc_abc123...",
  "name": "John",
  "email": "[email protected]",
  "subject": "Need help with setup",
  "message": "I am having trouble..."
}

# Réponse
{
  "success": true,
  "ticket_id": "TKT-1234",
  "tracking_url": "https://tickets.jetweb.app/TKT-1234"
}
              

Limites de débit

Limites de débit de l'API et quotas de plan pour le service Live Chat.

Plan	Agents	Chats simultanés	Historique des chats
Starter	1	5	30 jours
Pro	5	25	90 jours
Business	Illimité	Illimité	Illimité

Codes d'erreur

Code	Erreur	Description
400	Requête incorrecte	Corps de la requête invalide ou champs obligatoires manquants.
401	Non autorisé	Clé API manquante ou invalide.
403	Interdit	La clé API n'a pas la permission pour cette action.
404	Non trouvé	Conversation ou ticket non trouvé.
429	Trop de requêtes	Limite de débit dépassée. Réessayez après le délai spécifié.
500	Erreur interne du serveur	Erreur inattendue. Contactez le support si elle persiste.

FAQ

Live Chat utilise des connexions WebSocket via Socket.io pour la livraison instantanée des messages. Le widget établit une connexion persistante à notre serveur WebSocket, permettant une messagerie en temps réel avec indicateurs de saisie et confirmations de livraison.

Les messages sont automatiquement traduits entre les langues du visiteur et de l'agent grâce à notre moteur de traduction IA. Le système détecte la langue du visiteur à partir des paramètres de son navigateur et traduit les messages dans les deux sens en temps réel.

Lorsque tous les agents sont hors ligne, le widget passe automatiquement en mode ticket. Les visiteurs peuvent soumettre un ticket de support avec leur message, et les agents seront notifiés par e-mail. Le visiteur reçoit un lien de suivi de ticket.

Oui ! Bien que nous fournissions un plugin WordPress pour une intégration facile, le widget de chat peut être intégré sur n'importe quel site web en utilisant une simple balise script. Il vous suffit d'inclure le JavaScript du widget et de le configurer avec votre jeton de site.

Live Chat