> ## Documentation Index
> Fetch the complete documentation index at: https://docs.volubile.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Synthèse vocale

> Configuration des voix pour vos agents téléphoniques

## Voix de l'agent

<Note>
  La synthèse vocale permet de personnaliser l'expérience utilisateur en sélectionnant une voix adaptée à vos besoins
  linguistiques et à l'identité de votre marque.
</Note>

### Catalogue de voix

Pour accéder au catalogue des voix disponibles, cliquez sur le bouton **Modifier** à côté de la voix actuellement configurée pour votre agent.

<Frame>
  <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-voice-catolog-access.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=ae8573d309e8dfa0e3eb2ea859bc648b" alt="Interface d'accès au catalogue de voix" style={{width: 400}} width="823" height="188" data-path="images/agents/tts/volubile-tts-voice-catolog-access.png" />
</Frame>

### Sélection de la voix

<Frame>
  <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-voice-catalog.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=3ec559ff33c79b09ab57b3c7780286dd" alt="Catalogue de voix Volubile" width="1920" height="1490" data-path="images/agents/tts/volubile-tts-voice-catalog.png" />
</Frame>

<Steps>
  <Step title="Sélection du fournisseur">
    Choisissez le fournisseur de technologie vocale dans le menu déroulant. Chaque fournisseur propose des
    caractéristiques vocales distinctives.
  </Step>

  <Step title="Configuration des langues">
    Sélectionnez les langues que votre agent doit maîtriser. Ces langues détermineront les voix disponibles à
    l'étape suivante.
  </Step>

  <Step title="Choix de la voix">
    Parcourez les options de voix compatibles avec vos critères linguistiques et sélectionnez celle qui correspond
    le mieux à vos besoins.
  </Step>

  <Step title="Confirmation">
    Cliquez sur le bouton **Sauvegarder** pour appliquer votre sélection et activer la voix choisie.
  </Step>
</Steps>

<Warning>
  Un maximum de 5 langues peut être sélectionné pour filtrer les voix disponibles. Cette limitation permet d'optimiser
  les performances de votre agent.
</Warning>

<Tip>
  Avant de finaliser votre choix, utilisez les boutons de lecture pour écouter un échantillon de chaque voix dans les
  différentes langues sélectionnées.
</Tip>

## Langues

### Sélection des langues

<Frame>
  <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-language-selector.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=1675e2045a6001c0ba991cefd242beef" alt="Interface du selecteur de langues" width="1872" height="459" data-path="images/agents/tts/volubile-tts-language-selector.png" />
</Frame>

Configurez les langues que votre agent peut comprendre et dans lesquelles il peut s'exprimer.

<Steps>
  <Step title="Ajout des langues supportées">
    Sélectionnez toutes les langues que votre agent doit maîtriser dans le menu déroulant **Languages**. Chaque
    langue est identifiée avec sa variante régionale.
  </Step>

  <Step title="Définition de la langue principale">
    Sélectionnez la langue principale (**Primary language**) qui sera utilisée par défaut lorsque l'agent ne peut
    pas déterminer la langue de l'utilisateur.
  </Step>
</Steps>

<Warning>
  Un maximum de 5 langues peut être configuré pour chaque agent. Cette limitation permet d'optimiser les performances
  et la précision des interactions.
</Warning>

### Fonctionnement multilingue

L'agent utilise la détection automatique de langue pour adapter sa réponse à l'utilisateur:

<CardGroup cols={2}>
  <Card title="Détection automatique" icon="wand-magic-sparkles">
    L'agent identifie automatiquement la langue utilisée par l'interlocuteur et répond dans la même langue si elle
    fait partie des langues configurées.
  </Card>

  <Card title="Langue par défaut" icon="language">
    Si la langue détectée n'est pas supportée, l'agent utilisera la langue principale définie dans la configuration.
  </Card>
</CardGroup>

### Résolution des problèmes courants

Si votre agent ne détecte pas correctement la langue de l'utilisateur:

* Vérifiez que la langue est bien incluse dans la liste des langues supportées
* Assurez-vous que les phrases prononcées contiennent suffisamment de mots pour permettre une détection fiable

## Vitesse d'élocution

<Frame>
  <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-voice-speed.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=7ec30ad649bf9d77349d4ff1dfe2ab6d" alt="Interface du selecteur de langues" width="1883" height="343" data-path="images/agents/tts/volubile-tts-voice-speed.png" />
