Como funciona a integração com o WhatsApp (mensagens transacionais)

A integração com o WhatsApp permite que a loja avise o cliente sobre o andamento da compra pelo aplicativo que ele mais usa: pedido recebido, pagamento aprovado, código de rastreio a caminho. São as chamadas mensagens transacionais, enviadas por modelos oficiais aprovados pelo WhatsApp Business.

Você a encontra em Comunicações > WhatsApp: Configurar. É a mesma tela que aparece em Marketing & SEO > Integrações, no item WhatsApp: são dois caminhos para o mesmo lugar.

Quanto custa (e por que isso importa)

A cobrança de cada mensagem é feita pela Meta, dona do WhatsApp, e o preço depende da categoria da mensagem. Essa diferença é o ponto mais importante de entender antes de ativar.

• Utilidade (transacional): avisos ligados a um pedido real, como pagamento aprovado e código de rastreio. Custam bem menos de um centavo de dólar por envio (na casa de US$ 0,008).
• Marketing (promocional): mensagens de divulgação, como carrinho abandonado e newsletter. São muito mais caras, na casa de US$ 0,06 por envio, cerca de oito vezes o valor de uma mensagem de utilidade.

Recomendação: mantenha ativos apenas os avisos transacionais (pedido e rastreio) e deixe desligados os disparos de carrinho abandonado e de newsletter pelo WhatsApp. Assim cada mensagem custa cerca de um centavo, e você usa o canal para informar, não para fazer campanha.

A proposta da integração é justamente essa: avisar o cliente sobre a compra dele, não substituir o e-mail marketing. Os valores acima são uma referência e podem variar conforme a tabela da Meta. Para conferir os preços atuais por categoria e país, consulte a tabela oficial de preços da plataforma WhatsApp Business.

Escolha o número antes de tudo

Antes de qualquer configuração, decida qual número de telefone vai enviar as mensagens. Aqui existe uma regra que não abre exceção: o número precisa ser novo (nunca usado no WhatsApp) ou um número que já esteja 100% na Cloud API.

• Um número novo, exclusivo dos disparos (recomendado): uma linha que ainda não foi usada em nenhum WhatsApp.
• Um número que já é Cloud API: se você já tem uma conta oficial na WhatsApp Cloud API, o número dela serve.

Atenção: um número que está em uso no WhatsApp comum ou no aplicativo WhatsApp Business (aquele instalado no celular) não serve para as mensagens transacionais. Essa conexão entra no chamado modo de coexistência, em que a Meta bloqueia a criação e a atualização dos modelos, e a sincronização falha com o aviso "esta conta não tem permissão para criar ou atualizar modelos". Para reaproveitar um número desses, seria preciso migrá-lo por completo para a Cloud API, o que o desliga do aplicativo no celular.

Recomendação: use um número exclusivo para a integração, separado do WhatsApp de atendimento. Além de evitar o problema de coexistência, se esse número for suspenso você perde apenas o canal de envio automático, nunca o telefone que seus clientes usam para falar com a loja.

Para conseguir um número novo rápido, um caminho prático é contratar uma linha pré-paga, e nesse caso um chip digital (eSIM) costuma agilizar, porque a ativação é feita na hora, sem esperar a entrega de um chip físico. O que importa é que ele receba o código de verificação da Meta por SMS ou ligação. Assim que tiver a linha em mãos, deixe o número reservado só para a integração e não ative o WhatsApp dele no celular, para o número não cair no modo de coexistência e continuar apto a gerenciar os modelos.

Antes de conectar, deixe a conta pronta na Meta

O botão amarelo "Conectar API" só conclui a autorização quando a sua conta na Meta (a empresa dona do WhatsApp) está completa. É comum a loja parar no meio do caminho: cria a conta, adiciona o número e trava porque faltam etapas que a Meta exige. Confira esta lista antes de tentar conectar:

• Número de telefone adicionado: o número que fará os disparos precisa estar cadastrado no Gerenciador do WhatsApp.
• Verificação da empresa iniciada: a Meta pede que o seu negócio seja verificado. Enquanto a empresa aparecer como não verificada, parte dos recursos fica bloqueada.
• Autenticação de dois fatores (2FA) ativada: uma camada de segurança que a Meta exige na conta empresarial.
• Documentos do CNPJ enviados: a Meta confirma a identidade da empresa com documentos oficiais (o cartão CNPJ e o que mais ela solicitar).
• Forma de pagamento cadastrada: sem uma forma de pagamento válida, a Meta limita o envio de mensagens.

Atenção: as cobranças da Meta são feitas em dólar americano. Por isso a forma de pagamento precisa ser um cartão de crédito, que aceita cobrança internacional. Boleto e Pix não atendem nesse caso.

Só depois que todos esses itens estiverem resolvidos é que o botão "Conectar API" consegue avançar. Se ele não concluir, quase sempre falta um desses passos na conta da Meta.

Crie a conta do WhatsApp Business (para número novo)

Se você escolheu um número novo, o passo seguinte é criar a conta que vai abrigá-lo, dentro do Gerenciador de Negócios da Meta. No painel de contas do WhatsApp, abra o botão Adicionar e escolha Crie uma nova conta do WhatsApp Business.

Essa opção cria uma conta já nativa da Cloud API, que é o que libera o gerenciamento dos modelos de mensagem. Evite a opção Vincular uma conta do WhatsApp Business, porque ela reaproveita uma conta que já existe no aplicativo do celular e recai no modo de coexistência, o mesmo que bloqueia os modelos.

O assistente da Meta pede três etapas em sequência:

• Detalhes: o Nome de exibição do WhatsApp Business (o nome que o cliente vê na conversa) e a Categoria da empresa. O nome de exibição precisa condizer com o nome comercial e seguir as diretrizes da Meta, senão a aprovação do número emperra.
• Telefone: você informa o número novo que fará os disparos.
• Verificação do telefone: a Meta envia um código por SMS ou ligação para confirmar o número.

Atenção: o número não pode estar registrado em nenhum WhatsApp no momento da verificação. Se ele já tiver uma conta ativa (comum ou Business), apague essa conta antes de verificar, senão a Meta não conclui o cadastro na Cloud API.

Como conectar

Com a conta da Meta pronta, a conexão acontece na tela da integração, em alguns passos:

• Conectar a API: o botão amarelo "Conectar API" autoriza a Braavo a se comunicar com a sua conta no WhatsApp, pela WhatsApp Cloud API. Ao final, o painel mostra "Token conectado!".
• Ativar: ligue o interruptor da WhatsApp Cloud API.
• Escolher a conta e o número: em Ativos da Conta, selecione a Conta Empresarial (o WABA) e o Número de Telefone que farão os disparos.
• Sincronizar os modelos: o botão Sincronizar Templates instala ou atualiza, na sua conta, os modelos de mensagem que a loja usa.

Atenção: a sincronização dos modelos é feita aos poucos, de forma gradual, de propósito. A Meta limita quantas chamadas aceita em sequência, e o ritmo controlado evita bloqueios por excesso de requisições. Se aparecer um erro no meio, é possível pausar e retomar.

Sobre o botão flutuante do WhatsApp

Esta mesma tela já abrigou o botão flutuante do WhatsApp (aquele ícone fixo na loja que abre uma conversa). Ele foi migrado para a Central de Interações, junto com os Pop-ups, que é o lugar recomendado para configurá-lo hoje. A integração descrita aqui cuida apenas das mensagens transacionais automáticas, que são coisa diferente do botão de contato.