El componente compilado previamente de recopilación de direcciones recopila una dirección de un cliente y la valida con la API de Address Validation de Google.
Limitaciones
Además de las limitaciones comunes de los componentes compilados previamente, este componente compilado previamente incluye las siguientes limitaciones:
- Solo admite direcciones de los países que se indican en los detalles de cobertura de la API de Address Validation.
Características adicionales
Este componente precompilado proporciona las siguientes funciones adicionales:
Diálogos de muestra
En los diálogos de muestra, se indican situaciones comunes que controla este componente precompilado. Demuestran el comportamiento cuando el usuario llama al componente con la telefonía, lo que activa el intent de bienvenida predeterminado y la primera respuesta del agente al comienzo de la conversación.
Validación de la dirección completa
El usuario proporciona una dirección completa y el componente de recopilación de direcciones la verifica.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Para comenzar, dime tu dirección completa. | |
| 1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, EE.UU. | |
| Recopilé la dirección final: el número de calle es 1600, la ruta es Amphitheatre Parkway, la ciudad es Mountain View, el área administrativa es CA, el código postal es 94043 y el país es EE.UU. ¿Verdad? Di sí o no. | |
| sí | |
| Fantástico, ya tengo la dirección. |
Dirección válida parcial con elementos inferidos
- El usuario proporciona una dirección parcial.
- El agente adivina la parte faltante y la verifica después de la confirmación del usuario.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Para comenzar, dime tu dirección completa. | |
| 1600 Amphitheatre Parkway | |
| Adiviné una parte de la dirección: la ciudad es Mountain View, el código postal es 94043, el área administrativa es CA y el país es EE.UU. Recopilé la dirección final: el número de calle es 1600, la ruta es Amphitheatre Parkway, la ciudad es Mountain View, el área administrativa es CA, el código postal es 94043 y el país es EE.UU. ¿Verdad? Di sí o no. |
|
| Sí | |
| Fantástico, ya tengo la dirección. |
Dirección válida parcial con elementos proporcionados por el usuario
- El usuario proporciona una dirección parcial.
- El usuario rechaza la parte adivinada y proporciona su propia entrada.
- El agente acepta la entrada proporcionada por el usuario y vuelve a solicitar la confirmación.
- El usuario acepta la dirección final.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Para comenzar, dime tu dirección completa. | |
| 1600 Amphitheatre Parkway | |
| Adiviné una parte de la dirección: la ciudad es Mountain View, el código postal es 94043, el área administrativa es CA y el país es EE.UU. Recopilé la dirección final: el número de calle es 1600, la ruta es Amphitheatre Parkway, la ciudad es Mountain View, el área administrativa es CA, el código postal es 94043 y el país es EE.UU. ¿Verdad? Di sí o no. |
|
| No | |
| De acuerdo. Dime qué parte de la dirección se debe cambiar. | |
| Código postal | |
| ¿Puedes compartir el código postal? | |
| 94044 | |
| Ya terminé con esta actualización. ¿Hay algo más que quieras cambiar? Di sí o no. | |
| no | |
| Después de la validación, reemplacé el código postal por 94043. Recopilé la dirección final: el número de calle es 1600, la ruta es Amphitheatre Parkway, la ciudad es Mountain View, el área administrativa es CA, el código postal es 94043 y el país es EE.UU. ¿Verdad? Di sí o no. |
|
| sí | |
| Fantástico, ya tengo la dirección. |
No se reconoce la entrada
El componente sale del flujo después de que el usuario proporciona una entrada no reconocida tres veces.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Para comenzar, dime tu dirección completa. | |
| Está bien | |
| Lo siento, no entendí. Para comenzar, dime tu dirección completa. | |
| amabilidad | |
| Mmm, sigo sin entender. Para comenzar, dime tu dirección completa. | |
| genial | |
| Lo siento, me cuesta entender tu respuesta. |
No se admite la dirección
El componente sale del flujo después de que el usuario proporciona una dirección que no es compatible con la API de Address Validation.
| Entrada del usuario | Respuesta del agente |
|---|---|
| Para comenzar, dime tu dirección completa. | |
| India | |
| Lo siento, pero no puedo validar direcciones en esa región. |
Validación de direcciones
Para obtener más información sobre cómo el componente de recopilación de direcciones valida las direcciones, consulta la Descripción general de la API de Address Validation.
El componente de recopilación de direcciones captura la entrada del usuario con la entidad del sistema @sys.address y envía la dirección capturada a la API de Address Validation para extraer los elementos de la dirección y procesarlos más adelante.
La API de Address Validation devuelve los siguientes elementos de dirección, que puedes usar para recopilar y validar una dirección completa:
administrative_area_level_1archipelagocountrylocalitypostal_coderoutestreet_number
Puedes probar la demostración de Address Validation de Google con cualquier dirección de una región admitida.
Convenciones de nombres
Este componente precompilado usa las siguientes convenciones de nombres:
| Función | Formato | Ejemplo |
|---|---|---|
| Flujo | [Nombre del componente] | Recopilación de direcciones |
| Intención específica del componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_address_collection_locality |
| Parámetro | [param_name] | user_provided_address |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_address_collection:address_validation |
Parámetros de entrada
Los parámetros de entrada configuran ciertos comportamientos del componente. Una o más condiciones dentro del flujo usan estos parámetros para determinar cómo se comporta el componente. Debes establecer parámetros con alcance de flujo en la página de inicio del componente. Puedes establecer parámetros centrados en la sesión usando un flujo de llamadas o en la página de inicio de este componente.
El usuario puede configurar qué elementos de dirección requiere este componente modificando los ajustes predeterminados de los parámetros en la página de inicio del flujo.
Este componente precompilado acepta los siguientes parámetros de entrada:
| Nombre del parámetro | Descripción | Formato de entrada |
|---|---|---|
| $flow.zip_code | Si el elemento de dirección del código postal es obligatorio, establécelo en true; de lo contrario, establécelo en false. |
booleano |
| $flow.city | Si el elemento de dirección de la ciudad es obligatorio, establécelo en true; de lo contrario, establécelo en false. |
booleano |
| $flow.admin_area | Si el elemento de dirección del área administrativa es obligatorio, establécelo en true; de lo contrario, establécelo en false. |
booleano |
| $flow.street_number | Si el elemento de dirección del número de la calle es obligatorio, establécelo en true; de lo contrario, establécelo en false. |
booleano |
| $flow.route | Si se requiere el elemento de dirección de ruta, establécelo en true; de lo contrario, establécelo en false. |
booleano |
| $flow.country | Si el elemento de dirección del país es obligatorio, establécelo en true; de lo contrario, establécelo en false. |
booleano |
| $flow.island | Si el elemento de dirección de isla es obligatorio, configúralo como true; de lo contrario, configúralo como false. |
booleano |
| $flow.retry_num | Establece el límite máximo de reintentos para las llamadas de webhook de la API de Address Validation de Maps. | integer |
Para configurar los parámetros de entrada de este componente, expande las instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Build.
- Haz clic en el componente importado en la sección Flujos.
- Haz clic en la página de inicio en la sección Páginas.
- Haz clic en la ruta true en la página de inicio.
- En la ventana Route, edita los valores de Parameter Presets según sea necesario.
- Haz clic en Guardar.
Los parámetros de resultado
Los parámetros de salida son parámetros de sesión que permanecen activos después de salir del componente. Estos parámetros contienen información importante que recopila el componente.
El componente precompilado proporciona los siguientes parámetros de salida:
| Nombre del parámetro | Descripción | Formato de salida |
|---|---|---|
| address_collection_address | Este parámetro devuelve el objeto de dirección si el componente capturó una dirección. | { |
| address_collection_status | Este parámetro devuelve el estado de la dirección recopilada. El valor que se devuelve es uno de los siguientes:VALID_ADDRESS: La API de Address Validation recopiló y validó la dirección.INVALID_ADDRESS: El usuario confirmó la dirección, pero la API de Address Validation no validó uno o más elementos, o bien los marcó como UNCONFIRMED_BUT_PLAUSIBLE.MAPS_API_ERROR: No se recopiló la dirección debido a un error de la API de Address Validation.COUNTRY_NOT_SUPPORTED: No se recopiló la dirección porque la API de Address Validation no admite esa región.NO_USER_CONFIRMATION: No se confirmó la dirección porque el usuario no la confirmó. |
string |
Configuración básica
Para configurar este componente compilado previamente, haz lo siguiente:
- Importa el componente compilado previamente.
- Habilita la API de Address Validation.
- Configura el webhook flexible proporcionado con tu clave de API de Google Maps. Para obtener más información, consulta la sección Configuración de webhook.
Configuración del webhook
Para validar direcciones con la API de Address Validation, configura el webhook flexible proporcionado con las credenciales correctas.
Webhook de Address Validation
Este webhook realiza las siguientes acciones:
- Procesa los parámetros capturados de Dialogflow CX, forma la solicitud y verifica la dirección con la API de Address Validation.
- Extrae elementos de dirección confirmados, no confirmados, faltantes y deducidos de la respuesta de la API de Address Validation.
Actualiza la configuración del webhook con la clave de API de Google Maps correcta para configurar el webhook de este componente.
Para recuperar tu clave de API, ve a Google Cloud Consola > APIs y servicios > Credenciales, selecciona tu clave de API de Maps y copia el campo de la clave de API.
Para configurar el webhook, sigue estos pasos:
- Ve a la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud .
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Webhooks.
- Selecciona el webhook
prebuilt_components_address_collection:address_validation. - Reemplaza la URL en el campo URL de webhook de Dialogflow CX por la URL que incluye tu clave de API de Google Maps:
https://addressvalidation.googleapis.com/v1:validateAddress?key=<var>MAPS_API_KEY</var>. - En la configuración de Autenticación, configura el nombre de usuario como
keyy establece la contraseña para tu clave de API de Google Maps. - Haz clic en Guardar.
Completado
El componente compilado previamente y su webhook ya están configurados y listos para probarse.