Documentation Dydu
EnglishFrench
  • Un même logiciel, de multiples applications
  • Guide de première utilisation
    • Prise en main
    • Créer votre bot
    • Créer votre première connaissance
    • Créer et publier votre chatbot
    • Cas d'utilisation fréquents
    • Bonnes pratiques
    • Glossaire
  • Contenus
    • Connaissances
      • Gestion des connaissances
      • Gestion des thématiques
      • Types de connaissances
        • Réponse à une question
        • Réponse complémentaire
        • Réponse prédéfinie
        • Ciblage comportemental
        • Slot filling
      • Eléments de réponse
      • Accessibilité des réponses des bots
      • Arbre de décision
      • Commentaires
      • Tester le bot
      • Alertes qualité
    • Carte des connaissances
    • Groupes de formulations
    • Phrases générales
    • Langues / espaces
    • Conditions de contexte
    • Contenus externes
      • LLM : comment configurer chaque type de modèle ?
      • VertexAI Gemini
    • Galerie
    • Services Web
      • Exemples de configuration (REST)
      • Configurer l’OIDC sur keycloack pour un Service Web
      • Questions Fréquentes
    • Avancé
      • Scripts serveurs
      • Modèles de réponse prédéfinis
      • Variables
      • Déclencheurs de web services
      • Top connaissances
    • Outils
    • Import/Export de connaissances
  • Apprentissage
    • Conversations
    • Suggestions
    • Phrases incomprises
  • Statistiques
    • Exploitation
      • Important
      • Conversations
      • Visiteurs
      • Thématiques
      • Connaissances
      • Qualification
      • Avis des utilisateurs
      • Liens cliqués
      • Reformulations
      • Performance
      • Autres
    • Livechat
      • Conversations
      • Connaissances
      • Opérateurs
      • Satisfaction
      • Files d'attente
    • Base de connaissances
      • Formulations
      • Utilisateurs
      • Matches
    • Export
    • Configuration
  • Statistiques personnalisées
    • Rapports
    • Alertes
    • Configuration
      • Rapports
      • Exports
      • Sources prédéfinies
      • Alertes
      • Préférences
      • Annexe : liste des indicateurs
  • Livechat
    • Activer le livechat
    • Configuration de la base de connaissances
    • Livechat DYDU
      • Aperçu des interfaces
        • Interface opérateur
        • Interface manager
      • Configuration livechat DYDU
        • Configuration générale
        • Compétences
        • Files d'attente
          • Général
            • Mise en place de la file d'attente
          • Compétence
            • Mise en place de la file d'attente par compétence
            • Mise en place d'une connaissance avec la file d'attente par compétence
        • Capacité de l'opérateur
        • Paramètres de compte
    • Connecteur Livechat Genesys
  • Intégrations
    • FAQ
      • FAQ statique
      • FAQ dynamique
    • MetaBot
    • Actions javascript
    • Règles personnalisées du ciblage comportemental
    • Canaux
      • Chatbox
        • Intégration d'une chatbox dans une webview
      • Customisation avancée
        • Éditeur Css
          • Teaser
            • Modification CSS teaser
          • Header
            • Modification CSS header
          • Body
            • Modification CSS body
        • Éditeur JS Custom
        • Gestion des libellés
        • Intégrations possibles
      • Connecteurs
        • Teams
        • Meta
          • Messenger
          • Instagram
          • WhatsApp
          • Fonctionnalités et compatibilité META
          • Contrôle d'application Meta
    • LLM - IA générative
  • Préférences
    • SAML 2
    • OpenID Connect (OIDC)
    • Droits et utilisateurs
    • Bot
      • Général
      • Conversations
      • Questionnaires
      • URLs
      • Champ de recherche
  • Autres
    • Comment fonctionne votre bot?
    • Protection des données
      • Politique de gestion des cookies
    • Console des logs
    • Mots-clés spéciaux
    • Aspects techniques
      • Hébergement
      • Infrastructure
    • Sécurité
      • Informations générales
      • Usage des serveurs
      • Outils open source
      • Expiration session utilisateur
  • Développeurs
    • Référence API
      • Authentification
      • Boîte de dialogue API
      • Export des Conversations
      • Champ de recherche
      • Import/Export du bot
      • Import/Export Base de connaissances
      • API de statut du serveur
      • Accès aux APIS
      • Gestion des utilisateurs du BMS
    • Chatbox V5
      • Mise en place et intégration
  • Release Note
Propulsé par GitBook

Tous droits réservés @ 2023 dydu.

Sur cette page
  • Configuration d'un webservice
  • Configurer un certificat pour un webservice
  • Authentification au service web
  • Entêtes du service web
  • Paramètres
  • Variables de résultats

Cet article vous a-t-il été utile ?

  1. Contenus

Services Web

PrécédentGalerieSuivantExemples de configuration (REST)

Dernière mise à jour il y a 10 mois

Cet article vous a-t-il été utile ?

Note : Seuls les utilisateurs avec les droits Administrateur ou Super User peuvent accéder à cette page.

