Listas de verificação de pré-lançamento (Dialogflow)

Antes de enviar suas ações para aprovação, consulte estas listas de verificação de pré-lançamento para conhecer as práticas recomendadas. Essas listas de verificação melhoram as chances de aprovação do projeto porque ajudam a detectar muitos dos problemas encontrados durante o processo de aprovação.

Diretório do Assistente

A lista de verificação a seguir destaca as etapas que você pode seguir para melhorar a experiência do usuário usando recursos do diretório do Google Assistente.

Diretório do Google Assistente
Escreva boas descrições

Verifique se as descrições do diretório do Google Assistente promovem a utilidade, os benefícios e os melhores recursos das suas ações com texto e imagens.

Se o Google Assistente recomendar suas ações a um usuário e ele pedir mais detalhes, o Assistente lerá a descrição das suas ações para o usuário. Garanta que sua descrição soe aceitável nesse contexto para criar uma boa primeira impressão.
Usar o link da Web do diretório do Assistente

Promova suas ações usando o link da Web do diretório. Você pode disponibilizar esse link no seu site e em outros materiais de marketing para direcionar os usuários à página do diretório do Actions.
Usar links do Assistente

Promova suas ações criando links do Assistente e distribuindo-os aos usuários. Os usuários que clicarem no link em dispositivos compatíveis serão levados diretamente a uma conversa com suas ações.

Invocação e descoberta

A lista de verificação a seguir contém recomendações para facilitar a invocação e a descoberta das ações pelos usuários.

Nome de exibição
Evitar palavras com várias pronúncias

Os usuários e o Google Assistente precisam pronunciar o nome de exibição de maneira fácil e consistente. Por exemplo, evite usar a palavra "Envelope" no nome de exibição, já que os usuários e o Google Assistente não saberão se querem dizer "en-vel-ope" ou "ahn-vel-ope". Outros exemplos incluem "lágrima", "arco" e "baixo".
Verificar se o Google reconhece seu nome de exibição
  • Teste o nome de exibição no Console do Actions, nas configurações da guia Desenvolver Invocação. Verifique se a saída de texto corresponde ao que está listado para o nome de exibição.
  • Teste suas ações em alto-falantes ativados por voz. Visualize seu nome de exibição e tente invocá-los para garantir que funcionem corretamente neste tipo de dispositivo.
  • Faça testes com pessoas de diferentes gêneros e sotaques. Você precisa garantir que seu nome de exibição seja reconhecido, independentemente de quem o diga.
    • .
  • Se os usuários não conseguirem pronunciar o nome de exibição de maneira consistente, use os controles Nome de exibição do console do Actions para fornecer uma pronúncia.
Escolha um nome fácil, mas exclusivo

Os usuários precisam poder invocar suas ações sem esforço. Se a pessoa tiver dificuldade para dizer o nome ou não conseguir se lembrar dele com facilidade, a probabilidade de continuarem usando suas ações será muito menor.
Obedecer às nossas políticas de nomenclatura

Consulte as políticas de nomenclatura para mais informações sobre diretrizes e restrições de nomes de exibição.

Se você precisar de um nome de exibição para sua empresa que não seja bem reconhecido pelo Google Assistente ou viole uma das nossas políticas, entre em contato com o suporte para solicitar uma exceção.
Frases de invocação
Projetar para os casos de uso das suas ações

Crie os links diretos do seu projeto com base nas suas tarefas específicas e casos de uso reais. Evite frases que sejam muito genéricas e não descrevam especificamente o propósito das suas Ações.
Especificar pares claros de verbo-objeto

Crie links diretos que consistem em um par de verbos e objetos, como "contar uma história" ou "começar a meditar". Essas frases são mais fáceis para os usuários lembrarem e se alinharem bem com a maioria das consultas dos usuários.
Usar entidades com sinônimos relevantes

Os tipos são ferramentas úteis para frases de invocação, porque podem corresponder a várias entradas do usuário em uma única frase. Verifique se todos os tipos adicionados às frases de invocação incluem apenas sinônimos relevantes para as frases e o caso de uso das suas Ações.
oferecer um amplo conjunto de amostras de invocações de alta qualidade;

Garantir que as ações possam ser invocadas, independentemente da escolha de palavras do usuário. Tente fornecer pelo menos 10 frases de invocação diferentes para cada ação. É possível editar essa configuração no Console do Actions em Desenvolver > Informações do diretório > Invocações de amostra.
Confira exemplos de frases de invocação boas e ruins

