Componente precompilado de recopilación de direcciones

El componente compilado previamente de recopilación de direcciones recopila una dirección del usuario final y usa la API de validación de direcciones de Google para validar las direcciones.

Limitaciones

Además de las limitaciones comunes de los componentes compilados previamente, este componente tiene las siguientes limitaciones:

Funciones adicionales

Este componente precompilado proporciona las siguientes funcionalidades adicionales:

Diálogos de muestra

En los siguientes diálogos de muestra, se muestran situaciones comunes que controla este componente compilado previamente. En los diálogos de muestra, se muestra el comportamiento cuando se llama al componente mediante telefonía, lo que activa el intent de bienvenida predeterminado y la primera respuesta del agente al comienzo de la conversación.

Dirección válida completa

El usuario final proporciona una dirección completa y el componente de recopilación de direcciones la verifica con éxito.

Entrada del usuario Respuesta del agente
Para comenzar, dime tu dirección completa.
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, EE.UU.
Reuní la dirección final: el número de la 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 reuní la dirección.

Dirección parcial válida con elementos inferidos

El usuario final proporciona una dirección parcial; el agente adivina la parte faltante y la verifica con éxito después de la confirmación del usuario final.

Entrada del usuario Respuesta del agente
Para comenzar, dime tu dirección completa.
1600 Amphitheatre Parkway
Supongo que hay 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 reuní la dirección.

Dirección parcial válida con elementos proporcionados por el usuario

El usuario final proporciona una dirección parcial; el agente adivina la parte faltante, pero el usuario final proporciona su propia entrada después de decir “no”, y el agente acepta la dirección correctamente.

Entrada del usuario Respuesta del agente
Para comenzar, dime tu dirección completa.
1600 Amphitheatre Parkway
Supongo que hay 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.
Muy bien. Dime qué parte de la dirección hay que cambiar.
Código postal
¿Puedes proporcionarme el código postal?
94044
Terminé con esta actualización. ¿Hay algo más que deba cambiar? Di sí o no.
sin
Después de la validación, reemplacé el código postal por 94043.

Ya recopilé la dirección final: el número de la 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 reuní la dirección.

No se reconoce la entrada

El componente sale del flujo después de que el usuario final 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
Aún no pude entender eso. Para comenzar, dime tu dirección completa.
genial
Lo siento, no entiendo lo que dices.

Dirección no compatible

El componente sale del flujo después de que el usuario final proporciona una dirección que actualmente no es compatible con la API de Address Validation.

Entrada del usuario Respuesta del agente
Para comenzar, dime tu dirección completa.
India
En este momento, no puedo validar las direcciones en esa región.

Validación de direcciones

Para comprender cómo el componente de recopilación de direcciones valida las direcciones, consulta Descripción general de la API de Address Validation.

El componente de recopilación de direcciones captura la entrada del usuario final mediante la entidad del sistema@sys.address y envía la dirección capturada a la API de Address Validation para extraer los elementos de dirección y continuar con su procesamiento.

La API de Address Validation muestra los siguientes elementos de dirección, que el componente usa para recopilar y validar una dirección completa:

  • administrative_area_level_1
  • archipiélago
  • country
  • localidad
  • postal_code
  • ruta
  • street_number

Puedes probar la demostración de validación de direcciones de Google con cualquier dirección de una región compatible.

Convenciones de nombres

Este componente compilado previamente usa las siguientes convenciones de nombres:

Atributo Formato Ejemplo
Flujo [Nombre del componente] Recopilación de direcciones
Intent específico de 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 son parámetros que se usan para configurar ciertos comportamientos del componente. Una o más condiciones dentro del flujo usarán los parámetros para determinar cómo debe comportarse el componente. Los parámetros con alcance de flujo deben establecerse en la página de inicio del componente, como se describe a continuación. Los parámetros centrados en la sesión se pueden establecer mediante un flujo de llamada o en la página de inicio de este componente.

Para configurar qué elementos de dirección requiere este componente, modifica los ajustes predeterminados de los parámetros en la página de inicio del flujo.

Este componente compilado previamente acepta los siguientes parámetros de entrada:

Nombre del parámetro Descripción Formato de entrada
$flow.zip_code Si es obligatorio incluir el elemento de dirección de código postal, configúralo como true; de lo contrario, es false. boolean
$flow.city Si es obligatorio incluir el elemento de dirección de la ciudad, configúralo como true; de lo contrario, es false. boolean
$flow.admin_area Si es obligatorio incluir el elemento de la dirección del área administrativa, configúralo como true; de lo contrario, configúralo como false. boolean
$flow.street_number Si se requiere el elemento de dirección del número de calle, configúralo como true; de lo contrario, es false. boolean
$flow.route Si es obligatorio el elemento de la dirección de ruta, configúralo como true; de lo contrario, es false. boolean
$flow.country Si se requiere el elemento de dirección de país, configúralo como true; de lo contrario, es false. boolean
$flow.island Si el elemento de dirección de la isla es obligatorio, configúralo como true; de lo contrario, es false. boolean
$flow.retry_num Establece el límite máximo de reintentos para las llamadas de webhook de la API de Maps Address Validation integer

Para configurar los parámetros de entrada de este componente, expande las instrucciones.

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Selecciona la pestaña Build.
  5. Haz clic en el componente importado en la sección Flujos.
  6. Haz clic en la página de inicio en la sección Páginas.
  7. Haz clic en la ruta true en la página de inicio.
  8. En la ventana Route, edita los valores Parameter Presets según sea necesario.
  9. Haz clic en Guardar.

Los parámetros de resultado

Los parámetros de salida son parámetros de sesión que permanecerán activos después de salir del componente. Estos parámetros contienen información importante que recopila el componente. Este componente compilado previamente proporciona valores para los siguientes parámetros de salida:

Nombre del parámetro Descripción Formato de salida
address_collection_address Este parámetro muestra el objeto address si el componente capturó una dirección. 

{
  "admin-area": string,
  "city": string,
  "country": string,
  "island": string,
  "route": string,
  "zip-code": string,
  "street-number": string
}
address_collection_status Este parámetro muestra el estado de la dirección recopilada. El valor que se muestra es uno de los siguientes:

VALID_ADDRESS: dirección se recopiló y validó por la API de Address Validation.

INVALID_ADDRESS: el usuario final confirmó la dirección, pero la API de validación de direcciones no validó ni marcó uno o más elementos como UNCONFIRMED_BUT_PLAUSIBLE.

MAPS_API_ERROR: la dirección no fue recolectada debido a un error de la API de Address Validation.

COUNTRY_NOT_SUPPORTED: la dirección no fue recolectada porque la API de Validación de direcciones no fue confirmada.

COUNTRY_NOT_SUPPORTED: la dirección no fue recolectada porque la API de Validación de direcciones no fue confirmadaNO_USER_CONFIRMATION		 

string

Configuración básica

Para configurar este componente precompilado, haz lo siguiente:

  1. Importa el componente compilado previamente.
  2. Habilita la API de Address Validation.
  3. Configura el webhook flexible proporcionado con tu clave de API de Maps; consulta la sección Configuración de webhooks a continuación.

Configuración de webhooks

Si quieres usar la API de Address Validation para validar las direcciones, deberás configurar el webhook flexible proporcionado con las credenciales correctas.

Webhook de validación de direcciones

Este webhook realiza las siguientes acciones:

  1. Procesa los parámetros de Dialogflow capturados, las solicitudes de formularios y verifica la dirección mediante la API de Address Validation.
  2. Extrae los elementos de direcciones inferidos, faltantes, confirmados, no confirmados y faltantes de la respuesta de la API de validación de direcciones de Google.

Para configurar el webhook para este componente, deberás actualizar la configuración de webhook con tu clave de API de Google Maps.

  1. Para recuperar tu clave de API, ve a Google Cloud Platform Console > APIs y servicios > Credenciales, selecciona tu clave de API de Google Maps y copia el campo Clave de API.

Para configurar el webhook, haz lo siguiente:

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Webhooks.
  6. Selecciona el webhook compilación_components_address_collection:dirección_validación.
  7. Reemplaza la URL en el campo URL de webhook de Dialogflow por la URL que incluye tu clave de API de Google Maps: https://addressvalidate.googleapis.com/v1:validateAddress?key=MAPS_API_KEY.
  8. En la configuración de Authentication, establece el nombre de usuario como key y configura la contraseña con tu clave de la API de Google Maps.
  9. Haz clic en Guardar.

Completado

Tu agente y su webhook ya deberían estar configurados y listos para las pruebas.

Anterior
Resumen de cuenta
Siguiente
Colección alfanumérica