Il est possible de configurer des services web pour y faire appel durant les conversations. Dirigez-vous sur la page Contenus > Web services pour accéder à la page de configuration. Cette page permet de créer un service web REST ou service web SOAP depuis un WSDL. Vous pouvez choisir entre les deux méthodes en cliquant sur le bouton Ajouter puis sélectionnez le type de webservice.

La configuration/modification d'un web service est divisée en plusieurs parties :

  • Configuration ;

  • Certificat du service web;

  • Authentification au service web ;

  • Entêtes du service web ;

  • Paramètres ;

  • Variables de résultat ;

  • Boutons d'actions.

Configuration d'un webservice

Note : Une fois le service créé, il n'est pas possible de modifier le type du service web (REST ou SOAP). Cependant, tous les autres champs sont modifiables.

  • Le champ Nom permet de configurer le nom du service web, qui sera utilisé pour l'appeler dans la base de connaissances.

  • Le champ URL permet de configurer l'URL du service web. Ce doit toujours être une constante.

  • Le champ Cache permet de configurer la durée du cache du service web. La valeur 0 supprime le mécanisme de cache.

  • Le champ Timeout permet de configurer la durée du timeout du service web. La valeur 0 laisse un timeout standard d'une requête HTTP.

  • Le champ Méthode HTTP permet de configurer le type de requête : GET / POST / PUT / DELETE / PATCH. Ceci est surtout utile lors des appels REST.

  • Le champ *Type de Réponse vous permet de configurer le type de réponse : XML / plain / Bytes / JSON/ Json params in form .

Configurer un certificat pour un webservice

Une configuration d'un certificat pour un webservice est requise dans le cas où vous voulez assurer la sécurité des communications en ligne entre l'utilisateur/le client et le serveur.

Pour associer un certificat à un web service, vous devez dans un premier temps chiffrer la clé du certificat. Pour cela vous devez aller dans Préférences > Bot > Général. Vous trouverez en bas de page la section " Définir un mot de passe pour chiffrer les certificats des Webservices"

Le mot de passe choisi est définitif. Il ne pourra pas être modifié, ni annulé.

Le format du certificat doit être en PFX (format de fichier permettant de chiffrer le certificat du serveur, les éventuels certificats intermédiaires et la clé privée). Une fois le certificat téléchargé et le mot de passe du certificat renseigné, il est obligatoire de cliquer sur "Enregistrer".

Authentification au service web

Ici, vous pouvez choisir le type d'authentification pour votre service Web (OAUTH_2 / HTTP_BASIC). Une fois sélectionné, vous pouvez remplir les champs Nom d'utilisateur pour l'authentification et Mot de passe pour l'authentification. Toutefois, ces champs peuvent rester vides. Ils ne doivent être configurés que si cela est vraiment nécessaire.

Entêtes du service web

Cette section vous permet d'ajouter des en-têtes HTTP dans l'appel à un service. Ceci est souvent utilisé pour l'authentification.

Paramètres

  • Le champ Nom permet de configurer le nom du paramètre.

  • Le champ Valeur permet de configurer la valeur du paramètre. Si cette valeur doit être récupérée dans une conversation, il faut indiquer **${capture.**Xxx} avec Xxx qui est le nom de la variable dans la conversation.

  • Le champ Valeur de test permet de configurer une valeur pour le paramètre uniquement utilisée lors du test du service web sur la page de configuration (voir les boutons d'actions). Cette valeur n'est pas sauvegardée lorsque vous quittez la page.

Les paramètres sont encodés en fonction de la méthode HTTP : dans l'URL en GET et dans le corps de la requête en POST / PUT / DELETE.

Variables de résultats

Il est possible de configurer des variables qui pourront être affichées dans une conversation avec l’utilisateur. Cette partie dépendra du champ Type de réponse.

Il est important de noter que :

  • les variables récupérées du service web sont structurées comme suit : ${callapi.WebServiceName.variableName};

  • les variables récupérées de la boîte de dialogue sont structurées comme suit : ${capture.VariableName}.

Avec une réponse de type XML : il est possible de récupérer des valeurs depuis le résultat en appliquant des fonctions XPath ou XSLT.

Important : les fonctions XPath ou XSLT ne doivent renvoyer que du texte et jamais du XML pour être affichées dans les conversations.

Avec une réponse du type JSON : il est possible de récupérer des valeurs depuis le résultat en exécutant du javascript.

Important : il est nécessaire de créer au moins une fonction javascript nommée « dyduParseJSON » qui renvoie une chaîne de caractères ou un tableau de chaînes de caractères, et qui a pour paramètre le JSON renvoyé par la requête (voir l’exemple REST en bas de page).

Notez que vous pouvez également retourner un message général si le résultat JSON est invalide. La fonction JSON devra alors être :


function dyduParseJSON (json, text) {

return {result: json}

}

Exemple : Dans une connaissance, si la question posée par l’internaute est « Quel temps fait-il à Paris ? » , il est possible de capturer la ville en indiquant dans la connaissance « Quel temps fait-il à ${capture.city} ? ». Des exemples plus complets sont listés sur.

cette page