</Frame>

Ajustez la vitesse d'élocution de votre agent en déplaçant le curseur sur l'échelle:

<CardGroup cols={3}>
  <Card title="Lent" icon="turtle">
    Débit ralenti pour une meilleure compréhension lors de concepts complexes ou pour les personnes ayant des
    difficultés auditives.
  </Card>

  <Card title="Normal" icon="user">
    Débit standard calibré pour une conversation naturelle.
  </Card>

  <Card title="Rapide" icon="rabbit">
    Débit accéléré pour les utilisateurs pour délivrer rapidement des informations.
  </Card>
</CardGroup>

<Tip>
  Le réglage idéal dépend de votre audience et du contexte d'utilisation. Testez différentes configurations pour
  trouver le débit optimal pour votre cas d'usage.
</Tip>

## Phonèmes

<Frame>
  <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-phoeneme-configuration.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=6c6413aa31c316b4c4d2911e17093a9e" alt="Interface de configuration des phonèmes" width="1907" height="597" data-path="images/agents/tts/volubile-tts-phoeneme-configuration.png" />
</Frame>

Cette fonctionnalité vous permet de définir une transcription phonétique personnalisée pour des mots spécifiques, particulièrement utile pour:

* Les noms propres
* Les termes techniques
* Les acronymes et abréviations
* Les mots étrangers

Cette configuration n'est disponible que pour les agents utilisant la synthèse vocale Azure.

### Ajout d'un phonème personnalisé

<Steps>
  <Step title="Accéder à l'interface">
    Depuis la section "Phoneme Configuration", cliquez sur le bouton <strong>Ajouter un phonème</strong> pour ouvrir
    la fenêtre de configuration.

    <Frame>
      <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-phoeneme-step-1.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=4c2ffd3e16d72e6beb1137c47e3ab9a8" alt="Formulaire d'ajout de phonème" width="1866" height="335" data-path="images/agents/tts/volubile-tts-phoeneme-step-1.png" />
    </Frame>
  </Step>

  <Step title="Définir le mot et sa prononciation">
    <Frame>
      <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-phoeneme-step-2.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=c92296cb70ae38b6802387c6e8d3763f" alt="Formulaire d'ajout de phonème" width="1200" height="566" data-path="images/agents/tts/volubile-tts-phoeneme-step-2.png" />
    </Frame>

    Remplissez les champs requis:

    <ul>
      <li><strong>Word</strong>: Saisissez le mot à personnaliser</li>
      <li><strong>Phoneme</strong>: Entrez la transcription phonétique correspondante</li>
    </ul>
  </Step>
</Steps>

### Notation phonétique

Les phonèmes doivent être saisis selon le standard de l'Alphabet Phonétique International (IPA).

```
"Paris" → /paʁi/
"WiFi" → /waɪfaɪ/
```

### Cas d'utilisation

<CardGroup cols={2}>
  <Card title="Noms de marque" icon="trademark">
    Assurez-vous que votre agent prononce correctement le nom de votre entreprise et de vos produits.
  </Card>

  <Card title="Terminologie spécialisée" icon="flask">
    Optimisez la prononciation des termes techniques spécifiques à votre secteur d'activité.
  </Card>
</CardGroup>

<Warning>
  La configuration de phonèmes est spécifique à chaque langue. Un même mot peut nécessiter différentes transcriptions
  phonétiques selon les langues configurées pour votre agent.
</Warning>

### Recommandations pratiques

* Après avoir ajouté un phonème personnalisé, effectuez un test d'appel pour vérifier que la prononciation correspond à vos attentes.
* Commencez par configurer les phonèmes pour les termes les plus fréquemment utilisés par votre agent.

## Substitutions vocales

Lorsque votre agent vocal rencontre certaines abréviations, acronymes ou termes techniques dans un texte, il peut parfois les prononcer de manière incorrecte ou peu naturelle. Le module de substitution vous permet de définir des règles de remplacement pour optimiser l'expérience utilisateur.

<Frame>
  <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-text-substitution.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=5492116981edbf1d7596e5faa42fc9ce" alt="Interface des substitutions" width="1872" height="628" data-path="images/agents/tts/volubile-tts-text-substitution.png" />
</Frame>

### Cas d'utilisation courants

