View a markdown version of this page

Envoi WhatsApp de flux aux utilisateurs - AWS Messagerie à l'utilisateur final : réseaux sociaux
Exemple : envoi d'un flux via un modèle de messageConfiguration d'un modèle pour Flows

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Envoi WhatsApp de flux aux utilisateurs

Vous envoyez des flux aux utilisateurs via des modèles de messages à l'aide de l'SendWhatsAppMessageAPI existante. Aucune modification de l'API d'envoi de message n'est requise. Le flux est intégré au modèle de message en tant que composant de bouton avec un flow sous-type.

Avant de pouvoir envoyer un flux, les conditions suivantes doivent être remplies :

  • Le flux doit avoir le statut PUBLIÉ.

  • Vous devez disposer d'un modèle de message qui fait référence au flux (avec un bouton de flux).

  • L'utilisateur doit avoir accepté de recevoir des messages de votre part.

Exemple : envoi d'un flux via un modèle de message

L'exemple suivant envoie un modèle de message contenant un bouton Flow. flow_tokenIl s'agit d'un identifiant unique que vous fournissez pour suivre la session et qui flow_action_data spécifie l'écran de démarrage et toutes les données initiales.

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

Dans la commande précédente, remplacez ce qui suit :

  • {PHONE_NUMBER_ID}— L'identifiant de votre numéro de téléphone d'origine.

  • +14085551234— Le numéro de téléphone du destinataire au format international.

  • flow_template_name— Le nom de votre modèle de message approuvé qui inclut un bouton Flow.

  • unique-session-token-123— Un jeton unique que vous générez pour identifier cette session Flow. Ce jeton est renvoyé dans le webhook lorsque l'utilisateur termine le flux.

  • WELCOME_SCREEN— L'ID du premier écran de votre définition Flow JSON.

Note

Ils flow_token doivent être uniques par session pour vous permettre de corréler les réponses de Flow avec des événements d'envoi spécifiques. Vous pouvez utiliser un UUID ou tout autre identifiant unique.

Configuration d'un modèle pour Flows

Pour envoyer un flux, vous avez besoin d'un modèle de message avec un bouton de flux configuré. Lors de la création du modèle, ajoutez un bouton d'appel à l'action du type FLOW qui fait référence à votre Flow ID publié.

Pour plus d'informations sur la création de modèles de messages, consultezUtilisation de modèles de messages dans AWS End User Messaging Social. Pour plus d'informations sur la configuration du modèle Flow, consultez la section Envoi d'un flux dans la documentation de la Meta WhatsApp Business Platform.