View a markdown version of this page

사용자에게 WhatsApp 흐름 전송 - AWS 최종 사용자 메시징 소셜
예: 템플릿 메시지를 통해 흐름 전송흐름에 대한 템플릿 설정

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사용자에게 WhatsApp 흐름 전송

기존 SendWhatsAppMessage API를 사용하여 템플릿 메시지를 통해 사용자에게 흐름을 보냅니다. 메시지 전송 API는 변경할 필요가 없습니다. 흐름은 템플릿 메시지에 flow 하위 유형이 있는 버튼 구성 요소로 포함됩니다.

흐름을 전송하려면 먼저 다음이 true여야 합니다.

  • 흐름은 게시됨 상태여야 합니다.

  • 흐름을 참조하는 메시지 템플릿이 있어야 합니다(흐름 버튼 사용).

  • 사용자가 메시지를 수신하도록 옵트인해야 합니다.

예: 템플릿 메시지를 통해 흐름 전송

다음 예시에서는 흐름 버튼이 포함된 템플릿 메시지를 보냅니다. flow_token는 세션을 추적하기 위해 제공하는 고유 식별자이며 시작 화면과 초기 데이터를 flow_action_data 지정합니다.

aws socialmessaging send-whatsapp-message \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --meta-api-version v20.0 \
    --message '{
        "messaging_product": "whatsapp",
        "to": "+14085551234",
        "type": "template",
        "template": {
            "name": "flow_template_name",
            "language": {"code": "en_US"},
            "components": [
                {
                    "type": "button",
                    "sub_type": "flow",
                    "index": "0",
                    "parameters": [
                        {
                            "type": "action",
                            "action": {
                                "flow_token": "unique-session-token-123",
                                "flow_action_data": {
                                    "screen": "WELCOME_SCREEN",
                                    "data": {}
                                }
                            }
                        }
                    ]
                }
            ]
        }
    }'

이전 명령에서 다음을 바꿉니다.

  • {PHONE_NUMBER_ID} - 발신 전화번호의 ID입니다.

  • +14085551234 - 수신자의 국제 형식 전화번호입니다.

  • flow_template_name - 흐름 버튼이 포함된 승인된 메시지 템플릿의 이름입니다.

  • unique-session-token-123 -이 흐름 세션을 식별하기 위해 생성하는 고유한 토큰입니다. 이 토큰은 사용자가 흐름을 완료하면 웹후크에 반환됩니다.

  • WELCOME_screen - 흐름 JSON 정의에서 첫 번째 화면의 ID입니다.

참고

는 흐름 응답을 특정 전송 이벤트와 상호 연관시킬 수 있도록 세션당 고유flow_token해야 합니다. UUID 또는 기타 고유 식별자를 사용할 수 있습니다.

흐름에 대한 템플릿 설정

흐름을 전송하려면 흐름 버튼이 구성된 메시지 템플릿이 필요합니다. 템플릿을 생성할 때 게시된 흐름 ID를 참조FLOW하는 유형의 call-to-action 버튼을 추가합니다.

메시지 템플릿 생성에 대한 자세한 내용은 섹션을 참조하세요AWS End User Messaging Social에서 메시지 템플릿 사용. 흐름 템플릿 구성에 대한 자세한 내용은 Meta WhatsApp Business Platform 설명서의 흐름 전송을 참조하세요.