Best practice per il ritiro

Questa guida fornisce i messaggi per gli utenti e i percorsi di migrazione per le azioni conversazionali, che verranno ritirate il 13 giugno 2023. Copre le seguenti aree:

  • Fasi di ritiro: modalità di funzionamento delle azioni oggi e dopo il ritiro.
  • Messaggi consigliati: notifiche suggerite da aggiungere alle tue Azioni.
  • Potenziali percorsi di migrazione: opzioni per trattenere gli utenti dopo il ritiro.

Post del blog proattivi (facoltativo)

Ogni Azione, agenzia e attività è diversa. Oltre ad aggiornare le tue Azioni con i messaggi consigliati in questa guida, valuta la possibilità di pubblicare un post del blog che risponda in modo proattivo ai seguenti dubbi comuni degli utenti:

  • Che cosa sta succedendo?
  • Quando cambierà la mia esperienza?
  • In che modo posso continuare a ricevere funzionalità simili?

Ti consigliamo di includere le opzioni relative al percorso di migrazione in tutti gli annunci sul ritiro. Il tuo post può essere condiviso via email, newsletter e social media.

Fasi di ritiro

La tabella seguente descrive il comportamento attuale delle azioni conversazionali, come cambieranno dopo la data di ritiro e gli aggiornamenti consigliati che puoi apportare per informare gli utenti.

Prima della data di ritiro (13 giugno 2023) Dopo il ritiro
Comportamento dell'azione Esperienza esistente di Action Chiamata dell'azione disabilitata
Aggiornamenti consigliati per gli sviluppatori Aggiungi la notifica di ritiro alle azioni (consigli) N/A
Aggiornamenti UX di Google Al momento della chiamata, Google potrebbe fornire un avviso di sintesi vocale (TTS) che indica che l'azione non sarà più disponibile dopo la data di ritiro. Al momento della chiamata, Google fornisce un TTS per informare l'utente che questa azione non è più disponibile.

Se decidi di non disattivare proattivamente l'Azione prima della data di ritiro, gli utenti che la richiamano riceveranno una notifica di sintesi vocale fornita da Google. Il testo esatto di questa notifica è ancora in fase di definizione, ma il testo finale non conterrà informazioni sulla migrazione per i tuoi utenti.

Messaggi consigliati

Il modo migliore per informare gli utenti del ritiro imminente è avvisarli ogni volta che richiamano la tua azione. Puoi anche sfruttare questa opportunità per informare gli utenti in merito ai percorsi di migrazione a funzionalità simili.

  • Scopo dei messaggi: informare gli utenti del cambiamento imminente e informarli sulle opzioni di migrazione disponibili.

  • Periodo di messaggistica: inizia a inviare notifiche agli utenti almeno 30 giorni prima del ritiro (dal 13 maggio 2022 al 13 giugno 2022).

Gestire le query di ritiro

Per rispondere in modo specifico alle domande relative al ritiro degli utenti, crea un nuovo intent personalizzato globale che utilizzi questa frase suggerita:

  • "Stiamo disattivando Action Name il giorno date. Per maggiori dettagli, consulta short link | migration path message."

Canvas interattiva

Smart display che mostra un banner di notifica.

Se l'Azione utilizza Canvas interattiva, aggiungi un banner di notifica alla pagina di caricamento canvas che utilizza i seguenti testi di esempio:

  • "Action Name si disattiverà il giorno date. Per i dettagli vai a shortlink url."
  • "L'app Action Name verrà disattivata il giorno date migration path message."

Comunicazioni facoltative

Puoi aggiornare le azioni esistenti in altri modi per informare gli utenti del cambiamento imminente. Puoi aggiungere come suffisso gli avvisi di ritiro ai tuoi messaggi di azione esistenti:

  • "existing message. Inoltre, ti ricordo che Action Name (si spegnerà | si spegnerà) il giorno date."
  • "existing message. Inoltre, ti comunichiamo che Action Name si spegnerà (si spegnerà | si spegnerà) il giorno date, migration path."

Puoi anche aggiungere avvisi a eventuali funzionalità speciali che l'Azione potrebbe implementare:

  • Chiamate di link diretti: mostra una scheda di base informativa (esempio).

  • Last prompt messaggi: puoi aggiungere un messaggio last prompt (esempio) a uno qualsiasi di questi tipi di prompt:

    • Intent integrati (BII). Applicabile nelle BII di Google Play, Storytelling ed Education.
    • Suggerimenti di routine.
    • Prompt di benvenuto.

  • Prompt di uscita: puoi anche aggiungere un messaggio last prompt speciale (esempio) alle richieste di uscita (actions.intent.CANCEL).

  • Notifiche push: aggiungi le seguenti parole suggerite a tutte le notifiche push create con Action Builder o Dialogflow:

    • "Promemoria: Action Name verrà disattivato il giorno date. Per informazioni dettagliate, visita la pagina shortlink url."
    • "Promemoria: Action Name disattiverà il giorno date migration path message.

Potenziali percorsi di migrazione

Anche se potrebbe non esistere un percorso di migrazione analogo dall'azione conversazionale, prendi in considerazione le seguenti opzioni in base alle esigenze dei tuoi utenti e alle risorse per sviluppatori disponibili.

