Composant prédéfini de salutation

Le composant prédéfini d'accueil récupère le numéro de téléphone de l'appelant (ANI), s'il est disponible. Si le système récupère le numéro de téléphone, le composant effectue une authentification logicielle à l'aide du numéro de téléphone, en le validant par rapport aux numéros de téléphone enregistrés. L'agent accueille ensuite l'utilisateur avec un message personnalisé basé sur les informations de son compte.

Limites

En plus des limites communes des composants prédéfinis, ce composant prédéfini présente les limites suivantes :

  • Le composant suppose que les numéros de téléphone sont gérés dans un système de gestion de la relation client (CRM) ou un autre service.
  • Les clients existants qui utilisent un autre numéro de téléphone pour vous contacter ne sont pas authentifiés par ce composant.

Exemples de dialogues

Les exemples de boîtes de dialogue suivants illustrent des scénarios courants gérés par ce composant prédéfini. Ils illustrent ce qui se passe lorsque la téléphonie lance le composant, ce qui déclenche l'intent de bienvenue par défaut et la première réponse de l'agent au début de la conversation.

Utilisateur authentifié

L'utilisateur est identifié en fonction du numéro d'appel et reçoit un message d'accueil personnalisé.

Entrée utilisateur Réponse de l'agent
Bonjour [Caller First Name]. Merci d'avoir contacté [nom de l'entreprise]. Nous nous engageons à vous aider à gérer votre santé financière. Comment pouvons-nous vous aider aujourd'hui ?

Utilisateur non identifié

Le système n'identifie pas le numéro de l'appelant et accueille l'utilisateur avec le message d'accueil standard.

Entrée utilisateur Réponse de l'agent
Merci d'avoir contacté [nom de l'entreprise]. Nous nous engageons à vous aider à gérer votre santé financière. Comment pouvons-nous vous aider aujourd'hui ?

Conventions d'attribution de noms

Ce composant prédéfini utilise les conventions d'attribution de noms suivantes :

Fonctionnalité Format Exemple
Flow [Component Name] Greeting
Paramètre [param_name] ani_auth
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_greeting:get_account_details

Paramètres d'entrée

Les paramètres d'entrée configurent certains comportements du composant. Une ou plusieurs conditions du flux utilisent ces paramètres pour déterminer le comportement du composant. Vous devez définir des paramètres limités au flux sur la page de démarrage du composant, comme décrit ci-dessous. Vous pouvez définir des paramètres de portée session à l'aide d'un flux d'appel ou sur la page de démarrage de ce composant.

Ce composant prédéfini accepte les paramètres d'entrée suivants :

Nom du paramètre Description Format d'entrée
$flow.company_name Capture le nom de l'entreprise à utiliser de manière dynamique dans l'invite d'accueil. string

Pour configurer les paramètres d'entrée de ce composant, développez la section pour obtenir des instructions.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Compilation.
  5. Cliquez sur le composant importé dans la section Flows (Flux).
  6. Cliquez sur la page de démarrage dans la section Pages.
  7. Cliquez sur la route true (vrai) sur la page d'accueil.
  8. Dans la fenêtre "Route", modifiez les valeurs des préréglages des paramètres si nécessaire.
  9. Cliquez sur Enregistrer.

Paramètres de sortie

Les paramètres de sortie sont des paramètres de session qui restent actifs après la sortie du composant. Ces paramètres contiennent des informations importantes collectées par le composant.

Nom du paramètre Description Format de sortie
ani_auth Capture le résultat de l'authentification basée sur l'ANI. La valeur par défaut est false. booléen
auth_level Indique le niveau d'authentification de l'appelant. La valeur par défaut est null. -1 indique que l'utilisateur n'a pas été authentifié par son ANI. 0 indique que l'authentification ANI a réussi. entier

Configuration de base

Pour configurer ce composant prédéfini :

  1. Importez le composant prédéfini.
  2. Configurez le webhook flexible fourni avec vos services externes. Consultez Configuration du webhook.

Configuration du webhook

Pour utiliser ce composant, configurez les webhooks flexibles inclus afin de récupérer les informations nécessaires auprès de vos services externes.

Obtenir les détails du compte

Le composant utilise le webhook prebuilt_components_greeting:get_account_details pour identifier l'appelant à l'aide de son ANI. Si le numéro de téléphone de l'appelant existe dans le service externe configuré, le composant récupère les informations pertinentes pour personnaliser l'expérience, y compris le nom et l'adresse e-mail de l'appelant.

Paramètres de requête API

Le composant fournit les paramètres suivants en tant qu'entrées de la requête API :

Nom du paramètre Description Format de sortie
phone_number Numéro de téléphone de l'appelant (ANI). entier

Paramètres de réponse de l'API

Le composant récupère les paramètres suivants à partir de la réponse de l'API :

Nom du paramètre Description Format de sortie
user_first_name Prénom de l'utilisateur, utilisé pour lui adresser un message d'accueil personnalisé. string
user_email Adresse e-mail de l'utilisateur. string

Pour configurer le webhook "Obtenir les détails du compte" pour ce composant, développez la section pour obtenir des instructions.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Webhooks.
  6. Sélectionnez le webhook prebuilt_components_greeting:get_account_details.
  7. Remplacez l'URL dans le champ URL du webhook de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
  8. Examinez et mettez à jour le corps de la requête pour créer le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez et modifiez les paramètres d'authentification si nécessaire.
  11. Cliquez sur Enregistrer.

Terminé

Le composant prédéfini et son webhook sont maintenant configurés et prêts à être testés.