Componente precompilado de la recopilación de direcciones

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:

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

  1. El usuario proporciona una dirección parcial.
  2. 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

  1. El usuario proporciona una dirección parcial.
  2. El usuario rechaza la parte adivinada y proporciona su propia entrada.
  3. El agente acepta la entrada proporcionada por el usuario y vuelve a solicitar la confirmación.
  4. 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_1
  • archipelago
  • country
  • locality
  • postal_code
  • route
  • street_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.

  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 de 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 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.
{
"admin-area": string,
"city": string,
"country": string,
"island": string,
"route": string,
"zip-code": string,
"street-number": string
}
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:

  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 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:

  1. Procesa los parámetros capturados de Dialogflow CX, forma la solicitud y verifica la dirección con la API de Address Validation.
  2. 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:

  1. Ve a 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 prebuilt_components_address_collection:address_validation.
  7. 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>.
  8. En la configuración de Autenticación, configura el nombre de usuario como key y establece la contraseña para tu clave de API de Google Maps.
  9. Haz clic en Guardar.

Completado

El componente compilado previamente y su webhook ya están configurados y listos para probarse.