Composant prédéfini de collecte d'adresses

Le composant prédéfini de collecte d'adresses collecte une adresse auprès de l'utilisateur final et utilise l'API Google Address Validation pour valider les adresses.

Limites

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

• Ne prend en charge que les adresses des pays listés dans les détails de la couverture de l'API Address Validation.

Fonctionnalités supplémentaires

Ce composant prédéfini fournit les fonctionnalités supplémentaires suivantes :

• Répéter
• Salle d'attente
• Lecture

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. Les exemples de dialogues illustrent le comportement lorsque le composant est appelé par téléphone, ce qui déclenche l'intent d'accueil par défaut et la première réponse de l'agent au début de la conversation.

Adresse complète et valide

L'utilisateur final fournit une adresse complète et le composant de collecte d'adresses la valide.

Entrée utilisateur	Réponse de l'agent
	Pour commencer, veuillez m'indiquer votre adresse complète.
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, États-Unis
	J'ai collecté l'adresse finale : le numéro de rue est 1600, la route est Amphitheatre Parkway, la ville est Mountain View, la région administrative est CA, le code postal est 94043 et le pays est les États-Unis. Est-ce bien cela ? Veuillez répondre par oui ou par non.
oui
	Super, j'ai récupéré l'adresse.

Adresse partiellement valide avec des éléments inférés

L'utilisateur final fournit une adresse partielle. L'agent devine la partie manquante et la valide après confirmation de l'utilisateur final.

Entrée utilisateur	Réponse de l'agent
	Pour commencer, veuillez m'indiquer votre adresse complète.
1600 Amphitheatre Parkway
	J'ai deviné une partie de l'adresse : la ville est Mountain View, le code postal est 94043, la région administrative est CA et le pays est USA. J'ai trouvé l'adresse finale : le numéro de rue est 1600, la route est Amphitheatre Parkway, la ville est Mountain View, la région administrative est CA, le code postal est 94043 et le pays est USA. Est-ce bien cela ? Veuillez répondre par oui ou par non.
Oui
	Super, j'ai récupéré l'adresse.

Adresse partielle valide avec des éléments fournis par l'utilisateur

L'utilisateur final fournit une adresse partielle. L'agent devine la partie manquante, mais l'utilisateur final fournit sa propre saisie après avoir dit "non". L'agent accepte l'adresse.

Entrée utilisateur	Réponse de l'agent
	Pour commencer, veuillez m'indiquer votre adresse complète.
1600 Amphitheatre Parkway
	J'ai deviné une partie de l'adresse : la ville est Mountain View, le code postal est 94043, la région administrative est CA et le pays est USA. J'ai trouvé l'adresse finale : le numéro de rue est 1600, la route est Amphitheatre Parkway, la ville est Mountain View, la région administrative est CA, le code postal est 94043 et le pays est USA. Est-ce bien cela ? Veuillez répondre par oui ou par non.
Non
	D'accord. Veuillez m'indiquer la partie de l'adresse à modifier.
Code postal
	Pourriez-vous nous indiquer le code postal ?
94044
	J'ai terminé cette mise à jour. Y a-t-il autre chose à modifier ? Veuillez répondre par oui ou par non.
non
	Après validation, j'ai remplacé le code postal par 94043. J'ai collecté l'adresse finale : le numéro de rue est 1600, la route est Amphitheatre Parkway, la ville est Mountain View, la région administrative est CA, le code postal est 94043 et le pays est les États-Unis. Est-ce bien cela ? Veuillez répondre par oui ou par non.
oui
	Super, j'ai récupéré l'adresse.

Entrée non reconnue

Le composant quitte le flux après que l'utilisateur final a fourni une entrée non reconnue à trois reprises.

Entrée utilisateur	Réponse de l'agent
	Pour commencer, veuillez m'indiquer votre adresse complète.
C'est bon
	Désolé, je n'ai pas compris. Pour commencer, veuillez m'indiquer votre adresse complète.
bien
	Hmm, je n'ai toujours pas compris. Pour commencer, veuillez m'indiquer votre adresse complète.
formidable
	Excusez-moi, je ne comprends pas votre réponse.

Adresse non acceptée

Le composant quitte le flux une fois que l'utilisateur final a fourni une adresse qui n'est pas actuellement acceptée par l'API Address Validation.

Entrée utilisateur	Réponse de l'agent
	Pour commencer, veuillez m'indiquer votre adresse complète.
Inde
	Je suis désolé, mais je ne peux pas valider les adresses dans cette région pour le moment.

Validation de l'adresse

Pour comprendre comment le composant de collecte d'adresses valide les adresses, consultez Présentation de l'API Address Validation.

Le composant de collecte d'adresses capture les entrées de l'utilisateur final à l'aide de l'entité systè[e-mail] et envoie l'adresse capturée à l'API Address Validation pour extraire les éléments d'adresse en vue d'un traitement ultérieur.

Les éléments d'adresse suivants sont renvoyés par l'API Address Validation et sont utilisés par le composant pour collecter et valider une adresse complète :

• administrative_area_level_1
• archipel
• country
• locality
• postal_code
• route
• street_number

