A API Transactions vai ser descontinuada em 3 de maio de 2023, antes da desativação das ações de conversa em 13 de junho de 2023. Para mais informações, consulte
Desativação do recurso Ações de conversa.
Diretrizes de design
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Crie uma conversa para orientar os usuários nos fluxos transacionais. Fornecemos exemplos de referência que podem ser usados como um guia
ao criar suas próprias ações transacionais.
Exemplos
Dicas de design
Os diálogos precisam
parecer naturais e conversacionais,
assim como uma pessoa real falaria.
O texto falado pelo TTS/voz não precisa corresponder exatamente ao texto
mostrado nos balões de chat. Funciona bem se os balões de chat forem um subconjunto
da caixa de diálogo falada.
Cumprimente seus visitantes e incentive o engajamento. Pergunte o que eles precisam e ofereça
alguns ícones de sugestão para começar.
Antes de convidar o usuário para adicionar itens ao carrinho, faça uma verificação de back-end
adicionando o preenchimento de slot e usando o tipo de slot actions.type.TransactionRequirementsCheckResult
para confirmar se o usuário configurou os pagamentos para o Google Assistente.
Prepare-se para responder aos mesmos problemas por voz, assim como em outras experiências de dispositivos móveis
ou da Web. Por exemplo, ofereça um item semelhante quando você ficar sem um
determinado tamanho ou cor ou convide os usuários a se inscreverem para receber uma notificação quando o
item voltar ao estoque.
O resumo do pedido é criado com os dados transmitidos pela API.
O rótulo "Pagar com o Google" ajuda os usuários a entender que o Google facilitou o pagamento.
Ao solicitar informações dos seus usuários, como o endereço deles, primeiro informe
por que você está fazendo a solicitação e como isso os beneficiará.
O Google apresentará o método de autorização de compra (não necessária autenticação, senha ou impressão digital) com base nas configurações do usuário. Às vezes,
nossa avaliação de risco dará início a uma etapa extra de autenticação, como a confirmação
do CVV de um cartão.
Depois que o pagamento for concluído, envie um comprovante e uma confirmação do pedido. É importante que os usuários entendam que você é o comerciante responsável pelo processamento e vão entrar em contato com todos os detalhes sobre o pedido, não com o Google.
Por padrão, as transações podem ser realizadas em uma plataforma com
tela (como um smartphone Android) ou em uma plataforma somente voz (como um Google Home).
Para oferecer o melhor suporte a transações somente de voz, crie
uma boa experiência de conversa
que oriente os usuários por toda a experiência de transação.
Observe que algumas intents de transação podem exigir uma tela. A maioria deles (por exemplo, adicionar um novo endereço de entrega, corrigir problemas de pagamento, vinculação de contas) será entregue ao smartphone automaticamente. Se houver alguma adição
à conversa que é melhor exibida em uma tela
(por exemplo, apresentação de respostas avançadas para criação de cards, exibição de Termos de Serviço
ou Política de Privacidade do comerciante), verifique se a plataforma atual é compatível
com os capabilities
RICH_RESPONSE ou WEB_LINK
e transfira para uma nova plataforma se não for.
Caso prefira não oferecer suporte a transações somente de voz com a
ação, configure o projeto do Actions para exigir uma tela.
Para isso, acesse Implantar > Recursos de superfície no
Console do Actions e defina
Você precisa de uma saída de tela para Sim.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eDesign conversational transactional flows, similar to natural human interactions, guiding users through the process.\u003c/p\u003e\n"],["\u003cp\u003eUtilize provided examples and design tips to create effective and user-friendly transactional Actions.\u003c/p\u003e\n"],["\u003cp\u003eEnsure clear communication, address potential issues proactively, and inform users about Google's role in payment processing.\u003c/p\u003e\n"],["\u003cp\u003eOptimize for both screen and voice-only interactions by tailoring the conversation and utilizing surface capabilities effectively.\u003c/p\u003e\n"],["\u003cp\u003eCustomize the user experience by enabling or disabling screen requirements based on your Action's functionalities.\u003c/p\u003e\n"]]],[],null,["# Design guidelines\n\nDesign a conversation to guide users through your transactional\nflows. We've provided reference examples that you can use as a guide\nwhen designing your own transactional Actions.\n\nExamples\n--------\n\n[](https://docs.google.com/presentation/d/1Zw-Cg4ODJWpEViJJT_LugxvFv1VeOB7Hw54wNQemrfg) [Shoe store Example](https://docs.google.com/presentation/d/1Zw-Cg4ODJWpEViJJT_LugxvFv1VeOB7Hw54wNQemrfg) \n[](https://docs.google.com/presentation/d/1RBVzklC8n7nPU98lRt1CkzDSFcBlaQf5PWVtlr58OQQ) [Ticketing example](https://docs.google.com/presentation/d/1RBVzklC8n7nPU98lRt1CkzDSFcBlaQf5PWVtlr58OQQ) \n[](https://docs.google.com/presentation/d/1icd64B_mJvba6lmhlfmUy35sejy5n-LsYYkvPXzUXgA) [Flower Shop Example](https://docs.google.com/presentation/d/1icd64B_mJvba6lmhlfmUy35sejy5n-LsYYkvPXzUXgA)\n\nDesign tips\n-----------\n\n- Make sure the dialogs\n [sound natural and conversational](/assistant/conversational/df-asdk/design)\n --- the way a real person would talk.\n\n- The text spoken by your TTS/voice does not have to exactly match the text\n shown in your chat bubbles. It works well if the chat bubbles are a subset\n of the spoken dialog.\n\n- Greet your visitors and get them engaged. Ask what they need and offer a\n few suggestion chips to get them started.\n\n- Before inviting the user to add items to the cart, do a backend check by\n adding slot filling and using the `actions.type.TransactionRequirementsCheckResult`\n slot type to confirm the user has payments set up for their Google Assistant.\n\n- Be prepared to respond to the same issues with voice as with other mobile\n or web experiences. For example, offer a similar item when you're out of a\n certain size or color, or invite users to sign up to be notified when the\n item is back in stock.\n\n- Note that the order summary is built with the data you pass via the API.\n The \"Pay with Google\" label helps users understand that Google facilitated\n the payment.\n\n- When requesting info from your users, like their address info, first let\n them know why you are making the request and how it will benefit them.\n\n- Google will present the purchase authorization method (either no auth\n required, password, or fingerprint) based on the user's settings. Sometimes\n our risk assessment will kick off an additional auth step like confirming\n CVV for a card.\n\n- After the payment is complete, be sure to send a receipt and an order\n confirmation. It's important that users understand that you are the merchant\n of record, and will follow up with all details about the order, not Google.\n\n- By default transactions can be performed on either a surface with a\n screen (such as an Android phone) or a voice-only surface (such as a Google Home).\n\n - To best support voice-only transactions, take extra care to design\n a [good conversational experience](/assistant/conversational/df-asdk/design)\n that walks users through the full transaction experience.\n\n - Note that some transactions intents may require a screen. Most of these\n (e.g. adding a new delivery address, fixing payment issues, account linking)\n will be handed off to the phone automatically. If there are any additions\n to the conversation that are best displayed on a screen\n (e.g. presenting rich responses for card building, displaying a merchant\n ToS or privacy policy), you should check if the current surface supports\n the `RICH_RESPONSE` or `WEB_LINK`\n [capabilities](/assistant/conversational/reference/rest/v1/TopLevel/fulfill#capability),\n and transfer to a new surface if not.\n\n - If you would rather not support voice-only transactions with your\n Action, you can set your Actions project to require a screen by\n navigating to **Deploy \\\u003e Surface capabilities** in the\n [Actions console](https://console.actions.google.com) and setting\n **Do your Actions require a screen output** to **Yes**."]]
