La API de Transactions se dará de baja el 3 de mayo de 2023, antes de la baja de Conversational Actions el 13 de junio de 2023. Para obtener más información, consulta
Eliminación de acciones en conversaciones.
Lineamientos de diseño
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Diseña una conversación para guiar a los usuarios a través de tus flujos transaccionales. Proporcionamos ejemplos de referencia que puedes usar como guía cuando diseñes tus propias acciones transaccionales.
Ejemplos
Sugerencias de diseño
Asegúrate de que los diálogos suenen de forma natural y conversacional, es decir, la forma en que hablaría una persona real.
El texto que pronuncia el TTS o la voz no tiene que coincidir exactamente con el que se muestra en las burbujas de chat. Funciona bien si las burbujas de chat son un subconjunto del diálogo hablado.
Saluda a tus visitantes y logra su participación. Pregúntales qué necesitan y ofréceles
algunas sugerencias para empezar.
Antes de invitar al usuario a agregar artículos al carrito, realiza una verificación de backend. Para ello, agrega el relleno de ranuras y usa el tipo de ranura actions.type.TransactionRequirementsCheckResult
a fin de confirmar que el usuario haya configurado los pagos para Asistente de Google.
Prepárate para responder a los mismos problemas de voz que con otras experiencias web o para dispositivos móviles. Por ejemplo, ofrece un artículo similar cuando no tengas un tamaño o color determinado, o invita a los usuarios a registrarse para recibir una notificación cuando el artículo vuelva a estar en stock.
Ten en cuenta que el resumen del pedido se compila con los datos que pasas a través de la API.
La etiqueta "Pagar con Google" ayuda a los usuarios a comprender que Google facilitó el pago.
Cuando solicites información a los usuarios, como su dirección, primero infórmales por qué envías la solicitud y cómo los beneficiará.
Google presentará el método de autorización de compra (no se requiere autenticación, contraseña ni huella digital) según la configuración del usuario. En ocasiones, nuestra evaluación de riesgos iniciará un paso de autenticación adicional, como confirmar el CVV de una tarjeta.
Una vez que se complete el pago, asegúrate de enviar un recibo y una confirmación del pedido. Es importante que los usuarios comprendan que eres el comerciante oficial, y te enviarán todos los detalles del pedido, no Google.
De forma predeterminada, las transacciones se pueden realizar en una superficie con una pantalla (como un teléfono Android) o en una plataforma solo de voz (como Google Home).
Para admitir mejor las transacciones solo de voz, presta especial atención a diseñar una buena experiencia de conversación que guíe a los usuarios a través de la experiencia de transacción completa.
Ten en cuenta que algunos intents de transacciones pueden requerir una pantalla. La mayoría de estos (p.ej., agregar una nueva dirección de entrega, solucionar problemas de pago o vincular la cuenta) se transferirán al teléfono automáticamente. Si hay incorporaciones en la conversación que se muestran mejor en una pantalla (p.ej., presentar respuestas enriquecidas para la creación de tarjetas, mostrar las Condiciones del Servicio de un comercio o una política de privacidad), debes verificar si la plataforma actual admite las capabilities RICH_RESPONSE
o WEB_LINK
, y, en caso contrario, transferirla a una plataforma nueva.
Si prefieres no admitir transacciones solo por voz con tu Acción, puedes configurar tu proyecto de acciones para que requiera una pantalla. Para ello, navega hasta Implementar > Funciones de Surface en la Consola de Actions y configura Do your Actions required a screen output en Yes.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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**."]]