Les actions de conversation ont été abandonnées le 13 juin 2023. Pour en savoir plus, consultez Abandon de la fonctionnalité Conversation.

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

Lien vers vos actions (Dialogflow)

Vous pouvez générer une URL qui renvoie directement vers l'action spécifique, pour chaque action. Les utilisateurs qui cliquent sur le lien Assistant (anciennement "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 vers l'Assistant utiles:

Rediriger les utilisateurs vers des instructions vocales à partir d'un site Web de démonstration.
Rediriger les utilisateurs vers une expérience de service client depuis une page d'aide.
Rediriger les utilisateurs vers un intent de mise à jour afin 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 à Développer > Actions.
Cliquez sur l'action pour laquelle vous souhaitez générer un lien.
Dans la section Liens, activez l'option Voulez-vous activer une URL pour cette action.
Saisissez le titre du lien. Ce titre doit inclure un verbe décrivant ce que fera l'action. Par exemple, si votre action fait suivre un flux de transactions à l'utilisateur pour acheter des billets de concert, le titre du lien serait "acheter des places de concert".
Cliquez sur Enregistrer.

Vous pouvez copier l'URL fournie et y faire référence partout où vous souhaitez rediriger les utilisateurs vers cette action spécifique.

Paramètres des liens 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 vers l'Assistant

La syntaxe générale de l'URL d'un lien vers 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'actions.
`$value`	Valeur encodée au format URL du type déclaré pour `$param` dans le package d'actions.
`$utm_param`	Liste d'un ou de plusieurs types de paramètres UTM. Les valeurs valides incluent : `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` et `utm_content`.
`$utm_value`	Valeur de chaîne du paramètre UTM.

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

Si le lien de l'Assistant contient un intent intégré (qui commence par actions.intent.*), Google tente d'extraire tous les paramètres d'intent intégrés dans l'URL et les transmet à votre action. Tous les paramètres que Google ne comprend pas comme paramètres d'intent intégré 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 vers 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 des liens vers l'Assistant avec intents personnalisés

Pour les intents personnalisés, Google n'extrait que les paramètres définis par votre action dans l'intent et ignore tout autre paramètre.

L'exemple suivant montre comment spécifier une URL de lien vers 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 des liens vers l'Assistant sans intent

Si vous ne spécifiez pas d'intent dans le lien vers 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 vers 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 vers l'Assistant sans intent:

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

URL des liens de l'Assistant avec paramètres UTM

Les paramètres UTM sont des chaînes que Google envoie à votre action lorsque les utilisateurs cliquent sur un lien vers l'Assistant, que vous pouvez ensuite utiliser à des fins d'analyse.

Les paramètres UTM que Google envoie à votre action incluent les éléments suivants:

utm_source
utm_medium
utm_campaign
utm_term
utm_content

L'exemple suivant montre comment spécifier une URL de lien vers 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 liens vers 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 vers l'Assistant:

Activez le lien vers 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 du lien vers l'Assistant (dans un e-mail, un chat, un document, etc.).
Sur un appareil avec Assistant Google intégré, cliquez sur le lien créé à l'étape précédente.

Après avoir vérifié que le lien Assistant fonctionne comme prévu, vous devrez redéployer votre action pour que vos utilisateurs puissent y accéder.

Restrictions et bonnes pratiques

Étant donné que l'URL du lien vers 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:

Assurez-vous que vous continuez à accepter tous les liens vers l'Assistant. Si vous distribuez un lien vers l'Assistant qui ne fonctionne plus par la suite, votre projet Actions peut être signalé comme non opérationnel et supprimé.
En publiant un lien, vous acceptez le déclenchement à partir de sources non fiables. Pour toutes les actions associées, vous devez confirmer explicitement auprès de l'utilisateur avant d'effectuer toute "action dans le monde réel". Par exemple, une action qui éteint un appareil de la maison connectée doit afficher le message suivant : "Voulez-vous vraiment éteindre $applianceName ?"

Dans ce contexte, une "action réelle" désigne toute action affectant les services, données, appareils, réseaux, ordinateurs ou API de l'utilisateur. Par exemple, nous pouvons envoyer un e-mail, effectuer une transaction, modifier l'état d'un appareil électroménager connecté, créer un abonnement ou mettre à jour un contenu.