GET/api/public/widget/history
Charge l'historique des messages précédents d'une conversation du widget, par exemple après le rechargement de la page.
Transmettez `widget_code`, `session_id` et `visitor_id` comme paramètres de requête. La réponse contient, dans l'objet `data`, la liste `messages` avec `role` (`user` ou `assistant`), `text` et `created_at` dans l'ordre de la conversation. L'appel est en lecture seule et idempotent. L'en-tête `X-Widget-Token` avec le jeton d'intégration et `widget_code` sont requis. Si le jeton est manquant, le serveur répond 401 `WIDGET_TOKEN_MISSING`, s'il est invalide 401 `WIDGET_TOKEN_INVALID` ; les appels provenant de domaines non autorisés reçoivent 403 `WIDGET_ORIGIN_DENIED`, un widget désactivé 404 `WIDGET_DISABLED`. Si `session_id` ou `visitor_id` sont manquants, le serveur répond 400 `PARAMS_REQUIRED`. Si la session n'est plus connue, commencez une nouvelle conversation.
Vue d'ensemble
Appel : GET /api/public/widget/history. Ce point de terminaison appartient au groupe « Widget de chat » de l'API de Zentor App. Il nécessite un jeton d'intégration de widget valide. L'appel est idempotent : des appels répétés avec les mêmes données renvoient le même résultat. Paramètres obligatoires : widget_code (query), session_id (query), visitor_id (query). Cas d'erreur documentés : 400 PARAMS_REQUIRED. L'exemple de réponse ci-dessous montre la structure d'une réponse réussie au format JSON.
Authentification et sécurité
Jeton d'intégration du widget (en-tête X-Widget-Token) + liste d'origines autorisées
Idempotent: Oui
Paramètres
widget_code(query, string, requis)— Code du widget provenant de votre code d'intégrationsession_id(query, string, requis)— Identifiant de session de la conversation issu de la réponse de `message`visitor_id(query, string, requis)— Identifiant visiteur généré par le widget et stocké dans le navigateurExemple de réponse
{"ok":true,"data":{"messages":[{"role":"user","text":"Bonjour...","created_at":"..."},{"role":"assistant","text":"...","created_at":"..."}]}}Codes d'erreur
400 PARAMS_REQUIRED — `session_id` ou `visitor_id` est manquant.Comportement vérifié
Une session existante renvoie 200 avec l'historique des messages ; des paramètres manquants renvoient 400 `PARAMS_REQUIRED`.
Widget de chat
GET /api/public/widget/healthVérification simple de disponibilité du service de widget.GET /api/public/widget/config/:widget_codeFournit la configuration publique d'un widget (nom d'affichage, message de bienvenue, design, langue, fonction vocale) pour l'initialisation dans le navigateur.POST /api/public/widget/messageEnvoie un message du visiteur au chatbot et renvoie sa réponse – le point de terminaison central du widget de chat.POST /api/public/widget/pollRécupère les messages reçus après un instant donné – par exemple la réponse d'un collaborateur ayant repris la conversation.POST /api/public/widget/ratingEnregistre l'évaluation du visiteur sur une conversation (utile ou non utile).POST /api/public/widget/trackEnregistre un événement d'utilisation anonyme du widget (p. ex. « widget ouvert ») pour les analyses dans le tableau de bord.POST /api/public/widget/voice-transcribeConvertit un enregistrement vocal du visiteur en texte (saisie vocale), si la fonction vocale est activée pour le widget.POST /api/public/widget/voice-speakConvertit un texte en parole (sortie vocale dans le widget), si la fonction vocale est activée.