# Enviar mensagens únicas do WhatsApp

<Aside type="note" title="Antes de começar">
Conecte sua Conta do WhatsApp Business em **Configurações → Configurar Plataformas → WhatsApp** e certifique-se de que pelo menos um modelo de mensagem foi criado e aprovado em sua conta do Gerenciador do WhatsApp antes de criar uma campanha. [Saiba como](/pt/product/first-steps/start-with-your-project/configure-platforms/whatsapp-configuration/)
</Aside>

Para enviar uma mensagem única do WhatsApp no Pushwoosh, navegue até a seção **Campanhas**, selecione **Mensagens únicas** e clique em **Enviar mensagem** > **WhatsApp**.

## Selecionar conteúdo do WhatsApp

Na etapa de **Conteúdo**, escolha um [modelo do WhatsApp](https://www.facebook.com/business/help/2055875911147364?id=2129163877102343) aprovado no menu suspenso. A pré-visualização à direita mostra o cabeçalho e o corpo do texto do modelo.

<img src="/messaging-channels-whatsapp-one-time-1.webp" alt="Etapa de conteúdo do WhatsApp com menu suspenso de modelos e pré-visualização da mensagem"/>

<Aside type="caution" title="Apenas modelos">
Mensagens únicas do WhatsApp só podem usar modelos aprovados. Você não pode enviar texto de formato livre desta forma. Mensagens de formato livre são entregues apenas dentro da janela de 24 horas aberta por uma mensagem recebida do usuário e são enviadas de **Mensagens do WhatsApp → Conversas**, não de uma campanha única. [Saiba mais](/pt/product/messaging-channels/whatsapp-messages/send-whatsapp-messages/#send-free-form-messages-and-view-your-whatsapp-conversations)
</Aside>

### Configurar variáveis do modelo

Se o modelo selecionado contiver placeholders no cabeçalho, no corpo ou em uma URL de botão, configure um valor para cada um antes de prosseguir.

<img src="/messaging-channels-whatsapp-one-time-2.webp" alt="Painel de configuração de variáveis do WhatsApp com opções de Tag e Texto personalizado"/>

Para cada placeholder, escolha o **Tipo de Variável**:

*   **Tag**: valor de uma tag de usuário (ex. `first_name`). Selecione a tag, um modificador de caixa de texto (**CapitalizeFirst**, **CapitalizeAllFirst**, **UPPERCASE**, **lowercase** ou **regular**) e um texto de fallback opcional usado quando a tag está vazia.
*   **Texto personalizado**: um valor fixo inserido manualmente.

### Selecionar tipo de mensagem

Escolha como esta mensagem do WhatsApp é tratada para as regras de assinatura e entrega:

*   **Mensagem de marketing**: Respeita os opt-outs do usuário e o limite de frequência. Não é enviada para usuários do [grupo de controle global](/pt/product/audience-data-and-segmentation/global-control-group/).
*   **Mensagem transacional**: Enviada para todos os usuários, independentemente do status de assinatura. Ignora opt-outs e limite de frequência. Entregue aos usuários do grupo de controle.

<img src="/messaging-channels-whatsapp-one-time-3.webp" alt="Opções de Mensagem de marketing e Mensagem transacional no formulário de campanha do WhatsApp"/>

[Saiba como o tipo de mensagem afeta a entrega](/pt/product/messaging-channels/marketing-vs-transactional/).

## Selecionar o público para sua campanha do WhatsApp

Na etapa de **Público**, defina quem receberá sua mensagem do WhatsApp.

<img src="/messaging-channels-whatsapp-one-time-4.webp" alt="Etapa de público do WhatsApp com as opções Enviar para segmento, lista de números de telefone e todos os assinantes"/>

### Enviar para segmento

Segmente um [segmento](/pt/product/audience-data-and-segmentation/segmentation/) predefinido do seu público com base em tags, eventos ou comportamento. Selecione um segmento no menu suspenso ou clique em **Criar segmento** para [construir](/pt/product/audience-data-and-segmentation/segmentation/create-segments/) ou [importar](/pt/product/audience-data-and-segmentation/segmentation/create-segments/by-import/#how-to-import-a-segment) um.

### Enviar para uma lista de números de telefone

Envie a mensagem para uma lista específica de números de telefone inseridos diretamente no formulário. Números de telefone que ainda não estão em seu projeto são registrados automaticamente como dispositivos WhatsApp e incluídos no envio.

### Enviar para todos os assinantes

Segmente todo o seu público alcançável pelo WhatsApp.

Depois de definir seu público, clique em **Avançar** para prosseguir para a etapa de agendamento.

## Agendar mensagem do WhatsApp

Escolha quando enviar sua mensagem do WhatsApp.

### Enviar imediatamente

Envie a mensagem assim que a configuração da campanha estiver concluída. Isso é ideal para mensagens urgentes ou sensíveis ao tempo.

### Horário selecionado

Agende sua mensagem do WhatsApp para uma data e hora específicas.

*   **Definir a data e a hora**: Use o calendário para escolher a data e, em seguida, especifique a hora em horas e minutos (formato de 24 horas).
*   **Selecionar o fuso horário**:
    *   **Fuso horário do dispositivo do assinante**: A mensagem é enviada na hora local especificada para cada destinatário.
    *   **Fuso horário personalizado**: A mensagem é enviada no mesmo horário para todos os destinatários, útil para segmentar uma região específica.

<img src="/messaging-channels-whatsapp-one-time-5.webp" alt="Agendamento do WhatsApp com as opções Enviar imediatamente e Horário selecionado, seletor de data e seleção de fuso horário"/>

### Configurar as definições de entrega da mensagem

#### Definir limite de frequência

Use o [**Limite de frequência**](/pt/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping) para limitar a frequência com que os usuários recebem mensagens do WhatsApp, evitando o excesso de mensagens e reduzindo os opt-outs. Escolha uma das seguintes opções:

*   **Usar as configurações globais de limite de frequência**

    Aplique os limites de todo o projeto configurados em suas [configurações globais de limite de frequência](/pt/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping). Por exemplo, se o limite global for de 3 mensagens em 9 dias, as mensagens adicionais que excederem esse limite serão ignoradas.
    <img src="/push-notifications-one-time-push-25.webp" alt="Opção Usar as configurações globais de limite de frequência selecionada na configuração de entrega de mensagens"/>
*   **Ignorar o limite de frequência global**

    O usuário recebe esta mensagem mesmo que tenha excedido os limites de mensagens do canal. Use com cautela para evitar o excesso de mensagens.
    <img src="/push-notifications-one-time-push-26.webp" alt="Opção Ignorar o limite de frequência global selecionada nas configurações de entrega de mensagens"/>
*   **Usar limite de frequência personalizado**

    Defina um limite de mensagem personalizado para esta mensagem. Se o usuário exceder esse limite personalizado, a mensagem será ignorada.
    <img src="/push-notifications-one-time-push-27.webp" alt="Usar limite de frequência personalizado com campos de entrada de limite de mensagem para período e intervalo de tempo"/>

<Aside type="note">
O limite de frequência se aplica apenas a mensagens de **Marketing**. Quando você escolhe **Transacional**, o limite de frequência não se aplica e essas opções são desativadas.
</Aside>

#### Definir limites de taxa de envio

A configuração de **Taxa de envio** controla a rapidez com que as mensagens são entregues ao seu público. Ajustar a taxa de envio ajuda a gerenciar a velocidade de entrega, evitar sobrecarga no backend e melhorar a capacidade de entrega geral.

Escolha uma das seguintes opções:

*   **Usar as configurações globais de taxa de envio**

    Aplica os limites de taxa de envio configurados nas configurações de entrega de mensagens do seu projeto. Se nenhum limite for definido, todas as mensagens serão enviadas imediatamente. [Saiba mais sobre os limites globais de taxa de envio](/pt/product/messaging-channels/global-frequency-capping/#set-send-rate-limits)
    <img src="/send-rate-in-journey-elements-1.webp" alt="Opção Usar as configurações globais de taxa de envio selecionada na configuração de taxa de envio"/>
*   **Enviar mensagens sem taxa de envio**

    Envia mensagens o mais rápido possível, ignorando quaisquer limites globais de taxa de envio. Use com cautela para evitar picos de entrega.
    <img src="/send-rate-in-journey-elements-2.webp" alt="Opção Enviar mensagens sem taxa de envio selecionada para velocidade máxima de entrega"/>
*   **Usar taxa de envio personalizada**

    Substitui a taxa de envio global apenas para esta mensagem. Especifique o número de mensagens enviadas por minuto para controle total sobre a velocidade de entrega.
    <img src="/send-rate-in-journey-elements-3.webp" alt="Opção Usar taxa de envio personalizada com campo de entrada para configuração de mensagens por minuto"/>

Depois de configurar as opções, clique em **Avançar** para prosseguir para a etapa de confirmação.

## Revisar e enviar

Em **Revisar**, verifique a pré-visualização e os resumos de conteúdo, público e agendamento. Atualize o que ainda precisar ser alterado antes de enviar.

<img src="/messaging-channels-whatsapp-one-time-6.webp" alt="Etapa de revisão da campanha do WhatsApp mostrando a pré-visualização da mensagem, público e resumo do agendamento antes do envio"/>

Depois que tudo for verificado, clique em **Agendar** para definir para entrega posterior ou **Enviar Agora** para enviar imediatamente, dependendo das opções de agendamento selecionadas.

## Cancelar ou editar uma mensagem agendada do WhatsApp

Para mensagens do WhatsApp que estão agendadas e ainda não foram enviadas (status **PENDENTE**), você pode alterá-las ou cancelá-las. Abra a lista de mensagens em **Campanhas** → **Mensagens únicas** e, em seguida, abra o menu de ações (⋮) para a mensagem:

*   **Editar mensagem**: abre o formulário do WhatsApp com os dados da mensagem carregados. Você pode atualizar o conteúdo, o público, o agendamento e as configurações de entrega.
*   **Excluir mensagem**: cancela a entrega agendada e altera o status para **Cancelado**.

<Aside type="tip">
Você também pode enviar mensagens do WhatsApp usando a [API de Mensagens v2 `Notify`](/pt/developer/api-reference/messaging-api-v2/notify/) com o [bloco de payload `whatsapp`](/pt/developer/api-reference/messaging-api-v2/payload-reference/#whatsapp-whatsapp). Isso requer a assistência da sua equipe de desenvolvimento.
</Aside>

<Aside type="note" title="Precisa de catálogos, vouchers ou ramificações?">
Mensagens únicas do WhatsApp cobrem apenas envios de modelo único. Para catálogos de produtos, códigos de voucher, ramificação de resposta rápida ou fluxos divididos com base no status de leitura, use o WhatsApp na [Jornada do Cliente](/pt/product/messaging-channels/whatsapp-messages/send-whatsapp-messages/send-whatsapp-via-customer-journey/) em vez disso.
</Aside>

## Cenário de exemplo

Imagine que você administra uma loja de e-commerce e deseja enviar um alerta de venda relâmpago por WhatsApp para clientes que compraram nos últimos 90 dias, agendado para a manhã em que a venda começa.

**1.** Navegue até **Campanhas**, selecione **Mensagens únicas**, clique em **Enviar mensagem** e escolha **WhatsApp**.

**2.** Na etapa de **Conteúdo**, selecione o modelo **Alerta de Venda Relâmpago** e preencha seus placeholders. Por exemplo, mapeie a variável `{{1}}` do corpo para a tag `discount` com um fallback de `50%`.

Mantenha o tipo de mensagem como **Marketing** para que respeite os opt-outs e o limite de frequência.

**3.** Na etapa de **Público**, escolha **Enviar para segmento** e selecione **Compradores recentes (90 dias)**.

**4.** Na etapa de **Agendamento**, escolha **Horário selecionado**, defina a data e a hora para o início da venda e selecione **Fuso horário do dispositivo do assinante** para que cada cliente receba na mesma hora local.

**5.** Em **Revisar**, verifique a pré-visualização e os resumos de público e agendamento e, em seguida, clique em **Agendar** para finalizar a campanha.