As frases de invocação são essenciais para que suas ações sejam descobertas naturalmente pela invocação implícita. Por isso, confira se elas foram bem projetadas. Para mais informações, revise nossas recomendações para escrever frases de invocação úteis.

Interface do usuário

A lista de verificação a seguir destaca coisas comuns que você pode fazer para garantir que suas respostas apareçam de maneira adequada na plataforma em que os usuários veem suas ações.

Cards e opções
Usar cards e opções

Cards e opções permitem mostrar informações em um formato mais avançado e personalizável.

  • Card básico: se precisar apresentar muito texto ao usuário, use um card básico. Um card pode exibir até 15 linhas de texto e incluir um link para um site com mais leitura. Ao contrário dos balões de chat, o card aceita formatação de texto. Também é possível adicionar uma imagem e uma lista ou carrossel para exibir opções.
  • Lista:se você estiver pedindo para o usuário escolher uma opção de uma lista, use uma lista em vez de escrever a lista em um balão de chat.
  • Carrossel:se você quiser que o usuário escolha uma opção de uma lista com foco em imagens maiores, use um carrossel, que tem um limite de oito itens.
Ícones de sugestão
Usar ícones de sugestão na maioria das rodadas

O uso de ícones de sugestão pode aumentar significativamente a usabilidade das suas ações em dispositivos com telas. Ao implementá-las, os usuários podem tocar rapidamente na tela para responder, além de usar voz ou o teclado. Por exemplo, é possível usar ícones de sugestão que digam Yes e No para perguntas de sim ou não.
Usar ícones quando houver poucas opções

Ao oferecer ao usuário um pequeno número de opções (oito ou menos), você pode adicionar uma sugestão para cada opção. Apresente-as na mesma ordem da sua resposta e use a mesma terminologia.
Usar ícones quando houver muitas opções

Se você fizer uma pergunta com uma ampla variedade de respostas possíveis, apresente algumas das respostas mais comuns.
Usar ícones ao retornar respostas de mídia

Inclua ícones de sugestão com uma resposta de mídia para ajudar os usuários que querem iniciar a conversa.
Balões de bate-papo
Usar letras maiúsculas e minúsculas e pontuação corretas

Verifique se as letras maiúsculas e a pontuação estão corretas nas respostas.
Corrigir a ortografia fonética

Se você soletrar algo fonéticamente usando SSML na sua resposta para ajudar com a pronúncia, esse erro fonético aparecerá no balão do chat. Use um texto de exibição diferente para aplicar a ortografia correta em balões de chat em dispositivos com telas.
Evite truncamentos

Os balões de chat são limitados a 640 caracteres e são truncados após esse limite. No entanto, recomendamos cerca de 300 como uma diretriz geral de design. Se você tiver mais do que isso, poderá:

  • Use um segundo balão de chat:são permitidos até dois balões de chat por turno. Portanto, encontre um ponto de pausa natural e crie um segundo balão de chat.
  • Não mostrar tudo:se você tiver uma resposta falada extensa, mostre apenas um subconjunto do conteúdo na parte do texto da resposta, como uma introdução.
Áudio gravado
Remover <audio> texto dos balões do chat

Se você tiver texto dentro da tag <audio> SSML, ele vai aparecer no balão de chat correspondente. Por exemplo, se a SSML for:

<speak>
  Here's that song.
  <audio src="...">song audio</audio>
</speak>

O texto do balão do chat aparece como "Aqui está essa música. Áudio da música".

Em vez disso, adicione um elemento <desc> dentro do elemento <audio>. Qualquer texto dentro de <desc> será exibido, e qualquer texto fora de <audio> será usado como texto alternativo se o arquivo de origem de áudio não puder ser carregado. Exemplo:

<speak>
  Here's that song.
  <audio src="bad_url"><desc></desc>song audio</audio>
</speak>

Isso resulta na saída de áudio: "Aqui está essa música. Áudio da música" e o texto do balão do chat: Aqui está essa música.

Como alternativa, você pode simplesmente remover o texto da tag <audio> ou usar a tag SSML <sub>.
Eliminar os balões de chat vazios

Certifique-se de que cada rodada de diálogo tenha pelo menos um balão de bate-papo. Se as ações tiverem caixas de diálogo compostas apenas por respostas faladas, o texto do balão do chat vai estar ausente, e a resposta vai falhar. Nesses casos, adicione um texto correspondente à sua resposta.