Instalar o WhatsApp API no Opa! Suite
Primeiro canal: Opa! Store → WhatsApp → Instalar novo Outros canais: Opa! Store → WhatsApp → Acessar → Instalar novo
Visão geral
O app do WhatsApp API permite que você conecte o número de WhatsApp da empresa ao Opa! Suite pela integração oficial da Meta. Assim, a equipe atende várias conversas ao mesmo tempo pelo mesmo número, com agente virtual, fluxo de comunicação, modelos de mensagem e envio em massa.
A instalação padrão é pelo Broker Opa! Suite, o parceiro do próprio Opa! Suite: a conexão é feita com login no Facebook e libera recursos como ligações e bloqueio de contatos. Veja Pelo Broker Opa! Suite.
Os parceiros Gupshup e 360 Dialog só aparecem para empresas que já têm licença deles. Veja Pela Gupshup ou pela 360 Dialog.
Pré-requisitos
No Opa! Suite
- Licença do app WhatsApp contratada. Sem licença disponível, aparece o botão Obter, que leva ao contato com a equipe comercial.
- Permissão para visualizar o Opa! Store no seu grupo de permissões.
- Agente virtual criado, se o canal for usar um. Na instalação, o campo é opcional.
Na Meta
- Perfil pessoal do Facebook de uma pessoa da empresa, com acesso ao portfólio empresarial da Meta (antigo Gerenciador de Negócios). Use um perfil real, para evitar suspeita de fraude pela Meta.
- Site da empresa seguro (HTTPS), com razão social e CNPJ visíveis no rodapé ou no cabeçalho.
- E-mail comercial com o mesmo domínio do site.
- Recomendado: portfólio empresarial verificado. Veja Verificar a empresa no portfólio empresarial da Meta.
O número de telefone
- Precisa receber SMS ou ligação com o código de confirmação da Meta. Se o número tiver URA, direcione a ligação para um único ramal durante a ativação. Veja Receber o código de verificação do WhatsApp por ligação na telefonia Opa! Suite.
- Não pode estar ativo em outro lugar. Se estiver:
- no aplicativo WhatsApp ou WhatsApp Business do celular: apague a conta do aplicativo no momento combinado com a equipe do Opa! Suite. Veja Apagar a conta do WhatsApp no celular para liberar o número;
- no WhatsApp API com outro parceiro: desative a confirmação em duas etapas e faça a migração. Veja Desativar a confirmação em duas etapas do número e Migrar o número de WhatsApp para o Broker Opa! Suite.
Pagamento das mensagens
- A Meta cobra pelas mensagens enviadas. No Broker Opa! Suite, o pagamento é feito com cartão de crédito internacional cadastrado na Meta. Na Gupshup, o saldo fica no parceiro; na 360 Dialog, depende do Tipo de pagamento escolhido: Direto para o parceiro ou Intermediado. Veja Preços das mensagens do WhatsApp API.
Passo a passo
Pelo Broker Opa! Suite
- Acesse Opa! Store e clique em WhatsApp.
- Clique em Instalar novo. Se já houver um canal instalado, clique antes em Acessar e, na lista, em Instalar novo. A janela Instalar Whatsapp abre.
- Na etapa Informações de identificação, preencha:
- Nome: nome do canal dentro do Opa! Suite (obrigatório).
- Agente virtual: agente virtual que vai receber as conversas deste canal (opcional).
- Parceiro: selecione Opa! Suite.
- Clique em Continuar.
- Na etapa Conexão com o Parceiro, clique em Continue com o Facebook. Uma janela da Meta abre.
- Na janela da Meta, entre com o perfil do Facebook e siga as etapas: escolha ou crie o portfólio empresarial, a conta do WhatsApp e o número.
- Digite o código que a Meta enviar por SMS ou ligação para confirmar o número.
- Quando a janela da Meta fechar, confira na área Selecione qual conta deseja conectar:
- Conta: a conta do WhatsApp na Meta.
- Números: o número que será usado neste canal.
- Clique em Instalar app.
Se precisar entrar com outro perfil do Facebook ou escolher outro número antes de instalar, clique em Editar Conexão, que substitui o botão Continue com o Facebook depois do primeiro login.
Nunca remova o "Opa! Suite" como parceiro na sua conta da Meta. Isso desconecta o número do Opa! Suite.
Pela Gupshup ou pela 360 Dialog
Só para empresas que já têm licença de um desses parceiros. Para canais novos, use o Broker Opa! Suite.
- Acesse Opa! Store e clique em WhatsApp.
- Clique em Instalar novo (ou em Acessar e depois em Instalar novo, se já houver canal).
- Na etapa Informações de identificação, preencha Nome e, se quiser, Agente virtual.
- Em Parceiro, selecione Gupshup ou 360 Dialog.
- Clique em Continuar.
- Se ainda não tiver conta no parceiro, clique em Criar uma conta GupShup ou Criar uma conta 360Dialog e conclua o cadastro no site do parceiro.
- Em Já tem uma conta?, preencha os dados do canal:
- Gupshup: ID do app e Api Key.
- 360 Dialog: Channel ID, WABA account ID e Webhook; em Tipo de pagamento, Direto para o parceiro ou Intermediado; em Moeda de cobrança, Dólar ($) ou Euro (€). No pagamento intermediado, a moeda não pode ser alterada.
- Clique em Instalar app.
Desinstalar o canal
- Acesse Opa! Store → WhatsApp → Acessar e clique no canal.
- No topo da tela, clique em Desinstalar App.
- Na janela Desinstalar WhatsApp, digite o nome do canal exatamente como está cadastrado.
- Clique em Desinstalar. O botão só é liberado quando o nome confere.
A conexão com o canal é desfeita. Atendimentos em andamento são interrompidos, e atendimentos encerrados perdem o vínculo com o canal, o que pode afetar as métricas.
Resultado esperado
Ao clicar em Instalar app, o Opa! Suite abre o canal criado na aba Cadastro. A partir daí, as mensagens enviadas ao número chegam ao Opa! Suite e seguem o agente virtual e o fluxo de comunicação configurados.
O canal também aparece em Opa! Store → WhatsApp → Acessar, na lista com as colunas Nome, Número, Status, Parceiro, Agente Virtual e Fluxo de Comunicação.
Configurações disponíveis
Para ajustar o canal, acesse Opa! Store → WhatsApp → Acessar e clique nele. As abas Modelos de mensagem, Perfil e Ligações só ficam disponíveis com o canal Ativo. Em cada seção, clique em Editar informações para alterar e salvar.
Aba Cadastro
Dados de cadastro
| Campo | O que faz |
|---|---|
| Nome | Nome de identificação do canal. |
| Status | Ativo ou Inativo. |
| Agente virtual | Agente virtual responsável pelo canal. |
| Parceiro, Conta e Número do WhatsApp | Dados da conexão feita na instalação. Só para consulta. |
Qualidade da conta
| Campo | O que mostra |
|---|---|
| Limite de conversas iniciadas pela empresa | Quantos modelos de mensagem o canal pode enviar fora da janela de 24 horas por dia: 2 Mil, 10 Mil ou 100 Mil. Quando a Meta informa o limite do número, vale o limite da Meta. |
| Conversas iniciadas nas últimas 24h | Quantos modelos de mensagem foram enviados fora da janela de 24 horas. |
| Classificação de qualidade | Qualidade do número informada pela Meta. Uma qualidade baixa pode reduzir o limite ou restringir o número. |
O Opa! Suite conta os envios do dia, da 0h às 23h59. Quando o limite acaba, o envio em massa mostra o aviso "Este canal de comunicação atingiu o limite diário de mensagens!". As regras da Meta estão na documentação de limites de mensagens.
Informações de pagamento (só Gupshup e 360 Dialog)
Mostra o saldo e permite ativar Notificar saldo abaixo do esperado, com Saldo mínimo para notificar e Usuários que devem ser notificados. Na 360 Dialog, a seção também mostra Tipo de pagamento e Moeda de cobrança, e o aviso de saldo só existe no pagamento Direto para o parceiro. Veja Inserir saldo no hub da 360Dialog.
Preferências
| Campo | O que faz |
|---|---|
| Prioridade dos atendimentos na fila | Prioridade deste canal na distribuição: Altíssima, Alta, Média, Baixa ou Baixíssima. Atendimentos de canais com prioridade maior são apresentados primeiro. |
| Menus interativos | O fluxo de comunicação envia as opções como botões e listas do WhatsApp, em vez de texto. Veja Menus interativos no WhatsApp. |
| Exibir nome do atendente no cabeçalho das mensagens | O cliente vê o nome do atendente no topo das mensagens. |
| Verificar se contato é humano | Confirma que quem escreve é uma pessoa antes de abrir o atendimento. |
Com Verificar se contato é humano ativo, o agente virtual pergunta "Você é humano?" antes de abrir o primeiro atendimento do contato, com as opções Sim e Não em ordem aleatória. O atendimento só é aberto se a pessoa responder Sim. Depois disso, a pergunta não se repete para esse contato. Se a resposta for Não, nenhum atendimento é aberto e a pergunta volta na próxima mensagem.
O aviso de posição na fila não fica no canal: ele é configurado na fila do departamento. Veja Departamentos.
Aba Modelos de mensagem
Lista os modelos de mensagem do número, com os botões:
- Auditar (ícone): histórico de criação, edição e exclusão dos modelos.
- Sincronizar: traz da Meta os modelos que ainda não aparecem no Opa! Suite, como os criados no Gerenciador do WhatsApp.
- Adicionar novo: cria um modelo e envia para análise da Meta. Veja Criação de modelos de mensagem do WhatsApp.
Aba Perfil
Define como a empresa aparece para os clientes no WhatsApp:
- Nome de usuário: cria, edita ou exclui o @ da empresa (só no Broker Opa! Suite). Veja Nomes de usuário no WhatsApp.
- Informações da empresa: Foto de perfil, Área de atuação, Descrição, Endereço, E-mail, Website, Website secundário e Recado.
- Pré-visualização: mostra como o perfil aparece no celular do cliente.
Aba Ligações
Configura as chamadas de voz pelo WhatsApp (só no Broker Opa! Suite). Veja Fazer e receber ligações pelo WhatsApp.
Botões no topo da tela
| Botão | O que faz |
|---|---|
| Baixar logs | Baixa uma planilha com o histórico técnico do canal. Útil quando o suporte pedir. |
| Compartilhar | Gera o link e o QR Code do número. Veja Compartilhar o link e o QR Code do WhatsApp. |
| Desinstalar App | Remove o canal. Veja Desinstalar o canal. |
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| O parceiro aparece desativado em Parceiro | Não há licença disponível para aquele parceiro. Fale com a equipe comercial. |
| O código de confirmação não chega | Confira se o número recebe SMS ou ligação, se a URA está direcionada a um único ramal e se a conta do aplicativo WhatsApp já foi apagada. |
| O número está em outro parceiro e não ativa | Desative a confirmação em duas etapas. Veja Desativar a confirmação em duas etapas do número. |
| As abas Modelos de mensagem, Perfil e Ligações estão bloqueadas | O canal está Inativo. Altere o Status em Dados de cadastro. |
Boas práticas
- Use um Nome que identifique o número (ex.: "WhatsApp - Financeiro"), principalmente se a empresa tiver mais de um.
- Complete a aba Perfil: foto, descrição, endereço e site passam confiança ao cliente.
- Acompanhe a Classificação de qualidade e siga as Políticas de uso do WhatsApp Business.