Criação e edição de WhatsApp fluxos

Você pode criar um WhatsApp fluxo usando o console social do AWS End User Messaging ou a API AWS End User Messaging Social. Quando você cria um Flow, ele é colocado no status DRAFT. Opcionalmente, você pode fornecer uma definição JSON de fluxo no momento da criação ou adicioná-la posteriormente usando a operação de atualização de ativos.

Criação de um fluxo (console)

1. Abra o console social do AWS End User Messaging em https://console.aws.amazon.com/social-messaging/.

2. Escolha Conta comercial e, em seguida, escolha uma WABA.

3. Escolha a guia Fluxos.

4. Selecione Create flow (Criar fluxo).

5. Em Nome do fluxo, insira um nome exclusivo para seu fluxo. Os nomes dos fluxos devem ser exclusivos dentro do WABA (máximo de 200 caracteres).

6. Em Categoria, selecione uma ou mais categorias que descrevam a finalidade comercial do seu Flow. É necessária pelo menos uma categoria. As categorias disponíveis são:

   • Cadastrar-se

   • Entrar

   • Marcação de consultas

   • Geração de leads

   • Entre em contato conosco

   • Suporte ao cliente

   • Pesquisa

   • Compras

   • Outros

7. Em Modelo, escolha um modelo pré-criado para começar ou escolha Padrão para começar com um fluxo em branco. Os modelos a seguir estão disponíveis sem um endpoint:

   • Padrão — Um modelo inicial em branco

   • Colete juros de compra — Colete informações de potenciais compradores

   • Obtenha feedback — Reúna o feedback dos clientes

   • Envie uma pesquisa — Crie uma pesquisa com várias perguntas

   • Suporte ao cliente — Colete detalhes da solicitação de suporte

8. Escolha Criar.

Depois de criar o Flow, você pode editar o Flow JSON para personalizar as telas e os componentes. A visualização do Flow no lado direito da página mostra uma prévia ao vivo de como seu Flow aparecerá para os usuários em WhatsApp.

Criação de um fluxo (API)

Use a CreateWhatsAppFlow API para criar um novo Flow. O exemplo a seguir usa o AWS CLI para criar um Flow com nome e categoria:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "my_lead_generation_form" \
    --categories '["LEAD_GENERATION"]'

A resposta inclui o ID de fluxo atribuído pelo Meta:

{
    "flowId": "{FLOW_ID}",
    "validationErrors": []
}

Você também pode fornecer uma definição de Flow JSON no momento da criação e publicar imediatamente:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "appointment_booking" \
    --categories '["APPOINTMENT_BOOKING"]' \
    --flow-json fileb://flow.json \
    --publish

nota

Se você incluir--publish, o Flow JSON deve ser válido e passar pela validação do Meta. Se houver erros de validação, o Flow é criado no status DRAFT e os erros são retornados no validationErrors campo.

Para clonar um fluxo existente dentro do mesmo WABA:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "lead_form_v2" \
    --categories '["LEAD_GENERATION"]' \
    --clone-flow-id {FLOW_ID}

Atualizando um fluxo

Há dois tipos de atualizações que você pode fazer em um Flow:

• Atualizar metadados — altere o nome ou as categorias do fluxo usandoUpdateWhatsAppFlow.

• Atualizar ativos — altere a definição do Flow JSON usandoUpdateWhatsAppFlowAssets.

Importante

A atualização dos ativos de um Flow publicado reverte seu status para DRAFT. Você deve republicar o Flow para que ele esteja disponível para uso em mensagens.

O exemplo a seguir atualiza o nome de um Flow:

aws socialmessaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-name "updated_lead_form"

O exemplo a seguir atualiza a definição JSON de um Flow:

aws socialmessaging update-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-json fileb://updated_flow.json

Se o Flow JSON contiver erros de validação, eles serão retornados na resposta. Você deve corrigir esses erros antes de publicar o Flow.

Listando e visualizando fluxos

Use ListWhatsAppFlows para ver todos os fluxos de um WABA e GetWhatsAppFlow para recuperar detalhes sobre um fluxo específico.

Listar todos os fluxos:

aws socialmessaging list-whatsapp-flows \
    --id {WABA_ID}

Obtenha detalhes de um fluxo específico:

aws socialmessaging get-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

A GetWhatsAppFlow resposta inclui o status do fluxo, categorias, erros de validação, versão do JSON, informações de visualização e status de integridade.

Para recuperar a definição do Flow JSON (ativos), use: ListWhatsAppFlowAssets

aws socialmessaging list-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

A resposta inclui um URL de download pré-assinado para o arquivo JSON do Flow. O URL expira após um curto período. Nenhuma autenticação adicional é necessária para baixar o arquivo do URL.

Excluindo um fluxo

Você só pode excluir fluxos que estão no status DRAFT. Fluxos publicados ou obsoletos não podem ser excluídos.

Para excluir um fluxo usando o console, selecione o Fluxo na guia Fluxos e escolha Excluir.

Para excluir um fluxo usando a API:

aws socialmessaging delete-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

Atenção

A exclusão de um fluxo é permanente e não pode ser desfeita.