Agent Vocal

Cet agent vocal agit comme un voice bot intelligent permettant à l’utilisateur d’interagir naturellement avec le système par la voix, comme lors d’une conversation téléphonique. Il écoute, comprend et répond en temps réel aux demandes grâce à des technologies de reconnaissance vocale, de compréhension du langage naturel et de synthèse vocale. La plateforme prend désormais en charge la voix en français ainsi que les voix en anglais.

Une transcription en temps réel est également appliquée, permettant de convertir instantanément les échanges vocaux en texte pour un suivi précis et une meilleure exploitation des conversations. Que ce soit pour poser une question, obtenir une information, effectuer une action ou être guidé dans un processus, l’agent fournit des réponses instantanées de manière fluide et naturelle, sans nécessiter d’interface écrite.

En parallèle, l’utilisateur peut consulter l’historique complet de ses appels ou interactions vocales, ainsi que leurs transcriptions, facilitant le suivi des échanges et l’exploitation des informations.

De plus, le système met à disposition des statistiques détaillées sur l’activité du voice bot, telles que le volume d’appels traités, les types de demandes ou les performances globales, afin d’évaluer son efficacité et d’optimiser son utilisation. L’ensemble de ces fonctionnalités vise à offrir une expérience conversationnelle proche de celle d’un échange humain, disponible en continu, tout en garantissant rapidité, accessibilité et gain de temps.

1. L'appel sur la plateforme

1.1 Aperçu

De la même manière que la section 3.2.1, ici seront regroupées les statistiques pour la partie vocale, plutôt que pour les documents comme c’est le cas dans l’agent de traitement de documents. Sample

1.2. Effectuer un appel

Pour tester l’action de faire un appel auprès de l’agent vocal, il y a 2 facon pour realiser un appel dans la plateforme:

1.2.1 WebRTC

Pour utiliser la fonctionnalité Audio en direct, sélectionnez cette option afin d’initier un appel directement via le site web. L’utilisateur est redirigé vers une page de préparation à l’appel, permettant de vérifier les paramètres audio avant la connexion.

Une fois prêt, il suffit de cliquer sur le bouton Appelez maintenant pour établir la communication en temps réel avec l’agent vocal sur la plateforme. Sample

L’ensemble du processus est conçu pour faciliter les interactions vocales, tout en assurant la qualité de la transmission et l’enregistrement des données pour suivi et analyse.

Le navigateur doit disposer des autorisations d’accès au microphone et à l’audio pour que l’appel puisse se dérouler sans problème technique. Pendant l’appel, une transcription en temps réel est appliquée, permettant de suivre instantanément les échanges vocaux et de conserver un enregistrement texte des conversations pour consultation ou analyse ultérieure.

Sample Pour mettre fin à l’appel, cliquez sur le bouton Terminer l’appel situé en haut à droite de la plateforme.

1.2.1. Appel téléphonique

Pour utiliser l’option Appel téléphonique, sélectionnez-la dans l’interface et saisissez le numéro de téléphone à contacter. Le serveur côté Rizlum initie automatiquement l’appel vers le numéro fourni, permettant à l’utilisateur de recevoir la communication directement sur son téléphone et d’interagir avec l’agent vocal en temps réel. Le système gère l’ensemble de la session, y compris la transmission audio et l’enregistrement des échanges si nécessaire, garantissant un appel sécurisé, fluide et traçable.

Sample

Saisissez le numéro de téléphone sur lequel vous souhaitez recevoir un appel et cliquez Appelez. En cliquant sur Appelez, vous recevrez un appel sur le numéro indiqué. Lors de la prise de cet appel, côté plateforme, vous pourrez suivre en temps réel la transcription ainsi que les informations détaillées relatives à cet appel. Sample

Pour consulter l’historique des appels effectués avec cet agent, vous pouvez vous rendre dans l’onglet Aperçu / Appels récents pour les consulter (section 3.3.1).

2. L'utilisation API

En plus de l’utilisation des agents vocaux directement sur la plateforme, nous proposons également un accès via une API indépendante.

Cette option permet aux clients de tester rapidement les API et d’obtenir des réponses en temps réel. Elle est particulièrement utile pour les phases d’évaluation et de prototypage.

Plus important encore, cette API offre la possibilité aux utilisateurs d’intégrer facilement notre solution dans leurs propres produits, services ou projets, garantissant ainsi une grande flexibilité d’usage et une adaptation à différents cas d’application.

Avant d’utiliser le mode API, il est nécessaire de créer un agent vocal sur la plateforme, ou il devrait avoir l'agent que vous voulez appeler des API. Après il faut cliquer sur le bouton API de cet agent.
Puis de préparer les éléments suivants :

Clé API

Génération d’une clé API Accédez à la section « API Keys » dans les paramètres (Settings), puis cliquez sur le bouton « Ajouter une clé API » (Add API Key).
Attribution d’un nom Saisissez un nom de votre choix pour cette clé, puis cliquez à nouveau sur « Ajouter une clé API » situé sous le champ de saisie.
Sauvegarde de la clé secrète La plateforme générera automatiquement une clé secrète associée au nom que vous avez défini. Il est essentiel de copier et conserver cette clé en lieu sûr, car elle sera requise pour toute utilisation ultérieure de l’API. (*)

ID de l'agent

L’identifiant de l’agent (Agent ID) est requis pour pouvoir exécuter des requêtes via l’API. Vous pouvez le récupérer facilement en accédant à l’agent vocal concerné : l’identifiant est visible dans l’URL de la page. Il vous suffit de le copier pour l’utiliser dans vos appels API. (**) Sample

