

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Invio WhatsApp di flussi agli utenti
<a name="managing-flows-send"></a>

Invii Flows agli utenti tramite messaggi modello utilizzando l'API esistente. `SendWhatsAppMessage` Non sono richieste modifiche all'API di invio messaggi. Il flusso è incorporato nel messaggio modello come componente di pulsante con un `flow` sottotipo.

Prima di poter inviare un Flow, deve essere vero quanto segue:
+ Il flusso deve essere nello stato PUBBLICATO.
+ È necessario disporre di un modello di messaggio che faccia riferimento al flusso (con un pulsante Flow).
+ L'utente deve aver scelto di ricevere messaggi da te.

## Esempio: invio di un flusso tramite messaggio modello
<a name="managing-flows-send-example"></a>

L'esempio seguente invia un messaggio modello che contiene un pulsante Flow. `flow_token`È un identificatore univoco fornito per tenere traccia della sessione e `flow_action_data` specifica la schermata iniziale e tutti i dati iniziali.

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

Nel comando precedente, sostituisci quanto segue:
+ {{{PHONE\_NUMBER\_ID}}}— L'ID del tuo numero di telefono di origine.
+ {{\+14085551234}}— Il numero di telefono del destinatario in formato internazionale.
+ {{flow\_template\_name}}— Il nome del modello di messaggio approvato che include un pulsante Flow.
+ {{unique-session-token-123}}— Un token univoco generato per identificare questa sessione di Flow. Questo token viene restituito nel webhook quando l'utente completa il Flow.
+ {{WELCOME\_SCREEN}}— L'ID della prima schermata nella definizione JSON di Flow.

**Nota**  
`flow_token`Deve essere univoco per sessione per consentire di correlare le risposte Flow a eventi di invio specifici. Puoi utilizzare un UUID o qualsiasi altro identificatore univoco.

## Configurazione di un modello per Flows
<a name="managing-flows-send-template-setup"></a>

Per inviare un Flow, è necessario un modello di messaggio con un pulsante Flow configurato. Quando crei il modello, aggiungi un pulsante di invito all'azione di tipo `FLOW` che faccia riferimento al tuo Flow ID pubblicato.

Per ulteriori informazioni sulla creazione di modelli di messaggi, consulta. [Utilizzo di modelli di messaggi in AWS End User Messaging Social](managing-templates.md) Per informazioni sulla configurazione del modello Flow, consulta [Invio di un flusso](https://developers.facebook.com/docs/whatsapp/flows/gettingstarted/sendingaflow) nella *documentazione di Meta WhatsApp Business Platform*.