As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Envio WhatsApp de fluxos para usuários
<a name="managing-flows-send"></a>

Você envia fluxos aos usuários por meio de mensagens modelo usando a `SendWhatsAppMessage` API existente. Nenhuma alteração na API de envio de mensagens é necessária. O Flow é incorporado na mensagem do modelo como um componente de botão com um `flow` subtipo.

Antes de enviar um Flow, o seguinte deve ser verdadeiro:
+ O fluxo deve estar no status PUBLICADO.
+ Você deve ter um modelo de mensagem que faça referência ao Flow (com um botão Flow).
+ O usuário deve ter optado por receber suas mensagens.

## Exemplo: envio de um fluxo por meio de mensagem modelo
<a name="managing-flows-send-example"></a>

O exemplo a seguir envia uma mensagem modelo que contém um botão Flow. `flow_token`É um identificador exclusivo que você fornece para rastrear a sessão e `flow_action_data` especifica a tela inicial e todos os dados iniciais.

```
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": {}
                                }
                            }
                        }
                    ]
                }
            ]
        }
    }'
```

No comando anterior, substitua o seguinte:
+ {{{PHONE\_NUMBER\_ID}}}— ID do seu número de telefone de origem.
+ {{\+14085551234}}— O número de telefone do destinatário em formato internacional.
+ {{flow\_template\_name}}— O nome do seu modelo de mensagem aprovado que inclui um botão Flow.
+ {{unique-session-token-123}}— Um token exclusivo que você gera para identificar essa sessão do Flow. Esse token é retornado no webhook quando o usuário conclui o Flow.
+ {{WELCOME\_SCREEN}}— O ID da primeira tela em sua definição de Flow JSON.

**nota**  
Eles `flow_token` devem ser exclusivos por sessão para permitir que você correlacione as respostas do Flow com eventos de envio específicos. Você pode usar um UUID ou qualquer outro identificador exclusivo.

## Configurando um modelo para Flows
<a name="managing-flows-send-template-setup"></a>

Para enviar um Flow, você precisa de um modelo de mensagem com um botão Flow configurado. Ao criar o modelo, adicione um botão de call-to-action do tipo `FLOW` que faça referência ao seu ID de fluxo publicado.

Para obter mais informações sobre a criação de modelos de mensagem, consulte[Usando modelos de mensagem no AWS End User Messaging Social](managing-templates.md). Para obter informações sobre a configuração do modelo de fluxo, consulte [Enviando um fluxo](https://developers.facebook.com/docs/whatsapp/flows/gettingstarted/sendingaflow) na *documentação da Meta WhatsApp Business Platform*.