Vínculo a tus acciones (Dialogflow)

Puedes generar una URL que vincule directamente a la acción específica para cada acción. A los usuarios que hagan clic en el vínculo del Asistente (antes denominado vínculos de acciones) en un navegador web o para dispositivos móviles se los redireccionará al Asistente en sus dispositivos, donde interactuarán directamente con la Acción correspondiente.

Estos son algunos ejemplos de vínculos útiles del Asistente:

• Vinculación de usuarios a instrucciones guiadas por voz desde un sitio web de instructivos.
• Vinculación de usuarios a una experiencia de asistencia al cliente desde una página de "Obtener ayuda".
• Vincular usuarios a un intent de actualización para que puedan habilitar las actualizaciones futuras

Nota: Los vínculos de Asistente son diferentes de los vínculos web del directorio, que envían a un usuario a tu página de directorio.

Si deseas generar una URL para una Acción, haz lo siguiente:

1. En la Consola de Actions, navega a Develop > Actions.
2. Haz clic en la acción para la que deseas generar un vínculo.
3. En la sección Vínculos, habilita ¿Quieres habilitar una URL para esta acción?
4. Ingresa un Título del vínculo. Este título debe incluir un verbo que describa lo que hará la acción. Por ejemplo, si la acción lleva al usuario a un flujo de transacción para comprar entradas a un concierto, un título de vínculo útil sería "comprar entradas para conciertos".
5. Haz clic en Guardar.

Puedes copiar la URL proporcionada y hacer referencia a ella donde quieras dirigir a los usuarios a esta acción específica.

Nota: Si habilitas un vínculo de Asistente después de implementar la Acción, deberás volver a implementarla para que el vínculo surta efecto.

Parámetros de la vinculación de Asistente

De manera opcional, los vínculos de Asistente pueden contener un intent y parámetros en la URL. Google maneja los parámetros según el tipo de intent especificado en la URL.

Especificación de la URL del vínculo del Asistente

La sintaxis general de la URL de un vínculo de Asistente es la siguiente:

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

Los parámetros de URL que puedes configurar se describen en la siguiente tabla:

Parámetro de URL	Descripción
$action_id	Es el identificador numérico de la acción.
$intent	Nombre completo de un intent integrado o personalizado.
$param	Nombre completo de un parámetro de intent especificado en el paquete de acciones.
$value	Valor codificado como URL del tipo declarado para $param en el paquete de acciones.
$utm_param	Lista de uno o más tipos de parámetros de UTM. Los valores válidos son utm_source, utm_medium, utm_campaign, utm_term y utm_content.
$utm_value	El valor de string del parámetro de UTM.

URLs de vínculo de Asistente con intents integrados

Si el vínculo de Asistente contiene un intent integrado (el intent comienza con actions.intent.*), Google intentará extraer los parámetros de intent integrados en la URL y pasarlos a tu acción. Se quitan los parámetros que Google no comprende como parámetros de intent integrados.

En el caso de las acciones conversacionales, Google envía estos parámetros a tu entrega como parte del mensaje AppRequest.

En el siguiente ejemplo, se muestra cómo podrías especificar una URL de vínculo del Asistente que incluya un intent integrado con un solo parámetro de intent:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE&param.astrologySign=%22cancer%22

URLs de vínculo de Asistente con intents personalizados

En el caso de los intents personalizados, Google extrae solo los parámetros que define tu Acción como parte del intent y descarta cualquier otro parámetro.

En el siguiente ejemplo, se muestra cómo podrías especificar una URL de vínculo del Asistente que incluya un intent personalizado:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

Para la URL de ejemplo anterior, en AppRequest, Google agrega un objeto JSON de la siguiente manera:

argument {
  name: ‘topic’,
  raw_text: ‘sports’,
  text_value: ‘sports’,
}

URLs de vínculo de Asistente sin intents

Si no especificas un intent en el vínculo de Asistente, Google vinculará al intent MAIN (actions.intent.MAIN) de tu acción de forma predeterminada con el siguiente comportamiento:

• Si no habilitaste explícitamente el intent MAIN en el vínculo de Asistente, Google activará el intent principal sin ningún parámetro, de manera similar al comportamiento de "Hablar con app_name".
• Si habilitaste explícitamente el intent MAIN, Google pasará los parámetros a tus acciones.

En el siguiente ejemplo, se muestra cómo podrías especificar una URL de vínculo del Asistente sin intent:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

URLs de vínculo del Asistente con parámetros de UTM

Los parámetros de UTM son cadenas que Google envía a tu acción cuando los usuarios hacen clic en un vínculo con el Asistente y que puedes usar más adelante para obtener estadísticas.

Entre los parámetros de UTM que Google envía a tu acción, se incluyen los siguientes:

• utm_source
• utm_medium
• utm_campaign
• utm_term
• utm_content

En el siguiente ejemplo, se muestra cómo podrías especificar una URL de vínculo del Asistente que incluya parámetros UTM:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

Para la URL de ejemplo anterior, Google agrega los siguientes argumentos en el mensaje AppRequest:

argument {
  name: ‘utm_source’,
  raw_text: ‘Google’,
  text_value: ‘Google’,
}
argument {
  name: ‘utm_medium’,
  raw_text: ‘email’,
  text_value: ‘email’,
}
argument {
  name: ‘utm_campaign’,
  raw_text: ‘holiday sale’,
  text_value: ‘holiday sale’,
}

Cómo probar los vínculos de Asistente

Puedes probar los vínculos del Asistente para cualquier intent (principal o personalizado, con o sin parámetros) a través del simulador o un dispositivo.

Para probar el vínculo del Asistente, haz lo siguiente:

1. Habilita el vínculo de Asistente en la consola.
2. Accede al Asistente con la misma cuenta que usaste para crear tu proyecto de Actions on Google.
3. Crea una versión del vínculo de Asistente en la que se pueda hacer clic (en correo electrónico, chat, documento, etcétera).
4. En un dispositivo compatible con el Asistente, haz clic en el vínculo que creaste en el paso anterior.

Una vez que confirmes que el Asistente funciona como corresponde, deberás volver a implementar la Acción para que el vínculo esté disponible para tus usuarios.

Nota: Los vínculos de Asistente están disponibles en todos los canales de implementación (alfa, beta y de producción). Por ejemplo, si el vínculo del Asistente está habilitado en la versión alfa de la acción, estará disponible para los verificadores alfa.

Restricciones y prácticas recomendadas

Ahora puedes distribuir la URL del vínculo del Asistente y hacer referencia a ella fuera del directorio o de otros servicios de Google. Ten en cuenta que se aplican las siguientes restricciones y prácticas recomendadas:

• Asegúrate de que sigues admitiendo todos los vínculos de Asistente. Si distribuyes un vínculo de Asistente que luego se interrumpe, es posible que tu proyecto de acciones se marque como en mal estado o se elimine.

• Publicar un vínculo significa que admites la activación de fuentes no confiables. Para las Acciones vinculadas, debes confirmar explícitamente con el usuario antes de realizar cualquier "acción real". Por ejemplo, una acción que desactiva un dispositivo de hogar inteligente debería pedirle al usuario que diga "¿Confirmas que quieres desactivar $applianceName?".

  En este contexto, una "acción real" es cualquier acción que afecta los servicios, los datos, los dispositivos, las redes, las computadoras o las APIs del usuario. Por ejemplo, para enviar un correo electrónico, realizar una transacción, alterar el estado de un dispositivo de casa inteligente, crear una suscripción o actualizar un contenido.