Integração com WhatsApp Business Oficial (Meta)
Nesse artigo vamos ver o passo a passo de como integrar o WhatsApp Business Oficial da Meta com seu sistema Conexa.
Essa é uma integração direta com a Meta, sem necessidade de disparadores ou aplicativos intermediários. O envio das mensagens é feito pelo número oficial da sua empresa, e o pagamento pelo serviço é feito diretamente com a Meta, sem custo adicional no Conexa.
Esse formato de conexão funciona em modo de coexistência: o número continua funcionando normalmente no aplicativo WhatsApp Business do celular, ao mesmo tempo em que fica disponível para o envio automático de mensagens pelo Conexa. Você pode seguir conversando manualmente pelo celular sem perder essa função.
Antes de começar
Para conectar, você vai precisar:
Um número de telefone com o aplicativo WhatsApp Business já instalado e ativo no celular (pode ser um número novo ou um que você já usa).
Acesso ao portfólio empresarial da sua empresa na Meta (Meta Business Suite).
Etapa na Meta
Antes de conectar pelo Conexa, o número de telefone precisa estar vinculado a uma conta do WhatsApp Business dentro do portfólio empresarial da sua empresa na Meta, e a conta precisa ter uma forma de pagamento cadastrada. Se isso já estiver feito, você pode pular direto para a etapa no Conexa.
Vincular o número
1️⃣ Acesse business.facebook.com, vá em Configurações > Contas > Contas do WhatsApp e clique em Adicionar.
2️⃣ Selecione a opção Vincular uma conta do WhatsApp Business e informe o número de telefone que será usado (com o "55" antes do DDD).
3️⃣ A Meta envia um código de verificação diretamente para o aplicativo do WhatsApp Business daquele número (não é SMS). Insira o código na tela de verificação e clique em Continuar.
Cadastrar forma de pagamento
Com o número já vinculado, cadastre um cartão de crédito como forma de pagamento na conta de WhatsApp da Meta. Sem isso, o envio das mensagens não funciona.
Ainda nas Configurações do WhatsApp, selecione o número cadastrado e clique em Configurações de Pagamento e adicione um cartão de crédito para o pagamento das mensagens enviadas pela Meta. É possível consultar os preços diretamente com a Meta.
Com o número vinculado e a forma de pagamento cadastrada, siga para a etapa no Conexa.
Etapa no Conexa
1️⃣ Chegando na tela certa. Navegue até Configurações > Integrações > Webhooks.
2️⃣ Crie uma nova conexão. Clique em Nova Conexão > WhatsApp (Oficial).
3️⃣ Conecte com a Meta. Selecione uma Unidade ou Todas, a seguir clique em Conectar com a Meta. Isso vai abrir uma janela da própria Meta. Clique em Continuar.
4️⃣ Selecione como conectar o número. Escolha a opção de conectar um app do WhatsApp Business
5️⃣ Cadastre o número. Informe o número de telefone que enviará as mensagens (com o "55" antes do DDD) e avance. Escolha também o nome de exibição que aparecerá para os seus clientes no WhatsApp.
6️⃣ Verifique o número. A Meta envia uma mensagem com um link para abrir a câmera e escaner o QRCode que aparece na tela abaixo.
7️⃣ Confirme o fuso horário. Selecione o fuso horário do Brasil e avance.
8️⃣ Conclua a autenticação. Ao final, a Meta confirma que a conta foi conectada à plataforma Conexa. Clique em concluir e volte para a tela do Conexa.
Configurando a automação (webhook)
Com a conexão feita, é hora de criar a automação que vai disparar as mensagens.
1️⃣ Dê um nome descritivo para a conexão, relacionado ao evento que vai disparar a mensagem. Por exemplo: "Boas-vindas ao cliente" ou "Aviso de geração de cobrança".
2️⃣ Em "Evento", escolha o gatilho da automação. Exemplos: cadastro de cliente, geração de cobrança, vencimento de cobrança.
3️⃣ Escreva a mensagem do template. Você pode usar parâmetros como o nome do cliente, que serão preenchidos automaticamente pelo Conexa no momento do envio.
Sobre os templates de mensagem da Meta
Toda mensagem enviada pela API oficial da Meta precisa passar por um template pré-aprovado. Isso é diferente de outras integrações de WhatsApp, onde a mensagem é enviada livremente.
Quando você cria uma automação no Conexa, um template é criado automaticamente junto à Meta e enviado para aprovação. Esse processo pode levar até 24 horas. Enquanto o template estiver pendente, as mensagens daquele evento não serão enviadas.
Não edite o template diretamente na Meta. O Conexa é quem gerencia os templates criados a partir das suas automações. Qualquer alteração na mensagem deve ser feita editando a conexão no Conexa, não pelo gerenciador da Meta.
Classificação do template (marketing x utilidade)
Dependendo de como a mensagem é escrita, a Meta pode classificar o template como marketing em vez de utilidade. Templates de marketing têm restrições adicionais de envio e custo diferente.
Você pode conferir como um template foi classificado acessando o Gerenciador do WhatsApp > dentro da Meta Business Suite, na seção de templates de mensagem.
Acompanhando as requisições
Em Configurações > Integrações > Webhooks > Relatórios, é possível ver o relatório de requisições feitas para a Meta.
Importante: esse relatório mostra que a requisição foi enviada para a Meta, mas não confirma se a mensagem foi efetivamente entregue ao cliente. Para isso, é necessário consultar o Gerenciador do WhatsApp > Ferramentas da Conta > Insights; dentro da Meta.









