Cette page a été traduite par l'API Cloud Translation.

Créer une association à vos actions (Dialogflow)

Vous pouvez générer une URL qui renvoie directement à l'action en question, pour chaque action. Les utilisateurs qui cliquent sur le lien "Assistant" (anciennement appelé "Liens d'action") dans un navigateur Web ou mobile seront redirigés vers l'Assistant sur leur appareil, où ils interagiront directement avec l'action correspondante.

Voici quelques exemples de liens utiles:

Redirection des utilisateurs vers des instructions vocales sur un site Web de démonstration
Rediriger les utilisateurs vers un service client depuis une page "Obtenir de l'aide"
Associez les utilisateurs à un intent de mise à jour pour qu'ils puissent accepter vos futures mises à jour.

Pour générer une URL pour une action, procédez comme suit:

Dans la console Actions, accédez à Develop > Actions (Développer > Actions).
Cliquez sur l'action pour laquelle vous souhaitez générer un lien.
Dans la section Liens, sélectionnez Souhaitez-vous activer une URL pour cette action ?
Saisissez un titre de lien. Ce titre doit inclure un verbe qui décrit en quoi consiste l'action. Par exemple, si votre action redirige l'utilisateur vers un flux de transaction pour acheter des billets pour un concert, un titre de lien utile pourrait être "acheter des places de concert".
Cliquez sur Enregistrer.

Vous pouvez copier l'URL fournie et la référencer où que vous souhaitiez rediriger les utilisateurs vers cette action.

Paramètres de l'Assistant

Les liens de l'Assistant peuvent éventuellement contenir un intent et des paramètres dans l'URL. Google gère les paramètres en fonction du type d'intent spécifié dans l'URL.

Spécification de l'URL du lien de l'Assistant

La syntaxe générale de l'URL d'un lien de l'Assistant est la suivante:

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

Les paramètres d'URL que vous pouvez définir sont décrits dans le tableau suivant:

Paramètre d'URL	Description
`$action_id`	Identifiant numérique de l'action.
`$intent`	Nom complet d'un intent intégré ou personnalisé.
`$param`	Nom complet d'un paramètre d'intent spécifié dans le package d'action.
`$value`	Valeur encodée au format URL, déclarée pour `$param` dans le package d'action.
`$utm_param`	Liste d'un ou de plusieurs types de paramètres UTM. Les valeurs valides sont `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` et `utm_content`.
`$utm_value`	Valeur de chaîne du paramètre UTM.

URL d'association de l'Assistant avec des intents intégrés

Si le lien de l'Assistant contient un intent intégré (dont l'intent commence par actions.intent.*), Google tente d'extraire les paramètres d'intent intégrés dans l'URL et de les transmettre à votre action. Tous les paramètres que Google ne comprend pas comme étant des paramètres d'intent intégrés sont supprimés.

Pour les actions de conversation, Google envoie ces paramètres à votre traitement dans le message AppRequest.

L'exemple suivant montre comment spécifier une URL de lien de l'Assistant incluant un intent intégré avec un seul paramètre d'intent:

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

URL d'association de l'Assistant avec des intents personnalisés

Pour les intents personnalisés, Google extrait uniquement les paramètres définis par votre action dans le cadre de l'intent et supprime tous les autres paramètres.

L'exemple suivant montre comment spécifier une URL de lien de l'Assistant incluant un intent personnalisé:

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

Pour l'exemple d'URL ci-dessus, dans AppRequest, Google ajoute un objet JSON comme suit:

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

URL de l'Assistant sans liens

Si vous ne spécifiez pas d'intent dans l'Assistant, Google l'associe par défaut à l'intent MAIN (actions.intent.MAIN) de votre action avec le comportement suivant:

Si vous n'avez pas explicitement activé l'intent MAIN dans le lien de l'Assistant, Google déclenche l'intent principal sans aucun paramètre, comme pour "Parler à app_name".
Si vous avez explicitement activé l'intent MAIN, Google transmet les paramètres à vos actions.

L'exemple suivant montre comment spécifier une URL de lien de l'Assistant sans intent:

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

URL de l'Assistant avec des paramètres UTM

Les paramètres UTM sont des chaînes que Google envoie à votre action lorsque les utilisateurs cliquent sur un lien Assistant. Vous pouvez les utiliser ultérieurement pour les analyses.

Les paramètres UTM que Google envoie à votre action sont les suivants:

utm_source
utm_medium
utm_campaign
utm_term
utm_content

L'exemple suivant montre comment spécifier une URL de lien de l'Assistant incluant des paramètres UTM:

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

Pour l'exemple d'URL ci-dessus, Google ajoute les arguments suivants dans le message 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’,
}

Tester les associations à l'Assistant

Vous pouvez tester les liens de l'Assistant pour n'importe quel intent (principal ou personnalisé, avec ou sans paramètres) via le simulateur ou un appareil.

Pour tester le lien de l'Assistant:

Activez le lien de l'Assistant dans la console.
Connectez-vous à l'Assistant avec le compte que vous avez utilisé pour créer votre projet Actions on Google.
Créez une version cliquable de votre lien Assistant (e-mail, chat, document, etc.).
Sur un appareil avec Assistant Google intégré, cliquez sur le lien créé à l'étape précédente.

Une fois que vous aurez confirmé que le lien de l'Assistant fonctionne comme prévu, vous devrez redéployer votre action pour que le lien soit disponible pour vos utilisateurs.

Restrictions et bonnes pratiques

Étant donné que l'URL du lien de l'Assistant peut désormais être distribuée et référencée en dehors de l'annuaire ou d'autres services Google, veuillez noter que les restrictions et bonnes pratiques suivantes s'appliquent:

Veillez à continuer à accepter tous les liens de l'Assistant. Si vous distribuez un lien Assistant qui ne fonctionne plus, votre projet Actions peut être signalé comme étant non opérationnel et supprimé.
La publication d'un lien vous permet de déclencher l'événement à partir de sources non approuvées. Pour toute action associée, vous devez explicitement demander à l'utilisateur avant de prendre une "action réelle". Par exemple, une action qui éteint un appareil pour la maison connectée doit demander à l'utilisateur de dire "Voulez-vous vraiment désactiver $applianceName ?".

Dans ce contexte, une "action réelle" est une action qui affecte les services, données, appareils, réseaux, ordinateurs ou API de l'utilisateur. Par exemple, pour envoyer un e-mail, effectuer une transaction, modifier l'état d'un appareil pour la maison connectée, créer un abonnement ou mettre à jour un contenu.