<AccordionGroup>
  <Accordion title="Mesures et chiffres">
    * **Unités de mesure** : "cm" → "centimètre", "kg" → "kilogramme"
    * **Symboles mathématiques** : "+" → "plus", "=" → "égal", ">" → "supérieur à"
  </Accordion>

  <Accordion title="Personnes et lieux">
    * **Titres et civilités** : "Dr" → "Docteur", "Mme" → "Madame"
    * **Abréviations géographiques** : "St" → "Saint", "Av." → "Avenue"
  </Accordion>

  <Accordion title="Termes spécialisés">
    * **Acronymes** : "TVA" → "Taxe sur la Valeur Ajoutée", "SNCF" → "S N C F"
    * **Termes techniques** : Adapter la prononciation de termes spécifiques à votre secteur d'activité
  </Accordion>

  <Accordion title="Caractères spéciaux">
    * **Caractères spéciaux** : "€" → "euros", "@" → "arobase", "&" → "et"
    * **Expressions régulières** : Créer des règles de substitution avancées pour gérer des cas complexes
  </Accordion>
</AccordionGroup>

### Configuration des substitutions

Pour configurer une nouvelle substitution :

<Steps>
  <Step title="Accéder à l'interface">
    Depuis la section “Substitution de prononciations”, cliquez sur le bouton <strong>Ajouter une
    substitution</strong> à phoneme pour ouvrir la fenêtre de configuration.
  </Step>

  <Step title="Remplir le formulaire">
    <Frame>
      <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-text-substitution-form.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=cdb77c3c6af26e59c78ccf9eb5d88e3a" alt="Formulaire d'ajout de substitution" width="1200" height="775" data-path="images/agents/tts/volubile-tts-text-substitution-form.png" />
    </Frame>

    Remplissez les champs suivants dans le formulaire :

    | Champ                                         | Description                                                                                   |
    | --------------------------------------------- | --------------------------------------------------------------------------------------------- |
    | Motif                                         | Le motif textuel à remplacer (ex: "cm", "Dr", "St")                                           |
    | Remplacement                                  | Le texte de remplacement qui sera utilisé pour la prononciation (ex: "centimètre", "Docteur", |
    | "Saint")                                      |                                                                                               |
    | Associer un pattern différent par langue      | Option permettant de définir des substitutions spécifiques pour                               |
    | chaque langue prise en charge par votre agent |                                                                                               |
  </Step>
</Steps>

### Test des substitutions

Après avoir configuré vos substitutions, utilisez la fonction "Essayer" pour vérifier comment votre agent prononcera certaines phrases contenant les patterns définis.

La plateforme Volubile offre une fonctionnalité de test directement sous le formulaire de substitution :

<Frame>
  <img src="https://mintcdn.com/weengage/DhTJGqKM0FN88ypW/images/agents/tts/volubile-tts-text-substitution-test-run.png?fit=max&auto=format&n=DhTJGqKM0FN88ypW&q=85&s=73d013810e1010c35f70d428a6640274" alt="Interface de test des substitutions" width="1200" height="570" data-path="images/agents/tts/volubile-tts-text-substitution-test-run.png" />
</Frame>

<Steps>
  <Step title="Ouvrir la section Test">
    Déroulez la section "Test" située en bas du formulaire
  </Step>

  <Step title="Saisir un exemple">
    Saisissez un exemple de texte contenant le pattern que vous souhaitez tester
  </Step>

  <Step title="Vérifier par langue">
    Visualisez comment votre motif sera détecté dans différentes langues (français, anglais, etc.)
  </Step>
</Steps>

<Warning>
  Cette fonctionnalité est particulièrement utile pour valider les expressions régulières complexes qui peuvent être
  difficiles à tester sans un environnement dédié.
</Warning>

### Règles et bonnes pratiques

* Pour les acronymes complexes, privilégiez l'épellation (ex: "IBM" → "I B M") si la prononciation naturelle est ambiguë
* Testez vos substitutions pour vous assurer de leur efficacité
* Limitez-vous aux substitutions strictement nécessaires pour maintenir des performances optimales
* Utilisez l'option "Associate a different pattern by language" pour définir des substitutions spécifiques à chaque langue lorsque la prononciation ou l'abréviation diffère selon la langue (par exemple, "cm" pourrait être remplacé par "centimètre" en français et "centimeter" en anglais)