Entendendo as mensagens do WhatsApp

A partir de 1º de junho de 2023, o WhatsApp passará a adotar um modelo de preços baseado no uso para todas as empresas em todo o mundo que enviam mensagens pelo WhatsApp. As alterações de preço se aplicarão apenas às taxas do WhatsApp. Não haverá alterações nas taxas da plataforma Vonage. Informações sobre as alterações de preços da Plataforma WhatsApp Business podem ser encontradas no Site do WhatsApp.

As mensagens do WhatsApp Business Solution só podem ser enviadas por empresas aprovadas pelo WhatsApp. Esse perfil empresarial também terá um selo verde de verificação para indicar que se trata de uma empresa legítima.

A vantagem do WhatsApp é que o identificador dos usuários na plataforma é o número de celular deles.

NOTA: O WhatsApp está com disponibilidade limitada e a Vonage não pode garantir que você receberá um Account do WhatsApp.

Para começar a usar o WhatsApp, leia Introdução ao WhatsApp.

Regras para o envio de mensagens aos clientes

O WhatsApp possui um conceito de janela de atendimento ao cliente de 24 horas, durante a qual uma empresa pode enviar mensagens livremente a um usuário final. Essa janela de 24 horas pode ser iniciada de duas maneiras:

Um usuário final envia uma mensagem para a empresa
Uma empresa envia uma mensagem padrão ao usuário final. O prazo de 24 horas começa assim que o usuário final responde.

Os modelos devem ser aprovados pelo WhatsApp antes de poderem ser usados para enviar mensagens a um usuário final. Quando o prazo de 24 horas expirar, um novo prazo de 24 horas para atendimento ao cliente deverá ser reiniciado. É importante estar ciente de que os prazos de 24 horas para atendimento ao cliente não são os mesmos que o prazo de 24 horas para conversas faturáveis.

Preços com base nas mensagens do WhatsApp

A Vonage agora oferece o modelo de cobrança por mensagem (PMP) para mensagens no WhatsApp, em consonância com as últimas mudanças na política de cobrança da Meta. Esse modelo substitui a abordagem anterior de cobrança por conversa (CBP).

A partir de 1º de julho de 2025, a Meta cobrará pelas mensagens-modelo por mensagem, e não por conversa. Isso significa que cada mensagem-modelo enviada pela empresa será cobrada individualmente, com base na categoria da mensagem-modelo.

Como a Vonage define os preços das mensagens? A estrutura de preços da Vonage para mensagens pelo WhatsApp é composta por dois componentes:

Uma taxa de plataforma da Vonage — cujo valor é o seguinte por mensagem.
Uma taxa do WhatsApp — esse é o valor por mensagem de modelo. Atualmente, existem três categorias de modelos de mensagem, sendo que cada uma delas é cobrados a taxas diferentes:
- Modelos de utilitários - Permite a conclusão de uma solicitação ou transação específica e previamente acordada, ou fornece ao cliente informações atualizadas sobre uma transação em andamento, incluindo notificações pós-compra e extratos de cobrança regulares.
- Modelos de autenticação - Permite que as empresas utilizem códigos de acesso únicos para verificar os usuários em diversas etapas de login, se necessário (por exemplo, verificação de conta, recuperação de conta, verificações de integridade).
- Modelos de marketing - Mensagens enviadas pela empresa para promover um produto ou serviço aos clientes, como o envio de ofertas relevantes a clientes que tenham dado consentimento. Isso também incluiria qualquer interação relacionada à empresa que não seja uma conversa de autenticação ou de natureza utilitária.

Para obter mais informações sobre os preços do WhatsApp da Vonage, consulte o Preços da Messages API página. Mais informações sobre o modelo de precificação baseado em mensagens podem ser encontradas no Documentação para desenvolvedores do WhatsApp.

Tipos de mensagens do WhatsApp

Existem vários tipos diferentes de mensagens no WhatsApp:

