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.
Como criar conversas transacionais (Dialogflow)
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 soar natural e coloquial, da mesma forma que uma pessoa real falaria.
O texto falado pelo TTS/voz não precisa ser idêntico ao texto mostrado nos balões do chat. Funciona bem se os balões do 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 usando actions.intent.TRANSACTION_REQUIREMENTS_CHECK para confirmar se o usuário configurou os pagamentos para o Google Assistente.
Esteja preparado para responder aos mesmos problemas por voz, assim como em outras experiências na Web ou em dispositivos móveis. Por exemplo, ofereça um item semelhante quando você estiver esgotado de 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. A etiqueta "Pagar com o Google" ajuda os usuários a entender que o Google facilitou o pagamento.
Ao solicitar informações, como o endereço, primeiro explique por que você está fazendo a solicitação e como isso vai beneficiar os usuários.
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 inicia uma etapa de autenticação adicional, como a confirmação do CVV de um cartão.
Após a conclusão do pagamento, 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 superfície 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 conta) será entregue ao telefone automaticamente. Se houver alguma adição à conversa que seja mais bem exibida na tela (por exemplo, apresentar respostas avançadas para a criação de cards, mostrar os Termos de Serviço do comerciante ou a Política de Privacidade), verifique se a plataforma atual é compatível com os recursos SCREEN_OUTPUT ou WEB_BROWSER e, caso contrário, faça a transferência para outra plataforma.
Se você preferir não oferecer suporte a transações somente de voz com sua Ação, configure o projeto do Actions para exigir uma tela. Para isso, acesse Implantar > Recursos de superfície no Actions Console e defina Fazer suas ações exigem uma saída de tela como 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 flows for transactional Actions, guiding users through the process similar to a real-world conversation.\u003c/p\u003e\n"],["\u003cp\u003eRefer to provided examples like Shoe store, Ticketing, and Flower Shop to understand transactional Action design.\u003c/p\u003e\n"],["\u003cp\u003eFollow design tips to ensure natural dialog, clear communication, and a smooth user experience, including pre-purchase checks and handling potential issues.\u003c/p\u003e\n"],["\u003cp\u003eTransactions can occur on screen and voice-only surfaces; optimize for both by crafting a comprehensive conversational experience and leveraging surface capabilities effectively.\u003c/p\u003e\n"],["\u003cp\u003eRemember to inform users about data requests, purchase authorization, and merchant responsibility for post-purchase communication.\u003c/p\u003e\n"]]],[],null,["# Designing Transactional Conversations (Dialogflow)\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 [sound natural and conversational](/assistant/actions/design) --- the way a real person would talk.\n\n- The text spoken by your TTS/voice does not have to exactly match the text shown in your chat bubbles. It works well if the chat bubbles are a subset of the spoken dialog.\n\n- Greet your visitors and get them engaged. Ask what they need and offer a few suggestion chips to get them started.\n\n- Before inviting the user to add items to the cart, do a backend check using `actions.intent.TRANSACTION_REQUIREMENTS_CHECK` 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 or web experiences. For example, offer a similar item when you're out of a certain size or color, or invite users to sign up to be notified when the item is back in stock.\n\n- Note that the order summary is built with the data you pass via the API. The \"Pay with Google\" label helps users understand that Google facilitated the payment.\n\n- When requesting info from your users, like their address info, first let 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 required, password, or fingerprint) based on the user's settings. Sometimes our risk assessment will kick off an additional auth step like confirming CVV for a card.\n\n- After the payment is complete, be sure to send a receipt and an order confirmation. It's important that users understand that you are the merchant 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 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 a [good conversational experience](/assistant/actions/design) that walks users through the full transaction experience.\n\n - Note that some transactions intents may require a screen. Most of these (e.g. adding a new delivery address, fixing payment issues, account linking) will be handed off to the phone automatically. If there are any additions to the conversation that are best displayed on a screen (e.g. presenting rich responses for card building, displaying a merchant ToS or privacy policy), you should check if the current surface supports the `SCREEN_OUTPUT` or `WEB_BROWSER` capabilities, and [transfer to a new surface](/assistant/df-asdk/surface-capabilities#multi-surface_conversations) if not.\n\n - If you would rather not support voice-only transactions with your Action, you can set your Actions project to require a screen by navigating to **Deploy \\\u003e Surface capabilities** in the [Actions Console](https://console.actions.google.com) and setting **Do your Actions require a screen output** to **Yes**."]]
