Link to your Actions

You can generate a URL that will link directly to the specific Action, on a per-Action basis. Users who click the Action link in a web or mobile browser will be directed to the Assistant on their device, where they'll interact directly with your corresponding Action.

Some examples of useful Action links include:

Linking users to voice-guided instructions from a how-to website.

Linking users to a customer support experience from a "get help" page.

Linking users to an Action with an opt-in for updates so they can opt-in to your future updates.

Note: Action links are different from Directory weblinks which send a user to your Directory page.

Under the Links section, enable Would you like to enable a URL for this Action.

Enter a Link title. This title should include a verb that is descriptive of what the Action will do. For example, if your Action will take the user down a transaction flow to buy tickets to a concert, a useful link title would be "purchase concert tickets".

Click Save.

You can copy the provided URL and reference it wherever you want to direct users to this specific Action.

Note: If you enable an Action link after your Action is deployed, you will need to re-deploy the Action for the link to take effect.

Action link parameters

Action links can optionally contain an intent and parameters in the URL. Google handles the parameters according to the type of intent specified in the URL.

Action link URLs with built-in intents

If the Action link contains a
built-in intent (the intent starts with actions.intent.*), Google will try to extract any built-in intent parameters in the URL and pass them on to your Action. Any parameters that Google does not understand as built-in intent parameters are stripped.

For conversational Actions, Google sends these parameters to your fulfillment as part of the AppRequest message.

The following example shows how you might specify an Action link URL that includes a built-in intent with a single intent parameter:

On an Assistant enabled device, click on the link created in the previous step.

Once you confirm the Action link functions as expected, you will need to re-deploy your Action to make the link available to your users.

Note: Action links are available through all deployment channels (alpha, beta, and production). For example, if your Action link is enabled in the alpha release of your Action, the link will be available to alpha testers.

Restrictions and best practices

Because your Action link URL can now be distributed and referenced outside of the directory or other Google services, please note that the following restrictions and best practices apply:

Make sure you continue to support all of your Action links. If you distribute an Action link that later breaks, your Actions project may be flagged as unhealthy and taken down.

Publishing a link means you support triggering from untrusted sources. For any linked Actions, you must explicitly confirm with the user before taking any "real-world action". For example, an Action that turns off a smart home appliance should prompt the user saying "Are you sure you want to turn off $applianceName?"

In this context, a "real world action" is any action affecting the user's services, data, devices, networks, computers, or APIs. For example, sending an email, performing a transaction, altering the status of a Smart Home appliance, creating a subscription, or updating a piece of content.