Tipo de mensagem	Descrição
Mensagem de texto	Uma mensagem de texto simples. Esse é o tipo de mensagem padrão.
Comunicado à imprensa	Uma mensagem de mídia. Os tipos são: imagem, áudio, documento e vídeo.
Modelo de mensagem	Os modelos de mensagem são criados no WhatsApp Manager. Fora da janela de atendimento ao cliente, as mensagens enviadas a um cliente devem ser do tipo “modelo de mensagem”. Somente os modelos criados em seu próprio namespace funcionarão. O uso de um modelo com um namespace diferente do seu resultará na exibição do código de erro 1022.
Modelos de mensagens para a mídia	Os modelos de mensagem com mídia ampliam o conteúdo que você pode enviar aos destinatários, indo além do tipo padrão de modelo de mensagem, para incluir mídia, cabeçalhos e rodapés usando um `components` objeto.
Mensagem de contato	Envie uma lista de contatos como mensagem.
Mensagem sobre localização	Envie uma localização como mensagem.
Mensagem interativa	A Messages API da Vonage v1 oferece suporte a dois tipos de mensagens interativas do WhatsApp: Listar mensagens, Botões de resposta, e Mensagens sobre produtos. Leia mais

Como funciona o WhatsApp

Uma empresa pode iniciar uma conversa com um usuário, e um usuário pode iniciar uma conversa com uma empresa.

O WhatsApp possui um conceito central chamado “Modelos de Mensagens” (MTM). Anteriormente, esses modelos eram conhecidos como “Mensagens Altamente Estruturadas” (HSM).

IMPORTANTE: O WhatsApp exige que uma mensagem enviada a um usuário pela primeira vez, ou que esteja fora do Período de Atendimento ao Cliente, seja uma mensagem MTM. O WhatsApp também exige que você obtenha o consentimento prévio de seus clientes antes de enviar uma mensagem a eles; esse consentimento pode ser obtido em seu site, por meio do IVR ou por outros meios padrão. Consulte Documentação do Facebook para mais detalhes.

O MTM permite que uma empresa envie apenas o identificador do modelo, juntamente com os parâmetros apropriados, em vez do conteúdo completo da mensagem.

NOTA: Os novos modelos precisam ser aprovados pelo WhatsApp. Entre em contato com o gerente de contas da API da Vonage para enviar os modelos. Somente os modelos criados em seu próprio namespace são válidos. O uso de um modelo com um namespace diferente do seu resultará na exibição do código de erro 1022.

NOTA: Os modelos estão sujeitos a uma restrição de 60 caracteres no cabeçalho e no rodapé, e de 1.024 caracteres no corpo do texto.

Os MTMs foram criados para reduzir a probabilidade de os usuários receberem spam no WhatsApp.

Para que você possa experimentar o WhatsApp, a Vonage oferece o Sandbox da Messages API.

Política de linguagem determinística do WhatsApp

NOTA: O WhatsApp descontinuou o uso do método de localização “fallback” no envio de mensagens-modelo em 1º de janeiro de 2020. A partir de 8 de abril de 2020, as mensagens que utilizarem a política “fallback” resultarão em falha, com um erro 1020 no seu webhook de status de mensagens.

Quando um modelo de mensagem é enviado com a política de idioma determinística, o dispositivo receptor consultará seu cache em busca de um pacote de idiomas para o idioma e a configuração regional especificados na mensagem. Se não estiver disponível no cache, o dispositivo consultará o servidor para obter o pacote de idioma necessário. Com a política de idioma determinística, as configurações de idioma e de região do dispositivo de destino são ignoradas. Se o pacote de idioma especificado para a mensagem não estiver disponível, será registrado um erro.

Mais informações estão disponíveis no Documentação do WhatsApp.

API de gerenciamento de modelos do WhatsApp

A API de gerenciamento de modelos do WhatsApp permite que você, por meio de programação, liste os modelos existentes do WhatsApp, crie novos modelos, exclua modelos e envie arquivos de mídia para uso nos modelos.

Você pode ler mais no Guia da API de gerenciamento de modelos do WhatsApp.