> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# VoiceAgents pour les appels entrants
> Configurez et utilisez la fonctionnalité VoiceAgent de CloudTalk pour gérer efficacement les appels entrants.
Dans cet article, vous apprendrez à configurer et à utiliser la fonctionnalité VoiceAgent de CloudTalk pour gérer efficacement les appels entrants, notamment en configurant des workflows et en gérant les interactions entrantes grâce à l'automatisation.
**Niveau d'utilisateur\u00A0:** Admin
***
VoiceAgents pour les appels entrants
**VoiceAgents pour les appels entrants** permet aux équipes de traiter automatiquement les demandes des clients en intégrant des agents pilotés par l'IA dans les flux d'appels entrants. Cette fonctionnalité permet de répondre à des cas d'usage courants du support, comme vérifier le statut d'une commande ou d'un ticket, prendre des rendez-vous, et bien plus encore, facilitant ainsi l'adoption de l'automatisation et une résolution plus rapide.
💡 *Vous cherchez de l'aide pour des cas d'usage de prospection proactive ou d'appels sortants\u00A0?* Consultez le [guide VoiceAgent pour les appels sortants](/fr/articles/11401649-voiceagents-for-outbound-calls) pour découvrir cette option.
Fonctionnement
Lorsqu'un appel entrant atteint l'**étape [VoiceAgent](/fr/articles/11053795-getting-started-with-voiceagents) dans le flux d'appels**, la conversation entre l'appelant et le VoiceAgent se déroule sans qu'un agent humain soit nécessaire. Le VoiceAgent gère des tâches telles que répondre aux questions, fournir des informations ou collecter des données de manière autonome.
Avant l'étape VoiceAgent, vous pouvez **personnaliser le flux d'appels** à l'aide d'outils tels que les *Séparateurs de condition, les menus IVR,* ou *le Séparateur Jour/Heure*. Cette flexibilité vous permet de définir quels appels doivent être traités par le VoiceAgent et lesquels doivent être transférés directement à un agent humain.
Une fois que le VoiceAgent a terminé l'interaction, l'un des scénarios suivants se produit\u00A0:
* **Transfert supervisé vers un agent ou un groupe**\u00A0: le VoiceAgent garde l'appelant en ligne pendant qu'il contacte le destinataire. L'appelant n'est transféré qu'une fois que l'agent décroche ou que la file d'attente accepte l'appel. Si le transfert ne peut pas être finalisé, **le VoiceAgent reste actif et poursuit la conversation**, en proposant de prendre un message, d'essayer une autre équipe, ou d'aider directement. L'appelant ne subit jamais de coupure d'appel.
* **Transfert vers le flux d'appels**\u00A0: la session VoiceAgent se termine et l'appel se poursuit dans la branche ***Répondu*** après l'étape VoiceAgent, où vous pouvez définir toute logique de suivi (routage, IVR, numéros externes, CSAT).
* **Fin naturelle de l'appel**\u00A0: le VoiceAgent guide l'appelant (si sa configuration le prévoit) pour qu'il mette fin à l'appel de lui-même. Les étapes suivantes de la branche ***Répondu*** après l'étape VoiceAgent se poursuivent alors comme configuré.
L'intégralité de l'interaction entre le VoiceAgent et l'appelant, y compris la conversation complète, est enregistrée dans CloudTalk comme un appel entrant standard.
***
Configuration du flux d'appels entrants avec VoiceAgent
Prérequis
1. Un **numéro de téléphone actif configuré pour les appels entrants** dans votre compte CloudTalk
2. **La fonctionnalité VoiceAgents activée** dans votre CloudTalk Dashboard.
3. **Un VoiceAgent entrant configuré** dans votre compte. Cela peut être créé de la manière suivante\u00A0:
1. en sélectionnant un modèle conçu pour les appels entrants
2. en créant un VoiceAgent personnalisé et en définissant **Direction de l'appel** sur **Entrant**.
Configurer le flux VoiceAgent pour les appels entrants
1. Dans le menu du Dashboard, accédez à l'onglet **Numéros**. La liste de tous vos numéros de téléphone s'affiche. Sélectionnez le numéro qui doit acheminer les appels vers le VoiceAgent. Cliquez sur **+ Configurer** (ou sur le nom du flux) dans la colonne **Flux d'appels**
2. Cela ouvre le [**Concepteur de flux d'appels**](/fr/articles/3669429-call-flow-designer-guide), où vous pouvez configurer les étapes de traitement des appels entrants.
3. **Configurez les étapes du flux d'appels entrants** selon vos besoins. Le VoiceAgent n'a pas besoin d'être la première étape. Une fois l'interaction VoiceAgent terminée, le flux se poursuit dans la branche *Répondu*, ce qui vous permet de placer des étapes de suivi (par exemple, CSAT, messagerie vocale, message d'accueil) après l'étape VoiceAgent.\
\
*Exemple de flux d'appels\u00A0:*
4. Cliquez sur l'**icône +** à l'endroit de la configuration du flux d'appels où vous souhaitez que l'**étape VoiceAgent** soit exécutée. Dans le menu **Ajouter une nouvelle action**, sélectionnez l'étape **Voice agent**.
5. **Configurez l'action de l'étape VoiceAgent.** Si nécessaire, attribuez un nom à l'étape. Dans la section **Agent**, sélectionnez le VoiceAgent **entrant** souhaité. Seuls les VoiceAgents configurés avec une direction entrante seront disponibles dans la liste de sélection.
6. *(Facultatif)* Si nécessaire, configurez des paramètres de routage supplémentaires - tels que les paramètres **Séparateur de condition**, **Menus IVR**, ou **Séparateur Jour/Heure** - pour adapter la logique du flux d'appels.
7. **Confirmez la configuration de l'étape VoiceAgent.**
8. **Terminez et enregistrez le flux d'appels configuré** pour appliquer vos modifications et activer le routage entrant mis à jour.
Vous avez désormais terminé la configuration du flux d'appels entrants, et votre VoiceAgent est prêt à traiter les appels entrants dans le cadre du workflow défini.
Contexte du contact pour les appels entrants
Lorsqu'un contact enregistré appelle votre entreprise, le VoiceAgent a automatiquement accès à ses informations stockées dans CloudTalk. Cela permet des conversations personnalisées et une automatisation plus intelligente dans vos flux d'appels entrants.
Vous pouvez référencer les propriétés du contact dans n'importe quelle configuration du VoiceAgent ainsi que dans les [Outils](/fr/articles/11275049-tools-for-voiceagent).
**Rechercher et insérer des variables**
Lors de la configuration d'un VoiceAgent entrant, la section **Personnalisation** affiche tous les champs de contact disponibles pour votre agent, y compris les champs de contact personnalisés de votre compte.
Vous pouvez insérer une variable de deux manières\u00A0:
1. Saisissez `#{{` dans n'importe quel champ de prompt (message d'accueil, prompt d'objectif, scénarios, compétences) pour ouvrir un menu de saisie semi-automatique, puis sélectionnez la variable.
2. Cliquez sur un champ dans la section **Personnalisation** pour l'insérer.
Si un prompt contient une variable qui n'existe pas, le champ la met en évidence et affiche un avertissement («\u00A0L'une des variables n'est pas valide\u00A0»). Vérifiez le nom de la variable dans la liste Personnalisation\u00A0; par exemple, `contact.firstname` n'est pas un champ valide\u00A0; le nom complet est disponible sous la forme `contact.name`.
**Référence rapide des propriétés**
| **Propriété** | **Notation** | **Type de donnée** | **Exemple** |
| - | - | - | - |
| Nom | `#{{contact.name}}` | Chaîne | John Smith |
| Entreprise | `#{{contact.company}}` | Chaîne | Acme Inc. |
| Intitulé du poste | `#{{contact.title}}` | Chaîne | Responsable commercial |
| E-mail(s) | `#{{contact.emails}}` | Valeurs multiples (Chaîne) | [john.smith@example.com](mailto:john.smith@example.com) |
| Numéro(s) de téléphone | `#{{contact.phoneNumbers}}` | Valeurs multiples (Chaîne) | +1 202 555 0175 |
| Numéro de l'appelant | `#{{caller_number}}` | Chaîne | +1 202 555 0175 |
| Site web | `#{{contact.website}}` | Chaîne | acme.com |
| Secteur d'activité | `#{{contact.industry}}` | Chaîne | Logiciel |
| Adresse | `#{{contact.address}}` | Chaîne | 123 Main St |
| Ville | `#{{contact.city}}` | Chaîne | Boston |
| Code postal | `#{{contact.zip}}` | Chaîne | 02110 |
| Pays | `#{{contact.country.name}}` | Chaîne | États-Unis |
| Indicatif du pays | `#{{contact.country.countryCode}}` | Chaîne | US |
| Champ personnalisé | `#{{contact.custom.vip_status}}` | Chaîne | Gold |
| Liens d'intégration | `#{{contact.integrationLinks}}` | Chaîne (URL) | hubspot: [https://app.hubspot.com/](https://app.hubspot.com/)... |
**Référencer les champs personnalisés**\
Pour utiliser un champ personnalisé dans un prompt, vous devez le référencer par son nom API exact.\
Par exemple, si votre champ personnalisé s'appelle `vip_status`, vous devez utiliser\u00A0:
```
#{{contact.custom.vip_status}}
```
**Exemples de cas d'usage**
* Saluer l'appelant par son nom.
* Router les VIP en fonction d'un champ personnalisé.
* Transmettre un ID CRM depuis un lien d'intégration vers un Outil.
Exemple HubSpot\u00A0: extraire l'ID du contact à partir d'un lien d'intégration
Où le faire dans le Dashboard\u00A0:
1. Ouvrez votre VoiceAgent, accédez à **[Outils](/fr/articles/11275049-tools-for-voiceagent)**.
2. Dans le paramètre d'outil nommé **ID** (ou similaire), définissez **Type = LLM Prompt**.
3. Collez ce prompt dans la description\u00A0:
```
Look through the #{{contact.integrationLinks}} and search for one with "hubspot" in the domain.
Then take the last path parameter and use it as the value.
It should be 12 characters.
```
Cela permet au VoiceAgent de lire le lien HubSpot depuis le contact de l'appelant et d'utiliser l'ID du contact dans l'appel de l'Outil.
**Remarques et limites**
* Fonctionne lorsque le numéro entrant correspond à un contact CloudTalk enregistré. Si l'appelant n'est pas enregistré, les propriétés peuvent être vides.
* Si plusieurs contacts partagent le même numéro, votre prompt doit indiquer comment choisir le bon enregistrement ou comment gérer l'échec correctement.
* Respectez les règles de confidentialité des données pour toute information que vous exposez aux utilisateurs finaux.
***
*Besoin d'aide ou une question\u00A0?* Contactez-nous simplement via notre [Portail Support](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — nous sommes là pour vous.
## Related topics
- [VoiceAgents pour les appels sortants](/fr/articles/11401649-voiceagents-for-outbound-calls.md)
- [Premiers pas avec les VoiceAgents](/fr/articles/11053795-getting-started-with-voiceagents.md)
- [Transferts d'appels du VoiceAgent](/fr/articles/11393590-voiceagent-call-transfers.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.