2023년 6월 13일에 대화형 작업이 종료되기 전에 2023년 5월 3일에 Transactions API가 지원 중단됩니다. 자세한 내용은
대화 작업 지원 중단을 참고하세요.
트랜잭션 대화 설계 (Dialogflow)
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
사용자에게 거래 흐름을 안내하는 대화를 설계하세요. 자체 트랜잭션 작업을 설계할 때 가이드로 사용할 수 있는 참조 예시를 제공했습니다.
예
디자인 팁
실제 사람이 말하는 방식과 같이 자연스러우면서도 자연스러운 대화가 되도록 하세요.
TTS/음성으로 말하는 텍스트는 채팅 풍선에 표시된 텍스트와 정확히 일치하지 않아도 됩니다. 채팅 풍선이 음성 대화상자의 하위 집합인 경우 원활하게 작동합니다.
방문자에게 인사하고 참여를 유도하세요. 무엇이 필요한지 물어보고 몇 가지 추천 칩을 제공하여 시작하는 데 도움을 주세요.
장바구니에 상품을 추가하도록 사용자를 초대하기 전에 actions.intent.TRANSACTION_REQUIREMENTS_CHECK
를 사용하여 백엔드 확인을 통해 사용자가 Google 어시스턴트에 결제를 설정했는지 확인합니다.
다른 모바일 또는 웹 환경과 마찬가지로 음성으로 문제에 대응할 준비를 해야 합니다. 예를 들어 특정 크기나 색상이 품절되었을 때 유사한 상품을 제공하거나 사용자가 상품이 재입고되면 알림을 받도록 가입하도록 유도할 수 있습니다.
주문 요약은 API를 통해 전달된 데이터를 사용하여 작성됩니다. 'Google을 통해 결제' 라벨을 통해 사용자는 Google에서 결제를 처리했음을 알 수 있습니다.
사용자에게 주소 정보와 같은 정보를 요청할 때는 먼저 요청하는 이유와 이를 통해 얻을 수 있는 이점을 설명하세요.
Google은 사용자의 설정에 따라 구매 승인 방법 (인증 필요 없음, 비밀번호 또는 지문)을 표시합니다. 위험 평가에서 카드의 CVV 확인과 같은 추가 인증 단계가 시작되는 경우가 있습니다.
결제가 완료된 후에는 영수증과 주문 확인서를 발송해야 합니다. 판매자가 등록된 판매자임을 사용자가 알고 있어야 하며 Google이 아닌 주문에 대한 모든 세부정보를 제공해야 합니다.
기본적으로 거래는 화면이 있는 표시 경로 (예: Android 휴대전화) 또는 음성 전용 표시 경로 (예: Google Home)에서 실행할 수 있습니다.
음성 전용 트랜잭션을 가장 효과적으로 지원하려면 사용자에게 전체 거래 환경을 안내하는 우수한 대화형 환경을 설계해야 합니다.
일부 트랜잭션 인텐트에는 화면이 필요할 수 있습니다. 새 배송지 주소 추가, 결제 문제 해결, 계정 연결 등 대부분의 작업은 자동으로 휴대전화로 전달됩니다. 대화에 가장 잘 표시되는 내용이 있는 경우 (예: 카드 제작에 관한 리치 응답 표시, 판매자 서비스 약관 또는 개인정보처리방침 표시) 현재 표시 경로에서 SCREEN_OUTPUT
또는 WEB_BROWSER
기능을 지원하는지 확인하고 지원되지 않는 경우 새로운 표시 경로로 전환해야 합니다.
작업에서 음성 전용 트랜잭션을 지원하지 않으려면 Actions 콘솔의 Deploy > Surface 기능으로 이동하여 Do your Actions required a screen output을 예로 설정하여 화면이 필요하도록 작업 프로젝트를 설정할 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 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**."]]