Ensuite, en cliquand le bouton API, il s'affiche la page API mode: la liste des APIs supporte s'affiche dans le colonne à gauche:

2.1. Activer un appel

Pour activer un appel depuis API mode, accédez à l’option Start an outbound phone call.

Renseignez ensuite les champs suivants :

x-api-key : indiquez la clé API (*) que vous avez générée précédemment (voir section correspondante).
agent_id : saisissez l’identifiant de l’agent récupéré précédemment (**).

Une fois ces informations complétées, vous pouvez renseigner dans le champ phone_number le numéro associé à l’appel (celui concerné par votre requête). Cliquez ensuite sur le bouton Send API Request afin d’initier l’appel vers le numéro de téléphone transmis via l’API. Sample

Après l’envoi, la réponse s’affiche dans la section Response. Veuillez sauvegarder le paramètre session_id si vous souhaitez récupérer la transcription à la fin de l’appel.

Vous avez également la possibilité de copier la requête au format cURL depuis la section Request Sample (Shell / cURL), afin de la tester directement dans vos propres environnements ou systèmes. Sample

        {
          "data": {
            "session_id": "cfcdb33d-7810-43b5-a88d-94ab714860bf"
          }
        }

2.1. Récupérer la transcription d’un appel

Pour récupérer les messages d’une conversation, vous devez fournir le paramètre session_id correspondant à la conversation dont vous souhaitez extraire les messages et les informations associées.

Sample

Réponse d’API permettant de récupérer toutes les informations relatives à un appel spécifique.

        {
          "audio_key": "",
          "conversation": [
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "reference_sentence_id": null,
              "role": "assistant",
              "sentence_id": "abfb6802-1483-4a96-a196-20a0f93c69f4",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "step_id": null,
              "text": "Bonjour et bienvenue à votre mutuelle.",
              "timestamp": "1777458242.6580012"
            },
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "reference_sentence_id": null,
              "role": "assistant",
              "sentence_id": "6418032f-8e5f-4bcf-bd70-2dc5710b5459",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "step_id": null,
              "text": "Pour enregistrer votre demande et vous proposer un rendez-vous téléphonique avec un conseiller, pourriez-vous m'indiquer brièvement la raison de votre appel ?",
              "timestamp": "1777458243.9560049"
            },
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "role": "user",
              "sentence_id": "8da547ec-1dd1-4df9-bbbf-bf458832a822",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "step_id": null,
              "text": "Bonjour, je serais bien de vous donner un coup de pouce, s'il vous plaît.",
              "timestamp": "1777458250.775719"
            },
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "reference_sentence_id": "8da547ec-1dd1-4df9-bbbf-bf458832a822",
              "role": "assistant",
              "sentence_id": "b595bcc4-6e59-4061-86c4-1b5132847dab",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "step_id": null,
              "text": "Je vous en prie, je vous écoute.",
              "timestamp": "1777458251.9047735"
            },
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "reference_sentence_id": "8da547ec-1dd1-4df9-bbbf-bf458832a822",
              "role": "assistant",
              "sentence_id": "e28549f6-a168-4cee-b8c7-39078e26ca5b",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "step_id": null,
              "text": "Dites-moi comment je peux vous aider ou ce que vous souhaiteriez faire.",
              "timestamp": "1777458252.787615"
            },
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "reference_sentence_id": "ed737535-9816-4ecb-a28c-84573742a765",
              "role": "assistant",
              "sentence_id": "ceb1ee57-d5f1-4c59-9ad1-5ce47049e428",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "step_id": null,
              "text": "Je comprends.",
              "timestamp": "1777458269.2329845"
            },
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "role": "user",
              "sentence_id": "ed737535-9816-4ecb-a28c-84573742a765",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "text": "En fait, j'ai un problème avec mon conseiller, on n'a pas encore un accord et il a un conflit entre nous, donc j'aimerais bien qu'ils aient un rendez-vous pour pouvoir discuter directement avec le conseiller pour résoudre le problème.",
              "timestamp": "1777458280.8282385"
            },
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "reference_sentence_id": "ed737535-9816-4ecb-a28c-84573742a765",
              "role": "assistant",
              "sentence_id": "3968cb91-2473-464f-8e0b-d4a19ca3529c",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "step_id": null,
              "text": "Je comprends tout à fait la situation.",
              "timestamp": "1777458281.7127452"
            },
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "reference_sentence_id": "ed737535-9816-4ecb-a28c-84573742a765",
              "role": "assistant",
              "sentence_id": "ddeceaf1-2443-496b-a964-ffa9b0041319",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "step_id": null,
              "text": "Pour que je puisse organiser cela, pourriez-vous me donner un peu plus de détails sur ce qui bloque ou sur la nature du conflit ?",
              "timestamp": "1777458283.2195816"
            },
            {
              "agent_id": "121ec42b-7b7d-4dfb-b1f7-e98ab9a20afb",
              "call_type": "outbound",
              "event": "running",
              "mode": "conversation",
              "reference_sentence_id": "ed737535-9816-4ecb-a28c-84573742a765",
              "role": "assistant",
              "sentence_id": "3f671ff5-c375-4b73-a140-f4822a987941",
              "session_id": "51ad088b-6811-4e73-8dc2-4f6c0fc6033a",
              "step_id": null,
              "text": "Cela permettra au conseiller de bien préparer votre échange.",
              "timestamp": "1777458283.932112"
            }
          ],
          "end_time": "",
          "is_stopped": false,
          "start_time": "1777458242.091805",
          "summary_info": ""
        }