Contenuti multimediali

Le azioni multimediali consentono agli utenti di scoprire i tuoi contenuti nell'Assistente Google e di avviare la riproduzione dei contenuti direttamente nella tua app. Puoi aiutare gli utenti a passare alle azioni multimediali utilizzando questo messaggio di esempio:

  • "Puoi sempre trovarci dicendo Hey Google, fammi ascoltare Media Brand Name."
  • "Puoi sempre trovarci dicendo Hey Google, ascolta 'brano' su Media Brand Name."

Le azioni multimediali sono diverse dalle azioni conversazionali:

  • Con le azioni multimediali, l'utente non "interagisce" direttamente con la terza parte, ma tramite l'assistente.
  • Le azioni multimediali non sono conversazionali e supportano solo le query "singole".

App Android

Le azioni app dell'assistente sono una funzionalità Android che consente agli utenti di avviare e controllare le app Android con i comandi vocali, tramite l'assistente. Puoi informare gli utenti sulle azioni della tua app con questi messaggi di esempio:

  • "Puoi sempre trovarci dicendo "Hey Google, apri App Name".
  • "Puoi aprire la nostra app Android dicendo "Hey Google, BII su App Name".
  • "Puoi installare la nostra app Android dicendo "Hey Google, apri App Name".

La funzionalità Azioni app presenta alcune differenze rispetto ad Azioni conversazionali:

  • Lo strumento App Action BII offre supporto limitato per lingua e impostazioni internazionali.
  • Per avviare le azioni dell'app è necessaria un'app per Android.
  • Gli smart display non supportano Azioni app.
  • Le azioni app non sono conversazionali e supportano solo le query "singole".

Hardware

La Smart Home di Google consente agli sviluppatori di attivare i dispositivi vocali tramite l'assistente. Puoi informare gli utenti sulle azioni per la smart home con questi messaggi di esempio:

  • "Puoi sempre parlare con noi utilizzando il device name, disponibile all'indirizzo store"
  • "Puoi parlare con noi tramite device name nell'app Google Home"

La smart home presenta le seguenti differenze rispetto alla funzionalità Azioni conversazionali:

  • La smart home può essere aggiunta solo a dispositivi compatibili.
  • La smart home non è conversazionale e supporta solo le query "singole".

Agenti via chat

Per l'interazione con gli utenti tramite chatbot, sono disponibili i seguenti prodotti:

  • Dialogflow CX fornisce un tipo di agente avanzato per agenti complessi e di grandi dimensioni. Offre integrazioni con il gateway telefonico Dialogflow CX, Dialogflow Messenger, Messenger di Facebook, LINE e altri ancora. Consulta l'elenco delle integrazioni complete.
  • Dialogflow EX fornisce un tipo di agente standard adatto ad agenti più piccoli e più semplici. Offre integrazioni con Slack, Telegram, LINE, Messenger di Facebook, Workplace di Meta e altro ancora. Consulta l'elenco delle integrazioni complete.

Puoi informare gli utenti sui tuoi agenti via chat con i seguenti messaggi di esempio:

  • "Per assistenza futura, chiama il numero support number."
  • "Per assistenza in futuro, visita il nostro sito web all'indirizzo short link url."
  • "Per ricevere feedback in futuro, chatta con noi sul canale Slack Company Name."

I servizi degli agenti via chat presentano alcune differenze rispetto ad Azioni conversazionali:

  • Gli agenti non sono supportati sugli smart display.
  • Gli agenti non possono integrarsi con l'assistente.

Assistenza clienti

Soddisfa le esigenze dei tuoi clienti più rapidamente con chatbot, bot vocali e help desk di telefonia, tutti integrati nelle offerte di Contact Center AI come Agent Assist e CCAI Insights. Puoi informare gli utenti sulle opzioni di assistenza clienti utilizzando questo messaggio di esempio:

  • Per assistenza futura, chiama il numero support number."
  • "Per assistenza in futuro, visita il nostro sito web all'indirizzo short link url."
  • Per eventuali feedback futuri, chatta con noi sul canale Slack "Company name" (Nome azienda).

Le opzioni di assistenza clienti offrono alcune differenze rispetto ad Azioni conversazionali:

  • Non sono supportati sugli smart display.
  • Non possono integrarsi con l'assistente.

Siti web

Puoi indirizzare gli utenti alle funzionalità offerte dal tuo sito web. Puoi informare gli utenti sulle tue opzioni web utilizzando questo messaggio di esempio:

  • "Per assistenza futura, visita il nostro sito web all'indirizzo short link url."

I siti web presentano le seguenti differenze rispetto alle azioni conversazionali:

  • Gli smart display non supportano i siti web.
  • I siti web non possono integrarsi direttamente con l'assistente

Esempi di codice

Utilizza questi esempi di codice per creare risposte relative al ritiro per le tue Azioni conversazionali.

Esempio di scheda di base

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

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 ."
      }
    }
  }
}

Esempio di ultimo prompt

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

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 "
      }
    }
  }
}

Esempio di ultima richiesta (uscita/annullamento)

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

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."
      }
    }
  }
}