# Enviar mensagens do WhatsApp via Customer Journey
Envie mensagens do WhatsApp através do Customer Journey da Pushwoosh. Você pode selecionar entre campanhas baseadas em público e baseadas em gatilho, usar modelos da sua conta Meta ou criar conteúdo personalizado dentro da Pushwoosh.
## Pré-requisitos
Para enviar mensagens do WhatsApp, certifique-se de que os seguintes requisitos sejam atendidos:
* **Configuração do WhatsApp concluída**: Certifique-se de que sua Conta do WhatsApp Business esteja integrada com a Pushwoosh. [Saiba mais](/pt/product/first-steps/start-with-your-project/configure-platforms/whatsapp-configuration)
* **Um método de pagamento para o WhatsApp adicionado**: A Meta cobra por cada mensagem enviada via WhatsApp. A Pushwoosh não lida com essas cobranças, portanto, certifique-se de que suas **informações de pagamento** estejam atualizadas em sua conta do WhatsApp.
* **Modelos disponíveis**: Certifique-se de que os modelos necessários já foram criados e aprovados em sua conta do Gerenciador do WhatsApp. [Saiba mais](https://www.facebook.com/business/help/2055875911147364?id=2129163877102343)
* [Lista de contatos do WhatsApp carregada](/pt/product/messaging-channels/whatsapp-messages/register-phone-numbers-for-whatsapp#how-to-import-whatsapp-contacts-from-a-csv-file).
## Criar uma nova campanha de WhatsApp
Para criar uma campanha:
1. Vá para **Campaigns > Customer Journey Builder > Create campaign > WhatsApp**.
2. Na tela da jornada, escolha o tipo de entrada apropriado com base no objetivo da sua campanha:
##### Entrada baseada em público
Segmente um grupo predefinido de usuários com base em filtros como localização, última atividade ou histórico de compras. Ideal para campanhas planejadas, recorrentes ou de reengajamento.
[Saiba mais](/pt/product/customer-journey/journey-elements/#audience-based-entry)
**Exemplos:**
* Envie uma promoção para usuários inativos por 30 dias
* Anuncie uma oferta sazonal para clientes fiéis
##### Entrada baseada em gatilho
Inicie a jornada quando um evento específico ocorrer, como um usuário concluindo uma compra ou reserva. Ideal para mensagens transacionais em tempo real ou atualizações baseadas em comportamento.
[Saiba mais](/pt/product/customer-journey/journey-elements/#trigger-based-entry)
**Exemplos:**
* Confirme um pedido quando o status mudar para “Pronto para retirada”
* Envie um lembrete 24 horas antes de um compromisso
##### Entrada baseada em API
Inicie a campanha programaticamente enviando uma solicitação POST do seu backend ou sistema externo. Ideal para automatizar mensagens com base em dados ou eventos externos.
[Saiba mais](/pt/product/customer-journey/journey-elements/#api-based-entry)
**Exemplos:**
* Notifique um usuário após uma atualização no CRM
* Envie uma oferta de WhatsApp após a conclusão de uma pesquisa
## Configurar um elemento de mensagem do WhatsApp
Adicione o elemento de mensagem do WhatsApp à tela e forneça um nome exclusivo para identificar a etapa da mensagem.
Em seguida, configure o conteúdo do WhatsApp de uma das duas maneiras:
* Escreva uma mensagem personalizada.
* Selecione um modelo de mensagem do WhatsApp pré-aprovado no menu suspenso.
O modelo deve estar disponível no idioma selecionado e aprovado pelo WhatsApp.
Saiba mais sobre [criar modelos](https://www.facebook.com/business/help/2055875911147364?id=2129163877102343) ou explore opções na [biblioteca de Modelos](https://www.facebook.com/business/help/722393685250070).
### Configurar variáveis dinâmicas
Após selecionar um modelo, a Pushwoosh exibe uma prévia do conteúdo da mensagem. Se o modelo contiver placeholders, cada um representa uma variável dinâmica que deve ser configurada antes que a mensagem possa ser enviada.
Para inserir uma variável:
1. Clique no placeholder `{}` na prévia da mensagem.
2. Selecione o **Tipo de Variável**:
* **Propriedade do usuário**: Valor do perfil do usuário (por exemplo, `first_name`, `email`).
* **Propriedade do evento**: Valor de um evento acionado (por exemplo, `product_name`, `order_status`).
* **Texto personalizado**: Valor estático inserido manualmente.
3. Selecione a tag relevante.
4. Defina o **Formato do Texto**:
* **CapitalizeFirst**: Coloca em maiúscula apenas a primeira palavra (`"john doe"` → `"John doe"`).
* **CapitalizeAllFirst**: Coloca em maiúscula cada palavra (`"john doe"` → `"John Doe"`).
* **UPPERCASE**: Tudo em maiúsculas (`"john doe"` → `"JOHN DOE"`).
* **lowercase**: Tudo em minúsculas (`"JOHN DOE"` → `"john doe"`).
* **regular**: Sem alterações de formatação.
5. (Opcional) Insira o **Texto de Fallback** a ser usado se a variável estiver vazia.
6. Clique em **Inserir**.
**Exemplo de modelo com fallback**
```
Olá, {first_name}!
Seu {product_name} está agora disponível com um desconto de {discount}.
```
Se `first_name` estiver ausente e o fallback for `"aí"`:
```
Olá, aí!
Seus sapatos estão agora disponíveis com um desconto de 20%.
```
### Configurar URLs de ação
Os modelos de mensagem do WhatsApp podem incluir botões de ação (por exemplo, “Comprar agora”) que abrem uma URL ao serem tocados. Esses botões podem ser personalizados usando variáveis dinâmicas inseridas como placeholders na URL.
A URL de ação é definida durante a criação do modelo em sua conta do Meta Business. Se a URL incluir placeholders (por exemplo, `{product_id}`), você deve atribuir um valor a cada placeholder na Pushwoosh antes de enviar a mensagem.
Para atribuir valor ao placeholder:
1. Clique no placeholder `{}` na URL.
2. Escolha o **Tipo de Variável** correto (por exemplo, Propriedade do usuário ou Propriedade do evento).
3. Selecione a variável apropriada (por exemplo, `product_id`).
4. (Opcional) Adicione **texto de fallback** caso a variável esteja ausente.
5. Clique em **Inserir** para aplicá-lo.
> **Importante:** Certifique-se de que todos os placeholders na URL de ação tenham variáveis atribuídas. A mensagem não será enviada se algum placeholder for deixado sem configuração.
### Adicionar anexos de mídia
Ao usar um modelo que inclui um arquivo de mídia (imagem, vídeo ou PDF), observe que a mídia não é armazenada no próprio modelo. Esses arquivos são carregados apenas como exemplos durante o envio do modelo à Meta para fins de validação. Para enviar a mensagem com sucesso em uma campanha ao vivo, você deve especificar a URL real do arquivo na Pushwoosh.
Para adicionar mídia, insira uma URL válida e publicamente acessível que aponte para o arquivo de mídia real no campo **Imagem**.
Exemplo: `https://yourdomain.com/files/offer-banner.jpg`
> **Importante:** A mensagem não será enviada se a URL do arquivo de mídia estiver ausente ou inacessível.
### Escolha o tipo de mensagem
No elemento do WhatsApp, selecione **Mensagem de marketing** ou **Mensagem transacional**:
* **Mensagem de marketing**: Para campanhas e promoções. Respeita opt-outs, limite de frequência e o período de silêncio. Exclui o [grupo de controle global](/pt/product/audience-data-and-segmentation/global-control-group/).
* **Mensagem transacional**: Para mensagens operacionais ou de serviço. Regras e limites não se aplicam. Ignora opt-outs, limite de frequência e o período de silêncio. É enviada para o [grupo de controle global](/pt/product/audience-data-and-segmentation/global-control-group/).
### Definir limite de frequência
Limite a frequência com que os usuários recebem mensagens do WhatsApp usando o [limite de frequência global](/pt/product/messaging-channels/global-frequency-capping/) ou um limite personalizado para a etapa.
[Saiba mais](/pt/product/customer-journey/journey-elements/channels/whatsapp/#set-frequency-capping).
### Dividir o fluxo com base no status de leitura da mensagem (opcional)
Você pode dividir a jornada com base na leitura da mensagem ou na interação do usuário com os botões da mensagem (por exemplo, Respostas Rápidas ou botões de Chamada para Ação).
- Para dividir pelo status de leitura, ative a opção **Dividir fluxo com base no status de leitura da mensagem** e configure o tempo de espera (até 7 dias).
- Para ramificar com base na interação com Resposta Rápida ou Botão, configure a jornada adequadamente. [Saiba mais](#configurar-respostas-rápidas)
### Usar vouchers
Você pode personalizar mensagens do WhatsApp anexando um código de voucher de um pool predefinido. Isso é útil para promoções, descontos e incentivos de fidelidade.
Para isso, crie um modelo do WhatsApp que inclua o placeholder ``{{voucher}}``.
Para incluir um voucher em sua mensagem do WhatsApp:
1. Alterne **Vouchers** para LIGADO na etapa da mensagem do WhatsApp.
2. No campo **Pool de Vouchers**, selecione o pool que contém seus códigos de voucher disponíveis. Certifique-se de adicionar o pool de vouchers com antecedência. Saiba mais
3. (Opcional) Use o campo **Atribuir Tag** para aplicar uma tag aos usuários que recebem um voucher. Essa tag pode ser usada para segmentação ou relatórios.
> **Importante:** Certifique-se de que o pool de vouchers selecionado tenha códigos suficientes para sua campanha. Se o pool se esgotar, a mensagem não será enviada.
> [Saiba mais sobre como criar e gerenciar pools de vouchers.](/pt/product/content/vouchers/)
Depois que o elemento do WhatsApp estiver configurado, clique em **Salvar** e continue configurando sua jornada. [Saiba mais](/pt/product/customer-journey/journey-elements/)
## Configurar respostas rápidas
As respostas rápidas no WhatsApp permitem que você ofereça aos usuários opções de resposta predefinidas. Com o Customer Journey Builder da Pushwoosh, você pode configurar cada resposta rápida para levar a um fluxo de jornada do usuário separado, fornecendo acompanhamentos personalizados.
Essa abordagem melhora a experiência do usuário, oferecendo escolhas claras e simples que correspondem ao nível de interesse de cada usuário, tornando as interações fluidas e personalizadas.
Para configurar respostas rápidas em seu fluxo de mensagens do WhatsApp:
1. Em sua conta Meta, selecione um modelo do WhatsApp existente ou [crie um novo](https://www.facebook.com/business/help/2055875911147364?id=2129163877102343) que inclua botões de Resposta Rápida.
Por exemplo, se sua mensagem for: ***"Você tem interesse em saber mais sobre nossa nova oferta?"*** Você pode configurar opções de resposta rápida como:
* ***"Sim, tenho interesse"***
* ***"Não, obrigado"***
* ***"Me diga mais"***
2. Em seguida, após adicionar e [configurar o elemento do WhatsApp](#set-up-a-whatsapp-message-element) com um modelo pré-aprovado da Meta, configure um caminho de jornada exclusivo para cada opção de resposta rápida.
Por exemplo:
* Se um usuário selecionar ***"Sim, tenho interesse"***, ele recebe uma mensagem de acompanhamento com detalhes sobre a oferta especial ou promoção.
* Se um usuário selecionar ***"Não, obrigado"***, a jornada termina para ele.
* Se um usuário selecionar ***"Me diga mais"***, ele recebe uma mensagem com informações adicionais do produto.
* Se um usuário não responder dentro de um período de tempo definido (por exemplo, 24 horas), configure um caminho adicional para enviar uma mensagem de lembrete ou encerrar a jornada.
> **Importante:** Certifique-se de configurar todas as etapas restantes da sua jornada antes de lançar a campanha. [Saiba mais](/pt/product/customer-journey/journey-elements/)
### Definir limite de frequência
Limite a frequência com que os usuários recebem mensagens do WhatsApp usando o [limite de frequência global](/pt/product/messaging-channels/global-frequency-capping/) ou um limite personalizado para a etapa.
[Saiba mais](/pt/product/customer-journey/journey-elements/channels/whatsapp/#set-frequency-capping).
### Dividir o fluxo com base no status de leitura da mensagem (opcional)
Você pode dividir a jornada com base na leitura da mensagem ou na interação do usuário com os botões da mensagem (por exemplo, Respostas Rápidas ou botões de Chamada para Ação).
- Para dividir pelo status de leitura, ative a opção **Dividir fluxo com base no status de leitura da mensagem** e configure o tempo de espera (até 7 dias).
- Para ramificar com base na interação com Resposta Rápida ou Botão, configure a jornada adequadamente. [Saiba mais](#configurar-respostas-rápidas)
### Usar vouchers
Você pode personalizar mensagens do WhatsApp anexando um código de voucher de um pool predefinido. Isso é útil para promoções, descontos e incentivos de fidelidade.
Para isso, crie um modelo do WhatsApp que inclua o placeholder ``{{voucher}}``.
Para incluir um voucher em sua mensagem do WhatsApp:
1. Alterne **Vouchers** para LIGADO na etapa da mensagem do WhatsApp.
2. No campo **Pool de Vouchers**, selecione o pool que contém seus códigos de voucher disponíveis. Certifique-se de adicionar o pool de vouchers com antecedência. Saiba mais
3. (Opcional) Use o campo **Atribuir Tag** para aplicar uma tag aos usuários que recebem um voucher. Essa tag pode ser usada para segmentação ou relatórios.
> **Importante:** Certifique-se de que o pool de vouchers selecionado tenha códigos suficientes para sua campanha. Se o pool se esgotar, a mensagem não será enviada.
> [Saiba mais sobre como criar e gerenciar pools de vouchers.](/pt/product/content/vouchers/)
Depois que o elemento do WhatsApp estiver configurado, clique em **Salvar** e continue configurando sua jornada. [Saiba mais](/pt/product/customer-journey/journey-elements/)
## Configurar respostas rápidas
As respostas rápidas no WhatsApp permitem que você ofereça aos usuários opções de resposta predefinidas. Com o Customer Journey Builder da Pushwoosh, você pode configurar cada resposta rápida para levar a um fluxo de jornada do usuário separado, fornecendo acompanhamentos personalizados.
Essa abordagem melhora a experiência do usuário, oferecendo escolhas claras e simples que correspondem ao nível de interesse de cada usuário, tornando as interações fluidas e personalizadas.
Para configurar respostas rápidas em seu fluxo de mensagens do WhatsApp:
1. Em sua conta Meta, selecione um modelo do WhatsApp existente ou [crie um novo](https://www.facebook.com/business/help/2055875911147364?id=2129163877102343) que inclua botões de Resposta Rápida.
Por exemplo, se sua mensagem for: ***"Você tem interesse em saber mais sobre nossa nova oferta?"*** Você pode configurar opções de resposta rápida como:
* ***"Sim, tenho interesse"***
* ***"Não, obrigado"***
* ***"Me diga mais"***
2. Em seguida, após adicionar e [configurar o elemento do WhatsApp](#set-up-a-whatsapp-message-element) com um modelo pré-aprovado da Meta, configure um caminho de jornada exclusivo para cada opção de resposta rápida.
Por exemplo:
* Se um usuário selecionar ***"Sim, tenho interesse"***, ele recebe uma mensagem de acompanhamento com detalhes sobre a oferta especial ou promoção.
* Se um usuário selecionar ***"Não, obrigado"***, a jornada termina para ele.
* Se um usuário selecionar ***"Me diga mais"***, ele recebe uma mensagem com informações adicionais do produto.
* Se um usuário não responder dentro de um período de tempo definido (por exemplo, 24 horas), configure um caminho adicional para enviar uma mensagem de lembrete ou encerrar a jornada.
> **Importante:** Certifique-se de configurar todas as etapas restantes da sua jornada antes de lançar a campanha. [Saiba mais](/pt/product/customer-journey/journey-elements/)