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
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
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
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, consulteUsando modelos de mensagem no AWS End User Messaging Social. Para obter informações sobre a configuração do modelo de fluxo, consulte Enviando um fluxo
