View a markdown version of this page

Invio WhatsApp di flussi agli utenti - AWS Messaggistica social per gli utenti finali
Esempio: invio di un flusso tramite messaggio modelloConfigurazione di un modello per Flows

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

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

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_tokenDeve 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

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 Per informazioni sulla configurazione del modello Flow, consulta Invio di un flusso nella documentazione di Meta WhatsApp Business Platform.