Implantação do WhatsApp API
Introdução
A implantação do WhatsApp API no Opa! Suite é um processo estratégico que transforma o canal de comunicação mais popular do Brasil em uma poderosa ferramenta de atendimento empresarial. Esta integração oficial permite que empresas utilizem o WhatsApp de forma profissional, escalável e em conformidade com as políticas da Meta (Facebook).
A implantação do WhatsApp API possibilita que empresas gerenciem conversas em larga escala, automatizem respostas, integrem múltiplos atendentes e mantenham histórico completo de interações, tudo dentro de uma plataforma centralizada e profissional.
O WhatsApp Business API difere significativamente do WhatsApp Business tradicional, oferecendo recursos avançados como múltiplos usuários simultâneos, integração com sistemas corporativos, automações sofisticadas e capacidade de atendimento ilimitado. A implantação adequada garante que sua empresa aproveite todo o potencial desta ferramenta, mantendo conformidade com as diretrizes da Meta e proporcionando experiência superior aos clientes.
Requisitos de Implantação
Para ativar o WhatsApp API é necessário:
☐ Conta no Facebook: Perfil pessoal (pessoa física) para gerenciar a conta e evitar suspeita de fraude pela Meta
☐ Site funcional: Política comercial visível + SSL ativo + Razão Social e CNPJ no rodapé ou cabeçalho
☐ E-mail comercial: Mesmo domínio do site
☐ Cartão de crédito internacional: Precisa aceitar compras internacionais (ELO e AMEX emitidos no Brasil não são aceitos)
☐ Cartão CNPJ válido: Dados atualizados e corretos para aprovação na verificação da Meta
Conforme é dado andamento no processo de ativação, é preciso ficar ciente dos requisitos a seguir:
☐ Desativação da URA: Se o número usa URA, a ligação de verificação deve ser redirecionada para um único ramal, para garantir o recebimento direto ☐ Exclusão da conta do WhatsApp: Se o número já está ativo no WhatsApp Business, será necessário excluir a conta. A equipe informará o momento certo para isso ☐ Caso o número já esteja em outro provedor de WhatsApp API, será necessária uma Migração de BSP, desta forma, desativar a 2FA do broker para migração.
Acesso ao formulário
Acesso ao formulário
Caminho: Menu (Opa! Store → WhatsApp → Instalar)
Configurando e Implantando o WhatsApp API
Após instalar o WhatsApp, você será direcionado para a configuração inicial. Preencha as informações básicas do canal:
-
Nome: Identificação interna do canal.
-
Agente virtual: Escolha o agente responsável pelo atendimento.
-
Parceiro: Selecione Opa! Suite ou Gupshup como provedor da integração.
Após isso, selecione Continuar.
Conexão com o parceiro
Na próxima etapa, você dará início à conexão com o parceiro Opa! Suite.
-
Faça login com a conta do Facebook Business da sua empresa.
-
Clique em Continuar com o Facebook.
Integração via Gupshup
Se optar pela Gupshup, você criará sua conta diretamente no Broker.
Após isso, preencha:
-
ID do App
-
API Key
Integração via Broker do Opa! Suite
Se escolher o Broker do próprio Opa! Suite, o processo é ainda mais simples:
-
Você seguirá o fluxo de ativação automática.
-
Receberá um código OTP para validar a integração.
-
Os dados principais como nome da conta e número do WhatsApp serão preenchidos automaticamente.
Após concluir a conexão com o parceiro, clique em Continuar.
Finalização da instalação
A conexão será validada automaticamente, trazendo todos os dados necessários.
Ao final, basta selecionar Instalar WhatsApp para concluir a implantação.
Atenção
Nunca remova o Opa! Suite como parceiro da sua conta da Meta caso queira manter seu número ativo.
A remoção do parceiro pode resultar na desativação do seu WhatsApp Business e na interrupção do serviço.
Após a instalação do canal, você será direcionado(a) para a aba de cadastro.
Cadastro
Em Cadastro, estão disponíveis as informações essenciais do canal, organizadas para facilitar sua identificação e gerenciamento.
1. Dados de cadastro
Configure a identificação interna e o comportamento inicial do canal. Nesta seção, você pode editar o Nome do canal (para relatórios e gestão), alterar o Status (Ativo/Inativo) e vincular um Agente Virtual
2. Qualidade da conta
Nesta seção, você monitora a saúde do seu número junto à Meta. Acompanhar estes indicadores é essencial para garantir que suas mensagens continuem sendo entregues sem bloqueios.
| Indicador | Descrição |
|---|---|
| Limite de conversas (Tier) | O número máximo de conversas iniciadas pela empresa que você pode abrir em um período de 24 horas (ex: 1.000, 10.000 ou ilimitado). |
| Conversas (24h) | Contabiliza quantas conversas sua empresa já iniciou nas últimas 24 horas, ajudando a controlar o consumo do seu limite diário. |
| Classificação de qualidade | O status atual da reputação do seu número. Uma classificação baixa pode reduzir seu limite de envio ou bloquear o número. |
3. Preferências
| Campo | Descrição | Exemplo de uso / Recomendação* |
|---|---|---|
| Prioridade dos atendimentos na fila | Define a prioridade do canal no roteamento dos atendimentos. Canais com prioridade mais alta terão suas conversas exibidas ou distribuídas antes daqueles com prioridade inferior. As opções disponíveis são: baixíssima, baixa, média, alta e altíssima. | Configure Média para o canal Instagram e Altíssima para o canal WhatsApp, garantindo que as mensagens do WhatsApp sejam priorizadas na visualização e no atendimento. |
| Menus interativos | Permite definir se o fluxo de comunicação será realizado apenas por texto livre ou por meio de menus interativos, com opções selecionáveis pelo cliente. | Ative quando desejar padronizar respostas e direcionar o cliente por opções predefinidas. |
| Exibir nome do atendente no cabeçalho das mensagens | Determina se o nome do atendente será exibido no topo de cada mensagem para o cliente. Selecione entre ativo (mostrar) ou inativo (ocultar). | Ativo: o cliente visualizará o nome do atendente antes da mensagem, por exemplo: “João Silva: Olá, boa tarde!” Inativo: a mensagem será exibida sem identificação do atendente, por exemplo: “Boa tarde!” |
| Verificar se contato é humano | Quando ativado, o sistema identifica se a interação está sendo conduzida por um usuário humano ou por um processo automatizado, adequando o fluxo de atendimento conforme necessário.. | Ativo: evita que sistemas automatizados externos iniciem atendimentos indevidos ou ocupem a fila de forma desnecessária. |
| Avisar posição na fila | Quando ativado, envia automaticamente ao cliente uma mensagem informando sua posição na fila de espera. É possível personalizar o texto e definir o intervalo de envio do aviso. | Permite inserir variáveis dinâmicas na mensagem (Nome da empresa, Posição na fila e Protocolo), que serão automaticamente substituídas no envio, além de configurar o intervalo de repetição do aviso, em minutos. |
Modelos de mensagem
Nesta seção, é possível gerenciar o ciclo de vida dos seus modelos de mensagem. Além de criar e editar modelos, o sistema oferece ferramentas para rastreabilidade (auditoria) e atualização de dados junto à Meta.
| Campo | Descrição |
|---|---|
| Auditar | Permite visualizar o registro de alterações feitas nos modelos de mensagem, garantindo controle e rastreabilidade das mudanças. |
| Sincronizar | Atualiza a lista de modelos conectando-se diretamente à Meta. Utilize esta opção para importar modelos criados no Gerenciador de Negócios (BM) que ainda não aparecem aqui. |
| Adicionar novo | Inicia a criação de um novo modelo de mensagem para ser submetido à aprovação. |
Nota
Para saber mais sobre os modelos de mensagem, acesse: Modelos de mensagens
Limites de envio
A Meta realiza o controle de limites de envio de modelos de mensagem com base em níveis de confiança e engajamento da conta de negócio. Esses limites determinam quantos modelos de mensagem podem ser enviados a contatos únicos dentro de um período de 24 horas.
Os limites definidos pela Meta são:
-
Nível 1: 250 mensagens / 24h
-
Nível 2: 2.000 mensagens / 24h
-
Nível 3: 10.000 mensagens / 24h
-
Nível 4: 100.000 mensagens / 24h
-
Nível 5: Ilimitado
Nova rota para envio de modelos de mensagem:
Atualização importante: A Meta atualizou a API para modelos de mensagem no WhatsApp. Agora, através do Broker Opa! Suite, você pode escolher como enviar suas mensagens promocionais:
- Entrega imediata: Mensagens enviadas no momento do disparo.
- Entrega otimizada: Mensagens entregues em horários considerados mais eficazes pela Meta.
Nota: Esta escolha está disponível apenas para usuários do broker do Opa!. Usuários de outros brokers, como 360 Dialog, continuarão com o método tradicional de envio.
Perfil
A seção de Perfil é onde você define a identidade pública da sua empresa no WhatsApp. Todas as informações inseridas nesta tela serão exibidas para o seu cliente quando ele clicar no nome do seu contato ou visualizar o perfil empresarial.
1. Informações da Empresa
No lado esquerdo da tela, você encontra os campos de cadastro. Para modificar qualquer dado, clique no botão “Editar informações”.
| Campo | O que preencher |
|---|---|
| Área de atuação | O segmento do seu negócio (ex: Finanças, Varejo, Outros). |
| Descrição | Um texto curto sobre o que sua empresa faz ou seus valores. |
| Endereço | O endereço físico da sua sede ou filial. |
| E-mail de contato comercial. | |
| Website | Seu site principal. |
| Website secundário | Um segundo link (ex: Linktree, Blog ou Loja). |
| Recado | A frase de status visualizada no perfil . |
2. Pré-visualização Após editar alguma informação e salvar, o painel Pré-visualização à direita mostra, em tempo real, exatamente como o perfil aparecerá na tela do celular do seu cliente.
-
Identidade Visual: Exibe sua logo (foto de perfil), Nome de Exibição e o número oficial.
-
Links Coloridos: Note que e-mails e sites ficam verdes (ativos), indicando que são clicáveis para o cliente.
Ações adicionais (Menu superior)
No canto superior direito, você encontra ferramentas de gerenciamento da conta:
-
Migrar Informações: Utilizado para migração de canal de uma base para outra.
-
Baixar logs: Gera um arquivo técnico de histórico (útil para suporte).
-
Compartilhar: Gera um link ou QR Code do seu contato. Para saber mais, acesse: Compartilhamento do WhatsApp
-
Desinstalar App: Remove a integração do app.
Considerações Finais
A implantação do WhatsApp API requer atenção aos detalhes e cumprimento dos requisitos estabelecidos pela Meta. É fundamental manter todas as informações atualizadas e seguir cuidadosamente cada etapa do processo para garantir uma integração bem-sucedida e aproveitar ao máximo as funcionalidades oferecidas pela plataforma.
Etiquetas
WhatsAppAPI Implantacao ComunicacaoEmpresarial