# Deprecation best practices This guide provides user messaging and migration paths for Conversational Actions, which are being deprecated on June 13, 2023. It covers the following areas: - **Deprecation phases**: How Actions function today, and after deprecation. - **Recommended messaging**: Suggested notifications to add to your Actions. - **Potential migration pathways**: Options for retaining users post sunset. > [!NOTE] > **Note:** This is general guidance only. Depending on Conversational Action type and locale there may be specific legal requirements. Please confirm your own legal requirements. #### Proactive blog posts (optional) Every Action, agency and business is different. In addition to updating your Actions with the messaging recommended in this guide, consider posting a blog post that proactively answering these common user concerns: - What is happening? - When will my experience change? - How may I continue receiving similar functionality? We recommend including migration path options with any deprecation announcements. Your post can be shared via email, newsletter, and social media. ## Deprecation phases The following table describes how Conversational Actions behave today, how they will change after the sunset date, and recommended updates you can make to inform your users. | | **Before deprecation date (June 13, 2023)** | **After deprecation** | |---|---|---| | **Action behavior** | Existing Action experience | Action invocation disabled | | **Recommended developer updates** | Add sunset notification to Actions ([recommendations](https://developers.google.com/assistant/ca-sunset/best-practices#notify_user_phase)) | N/A | | **Google's UX updates** | On invocation, Google may provide a Text-To-Speech (TTS) notice that the Action will no longer be available after the sunset date. | On invocation, Google provides a TTS informing the user that this action is no longer available. | If you decide to not proactively disable your Action before the deprecation date, users who invoke it will receive a Google-provided TTS notification. The exact wording of this notification is still being defined, but the final wording will not contain migration information to your users. > [!NOTE] > **Note:** If your Action provides [transactions](https://developers.google.com/assistant/transactions), consider additional messaging regarding transaction items like subscriptions, reservations, refunds, account debits, and more. ## Recommended messaging The best way to inform users of the upcoming sunset is to notify them whenever they invoke your action. You can also use this opportunity to educate them of [migration paths](https://developers.google.com/assistant/ca-sunset/best-practices#migration_pathways) to similar functionality. - **Purpose of messaging:** To notify users of the upcoming change, and inform them on available migration options. - **Messaging timeframe:** Start notifying users at least 30 days before deprecation (May 13, 2022 - Jun 13, 2022). ### Handle sunset queries To specifically answer deprecation questions from your users, create a new [Global custom intent](https://developers.google.com/assistant/conversational/intents#user_intents) that uses this suggested verbiage: - "We are turning off `Action Name` on `date`. For details, check out `short link` \| `migration path message`." > [!NOTE] > **Note:** Add a [Basic Card](https://developers.google.com/assistant/conversational/prompts-rich#basic_card) to the intent if you'd like to include a link to more details. See the Basic Card [code sample](https://developers.google.com/assistant/ca-sunset/best-practices#deprecation_card_sample). Links to the web are not supported on smart displays. ### Interactive Canvas ![Smart display showing a notification banner.](https://developers.google.com/static/assistant/ca-sunset/images/conversational-actions-deprecation-banner.png) If your Action uses [Interactive Canvas](https://developers.google.com/assistant/interactivecanvas), add a notification banner to the canvas loading page that uses the following sample wording: - "`Action Name` will be turning off on `date`, for details go to `shortlink url`." - "`Action Name` will be shutting off on `date`, `migration path message`."
### Optional communications There are additional ways you can update your existing actions to notify users of the upcoming change. Consider suffixing deprecation notices to your existing Action messages: - "`existing message`. Also, just reminding you that `Action Name` will be (turning off \| shutting off) on `date`." - "`existing message`. Also, just letting you know that `Action Name` will be (turning off \| shutting off) on `date`, `migration path`." You can also add notices to any special features that your Action might implement: - **Deep Link invocations** : Display an informational Basic Card ([sample](https://developers.google.com/assistant/ca-sunset/best-practices#deprecation_card_sample)). - **`Last prompt` messages** : You can add a `last prompt` message ([sample](https://developers.google.com/assistant/ca-sunset/best-practices#simple_prompt_code_sample)) to any of these prompt types: - Built-in intents (BII). Applicable on the Play Game, Storytelling, and Education BIIs. - Routine suggestions. - Welcome prompts. - **Exit prompts** : You can also add a special `last prompt` message ([sample](https://developers.google.com/assistant/ca-sunset/best-practices#simple_prompt_cancel_code_sample)) to Exit prompts (`actions.intent.CANCEL`). - **Push notifications**: Add the following suggested wording to any push notifications built using Action Builder, or Dialogflow: - "Reminder, `Action Name` will be shutting down on `date`, for details go to `shortlink url`." - "Reminder, `Action Name` will be turning off on `date`, `migration path message`. ## Potential migration pathways While there may not be a analogous migration path from your Conversational Action, consider the following options based on your user needs and available developer resources. #### Media content [Media Actions](https://developers.google.com/actions/media) enable users to discover your content on the Google Assistant and initiate playback of the content directly on your app. You can help users transition to media actions using this example messaging: - "You can always find us by saying, Hey Google, play `Media Brand Name`." - "You can always find us by saying, Hey Google, listen to \`song\` on `Media Brand Name`." Media Actions differ from Conversational Actions: - With Media Actions, the user does not "interact" directly with 3P, but via Assistant to 3P. - Media Actions are not conversational, supporting only "single shot" queries.
#### Android apps Assistant [App Actions](https://developer.android.com/guide/app-actions/overview) are an Android feature enabling users to launch and control Android apps with their voice, using Assistant. You can educate users about your app actions with this example messaging: - "You can always find us by saying "Hey Google, open `App Name`." - "You can open our Android app by saying "Hey Google, `BII` on `App Name`." - "You can install our Android app by saying "Hey Google, open `App Name`." App Actions work with a few differences from Conversational Actions: - App Action BIIs offer limited language and locale support. - An Android App is required to launch app actions. - Smart displays do not support App Actions. - App Actions are not conversational, supporting only "single shot" queries.
#### Hardware Google [Smart Home](https://developers.home.google.com/) allows developers to voice-enable devices using Assistant. You can educate users about your Smart Home Actions with this example messaging: - "You can always talk to us by using the `device name`, available at `store`" - "You can talk to us through `device name` in the Google Home app" Smart Home has the following differences from Conversational Actions: - Smart Home can only be added to compatible devices. - Smart Home is not conversational, supporting only "single shot" queries.
#### Chat agents For back and forth dialog with users via chatbots, the following products are available: - [Dialogflow CX](https://cloud.google.com/dialogflow/cx/docs) provides an advanced agent type for large and complex agents. It offers integrations with Dialogflow CX Phone Gateway, Dialogflow Messenger, Messenger from Facebook, LINE and more. See the [full integration list](https://cloud.google.com/dialogflow/cx/docs/concept/integration). - [Dialogflow EX](https://cloud.google.com/dialogflow/es/docs) provides a standard agent type that is suitable for smaller, simpler agents. It offers integrations to Slack, Telegram, LINE, Messenger from Facebook, Workplace from Meta, and more. See the [full integration list](https://cloud.google.com/dialogflow/es/docs/integrations). You can educate users about your chat agents with the following example messaging: - "For future support, call `support number`." - "For future support, visit our website at `short link url`." - "For future feedback, chat with us on the `Company Name` Slack channel."
Chat agent services carry a few differences from Conversational Actions: - Agents are not supported on Smart Displays. - Agents can not integrate with Assistant.
#### Customer Care Resolve your customers' needs quicker with chatbots, voice bots, and telephony helpdesks, all of which are built into [Contact Center AI](https://cloud.google.com/solutions/contact-center) offerings like [Agent Assist](https://cloud.google.com/agent-assist), and [CCAI Insights](https://cloud.google.com/solutions/ccai-insights). You can educate users on customer care options using this example messaging: - For future support, call `support number`." - "For future support, visit our website at `short link url`." - For future feedback, chat with us on the \`Company name\` Slack channel." Customer care options offer a few differences from Conversational Actions: - They are not supported on Smart Displays. - They can not integrate with Assistant.
#### Websites You may direct users to functionality your website may offer. You can educate users about your web options using this example messaging: - "For future support, visit our website at `short link url`." Websites carry the following differences from Conversational Actions: - Smart displays do not support websites. - Websites cannot integrate directly with Assistant
> [!NOTE] > **Note:** You can automatically generate Actions from your web content markup using [Actions from web > content](https://developers.google.com/assistant/content/overview). ## Code samples Ue these code samples to construct sunset-related responses for your Conversational Actions. #### Basic Card example ### YAML ```yaml candidates: - first_simple: variants: - speech: >- We are turning off on . For more details check out text: >- We are turning off on . For more details check out content: card: title: Turning Off subtitle: text: >- `We are turning off on . For more details check out .` button: name: Learn more open: url: ``` ### JSON ``` { "candidates": [ { "first_simple": { "variants": [ { "speech": "We are turning off on . For details, check out .", "text": "We are turning off on . For details, check out ." } ] }, "content": { "card": { "title": "Turning Off ", "subtitle": "", "text": "`We are turning off on . For details, check out .`", "button": { "name": "Learn more", "open": { "url": "" } } } } } ] } ``` ### Node.js ```javascript app.handle('Card', conv => { conv.add('We are turning off on . For details, check out .'); conv.add(new Card({ "title": "Turning Off ", "subtitle": "", "text": "Card Content", "button": new Link({ name: 'Learn more', open: { url: '', }, }) })); }); ``` ### JSON ``` { "responseJson": { "session": { "id": "session_id", "params": {} }, "prompt": { "override": false, "content": { "card": { "title": "Turning Off ", "subtitle": "", "text": "We are turning off on . For, details check out .", "button": { "name": "Learn more", "open": { "url": "" } } } }, "firstSimple": { "speech": "We are turning off on . For details, check out .", "text": "We are turning off on . For details, check out ." } } } } ``` #### Last prompt example ### YAML ```yaml candidates: - first_simple: variants: - speech: text: last_simple: variants: - speech: Also, just reminding you that will be turning off on text: Also, just reminding you that will be turning off on ``` ### JSON ``` { "candidates": [ { "first_simple": { "variants": [ { "speech": "", "text": "" } ] }, "last_simple": { "variants": [ { "speech": "Also, just reminding you that will be turning off on ", "text": "Also, just reminding you that will be turning off on " } ] } } ] } ``` ### Node.js ```javascript app.handle('Simple', conv => { conv.add(new Simple({ speech: '', text: '' })); conv.add(new Simple({ speech: 'Also, just reminding you that will be turning off on ', text: 'Also, just reminding you that will be turning off on ' })); }); ``` ### JSON ``` { "responseJson": { "session": { "id": "session_id", "params": {} }, "prompt": { "override": false, "firstSimple": { "speech": "", "text": "" }, "lastSimple": { "speech": "Also, just reminding you that will be turning off on ", "text": "Also, just reminding you that will be turning off on " } } } } ``` #### Last prompt (Exit/Cancel) example ### YAML ```yaml candidates: - first_simple: variants: - speech: text: last_simple: variants: - speech: Also, just reminding you that will be turning off on . Bye. text: Also, just reminding you that will be turning off on . Bye. ``` ### JSON ``` { "candidates": [ { "first_simple": { "variants": [ { "speech": "", "text": "" } ] }, "last_simple": { "variants": [ { "speech": "Also, just reminding you that will be turning off on . Bye.", "text": "Also, just reminding you that will be turning off on . Bye." } ] } } ] } ``` ### Node.js ```javascript app.handle('Simple', conv => { conv.add(new Simple({ speech: '', text: '' })); conv.add(new Simple({ speech: 'Also, just reminding you that will be turning off on . Bye.', text: 'Also, just reminding you that will be turning off on . Bye.' })); }); ``` ### JSON ``` { "responseJson": { "session": { "id": "session_id", "params": {} }, "prompt": { "override": false, "firstSimple": { "speech": "", "text": "" }, "lastSimple": { "speech": "Also, just reminding you that will be turning off on . Bye.", "text": "Also, just reminding you that will be turning off on . Bye." } } } } ``` *** ** * ** ***