Vous pouvez essayer la démonstration de validation d'adresse Google avec n'importe quelle adresse d'une région acceptée.

Conventions d'attribution de noms

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

Fonctionnalité	Format	Exemple
Flow	[Nom du composant]	Collecte d'adresses
Intention spécifique au composant	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_address_collection_locality
Paramètre	[param_name]	user_provided_address
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_address_collection:address_validation

Paramètres d'entrée

Les paramètres d'entrée sont utilisés pour configurer certains comportements du composant. Les paramètres seront utilisés par une ou plusieurs conditions dans le flux pour déterminer le comportement du composant. Les paramètres de portée de flux doivent être définis sur la page de démarrage du composant, comme décrit ci-dessous. Les paramètres de portée session peuvent être définis par un flux d'appel ou sur la page de démarrage de ce composant.

Vous pouvez configurer les éléments d'adresse requis par ce composant en modifiant les préréglages des paramètres sur la page de démarrage du flux.

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

Nom du paramètre	Description	Format d'entrée
$flow.zip_code	Si l'élément d'adresse du code postal est obligatoire, définissez-le sur true, sinon sur false.	booléen
$flow.city	Si l'élément d'adresse de la ville est obligatoire, définissez-le sur true, sinon sur false.	booléen
$flow.admin_area	Si l'élément d'adresse de la région administrative est obligatoire, définissez-le sur true, sinon sur false.	booléen
$flow.street_number	Si l'élément d'adresse "numéro de rue" est obligatoire, définissez-le sur true, sinon sur false.	booléen
$flow.route	Si l'élément d'adresse de route est obligatoire, définissez-le sur true, sinon sur false.	booléen
$flow.country	Si l'élément d'adresse du pays est obligatoire, définissez-le sur true, sinon sur false.	booléen
$flow.island	Si l'élément d'adresse de l'îlot est obligatoire, définissez-le sur true, sinon sur false.	booléen
$flow.retry_num	Définit la limite maximale de tentatives pour les appels de webhook de l'API Maps Address Validation	entier

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 Build (Créer).
5. Cliquez sur le composant importé dans la section Flux.
6. Cliquez sur la page de démarrage dans la section Pages.
7. Cliquez sur la route true (vrai) sur la page de démarrage.
8. Dans la fenêtre "Route", modifiez les valeurs de Parameter Presets (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 resteront actifs après la fermeture du composant. Ces paramètres contiennent des informations importantes collectées par le composant. Ce composant prédéfini fournit des valeurs pour les paramètres de sortie suivants :

Nom du paramètre	Description	Format de sortie
address_collection_address	Ce paramètre renvoie l'objet adresse si une adresse a été saisie par le composant.	{ "admin-area": string, "city": string, "country": string, "island": string, "route": string, "zip-code": string, "street-number": string }
address_collection_status	Ce paramètre renvoie l'état de l'adresse collectée. La valeur renvoyée est l'une des suivantes : VALID_ADDRESS : l'adresse a été collectée et validée par l'API Address Validation. INVALID_ADDRESS : l'adresse a été confirmée par l'utilisateur final, mais un ou plusieurs éléments n'ont pas été validés ou ont été marqués comme UNCONFIRMED_BUT_PLAUSIBLE par l'API Address Validation. MAPS_API_ERROR : l'adresse n'a pas été collectée en raison d'une erreur de l'API Address Validation. COUNTRY_NOT_SUPPORTED : l'adresse n'a pas été collectée, car l'API Address Validation n'est pas compatible avec cette région. NO_USER_CONFIRMATION : l'adresse n'a pas été confirmée, car l'utilisateur final n'a pas confirmé d'adresse.	string

Configuration de base

Pour configurer ce composant prédéfini :

1. Importez le composant prédéfini.
2. Activez l'API Address Validation.
3. Configurez le webhook flexible fourni avec votre clé API Google Maps. Pour en savoir plus, consultez la section "Configurer le webhook" ci-dessous.

Configurer un webhook

Pour utiliser l'API Address Validation afin de valider des adresses, vous devez configurer le webhook flexible fourni avec les identifiants appropriés.

Webhook Address Validation

Ce webhook effectue les actions suivantes :

1. Traite les paramètres Dialogflow CX capturés, demande le formulaire et valide l'adresse à l'aide de l'API Address Validation.
2. Extrait les éléments d'adresse confirmés, non confirmés, manquants et inférés de la réponse de l'API Address Validation de Google.

Pour configurer le webhook de ce composant, vous devez mettre à jour les paramètres du webhook avec votre clé API Google Maps.

1. Pour récupérer votre clé API, accédez à Console Google Cloud Platform > API et services > Identifiants, sélectionnez votre clé API Google Maps, puis copiez le champ "Clé API".

Pour configurer le webhook :

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_address_collection:address_validation.
7. Remplacez l'URL dans le champ URL du webhook de Dialogflow CX par l'URL incluant votre clé API Maps : https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY.
8. Dans les paramètres Authentication (Authentification), configurez le nom d'utilisateur sur key et définissez le mot de passe sur votre clé API Google Maps.
9. Cliquez sur Enregistrer.

Terminé

Votre agent et son webhook devraient maintenant être configurés et prêts à être testés.