Conexão com o WhatsApp
Como conectar seu WhatsApp à NexaOmni (oficial ou via QR Code), boas práticas para evitar bloqueios e como fazer ligações pelo WhatsApp.
Perguntas frequentes: conexão e ligações no WhatsApp
Reunimos as dúvidas mais comuns sobre conexão, bloqueios e ligações no WhatsApp. Para os guias completos, veja os outros artigos desta categoria. Qual a diferença entre o WhatsApp Oficial (Meta) e a conexão via QR Code? No WhatsApp Oficial (Cloud API da Meta) a integração é feita pelo caminho oficial, pensado para empresas: mais estável, previsível e com risco de bloqueio muito baixo — ideal quando o WhatsApp é canal crítico e você precisa de volume, selo verificado e campanhas por templates. A conexão via QR Code funciona como o WhatsApp Web: ativa na hora, ótima para começar rápido e usar um número que seus clientes já conhecem, com bom desempenho em volume moderado quando você segue as boas práticas. A conexão via QR Code pode bloquear meu número? Como evitar? Existe risco, mas ele vem muito mais da forma de uso do que da plataforma. A maioria dos bloqueios acontece por disparo em massa, mensagens não solicitadas e denúncias de usuários. Para evitar: use um número com histórico, complete o perfil, faça um aquecimento gradual nos primeiros dias, personalize as mensagens, envie só para quem optou e mantenha mais conversa do que disparo. Veja o guia completo em Boas práticas da Conexão via QR Code. Dá para fazer e receber ligações pelo WhatsApp na NexaOmni? Sim. Você faz e recebe ligações de voz pelo WhatsApp dentro da própria plataforma, sem apps externos — tanto na conexão Oficial quanto via QR Code. As chamadas ficam atribuídas ao atendente que ligou, podem ser gravadas e ficam registradas no histórico (feitas, recebidas, perdidas e não atendidas). Preciso de aprovação da Meta para usar o WhatsApp Oficial? O WhatsApp Oficial passa por um cadastro junto à Meta (WhatsApp Cloud API), e o tempo de ativação depende dessa aprovação — nosso time guia você em cada passo. Se a ideia é começar hoje mesmo, a conexão via QR Code sobe imediatamente, sem esperar aprovação. Posso começar pela conexão via QR Code e migrar para o Oficial depois? Pode. Muitos clientes começam pelo QR Code para validar rápido e migram para o Oficial quando o WhatsApp vira canal central. Veja o guia Migrar o WhatsApp Oficial para configuração manual — o time acompanha o processo para preservar suas conversas e configurações. Vários atendentes podem usar o mesmo número de WhatsApp? Sim. Nas duas conexões, o mesmo número é atendido por vários agentes com distribuição organizada, histórico compartilhado e continuidade entre turnos — sem depender de um único celular. Ainda com dúvida? Fale com a nossa equipe.
WhatsApp Oficial × Conexão via QR Code: qual escolher
Duas formas de conectar seu WhatsApp Na NexaOmni você pode conectar o WhatsApp de duas maneiras: pela API Oficial do WhatsApp (Meta) ou pela Conexão via QR Code. As duas funcionam dentro da plataforma, com atendimento em equipe, IA, Kanban e relatórios. A diferença está em como a conexão é feita e no nível de estabilidade e previsibilidade de cada uma. Comparativo rápido | Critério | API Oficial (Meta) | Conexão via QR Code | | --- | --- | --- | | Como conecta | Cadastro oficial junto à Meta | Leitura de QR Code, como no WhatsApp Web | | Estabilidade | Alta — feita para uso empresarial | Boa, mas depende de uma sessão ativa | | Risco de bloqueio | Muito baixo (dentro das regras da Meta) | Existe — exige boas práticas para evitar | | Tempo para ativar | Depende de aprovação da Meta | Imediato | | Selo verificado | Possível solicitar | Não disponível | | Envio de campanhas | Via templates aprovados pela Meta | Livre, mas com limites de bom senso | | Ligações por WhatsApp | Sim | Sim | Quando escolher a API Oficial É a opção mais indicada quando o WhatsApp é um canal crítico do negócio e você precisa de estabilidade e previsibilidade: - Operações com vários atendentes no mesmo número; - Volume de conversas crescente ou sazonal; - Envio recorrente de campanhas e notificações; - Necessidade do selo de conta verificada. Quando a Conexão via QR Code faz sentido É uma forma rápida de começar e atende bem quem quer subir a operação no mesmo dia, sem esperar aprovação da Meta: - Você quer testar a plataforma imediatamente; - Prefere usar um número que já conversa com seus clientes hoje; - Seu volume é moderado e você segue as boas práticas de uso. Importante: a Conexão via QR Code depende de uma sessão ativa e tem risco de bloqueio se o número for usado de forma abusiva. Antes de escalar, leia o artigo Boas práticas da Conexão via QR Code para proteger seu número. A recomendação da NexaOmni Para operações que querem crescer com segurança, recomendamos a API Oficial. A Conexão via QR Code é excelente para começar rápido e validar — e, seguindo as boas práticas, funciona muito bem em operações de volume moderado. Você pode começar pelo QR Code e migrar para a oficial quando o canal virar peça central do negócio. Ficou em dúvida sobre qual usar no seu caso? Fale com a nossa equipe que ajudamos você a decidir.
Boas práticas da Conexão via QR Code (como evitar bloqueios)
Por que um número pode ser bloqueado Na Conexão via QR Code, o seu número usa uma sessão parecida com a do WhatsApp Web. O WhatsApp monitora comportamento e, principalmente, denúncias de usuários. A maioria dos bloqueios não acontece por causa da plataforma que você usa, e sim pela forma como o número é usado: disparos em massa, mensagens não solicitadas e comportamento que parece de robô. As práticas abaixo reduzem muito esse risco. Antes de conectar: prepare o número - Use um número com histórico. Chips novos, comprados na hora e sem conversas reais são os que mais bloqueiam. Prefira um número que já troca mensagens com clientes. - Complete o perfil. Foto, nome da empresa e descrição. Um perfil completo passa confiança e parece o que é: uma empresa de verdade. - Tenha um número reserva. Deixe um segundo número preparado, caso precise trocar sem parar o atendimento. Primeiros dias: aquecimento Não saia disparando no primeiro dia. Comece devagar e aumente o volume gradualmente ao longo das primeiras 1 a 2 semanas. - Comece respondendo conversas recebidas e enviando poucas mensagens por dia; - Aumente o volume aos poucos, um pouco a cada dia; - Mantenha uma proporção saudável entre mensagens recebidas e enviadas — um número que só dispara e quase não recebe respostas chama atenção. No dia a dia | ✅ Faça | ❌ Evite | | --- | --- | | Enviar só para quem pediu ou já é seu cliente | Comprar listas ou enviar para desconhecidos | | Personalizar e variar o texto das mensagens | Disparar a mesma mensagem idêntica para centenas de pessoas | | Responder rápido quem te chama | Enviar muitas mensagens para quem nunca respondeu | | Respeitar horário comercial | Disparos em massa de madrugada | | Dar uma opção clara de sair da lista | Insistir com quem pediu para parar | | Usar links próprios e confiáveis | Encurtadores e links suspeitos em massa | Mantenha a conexão estável - Deixe o aparelho conectado com internet estável e bateria carregada; - Evite deslogar e reconectar o tempo todo; - Não use o mesmo número simultaneamente em várias ferramentas não oficiais. Sinais de alerta Fique atento se perceber: aumento de denúncias, clientes dizendo que não recebem suas mensagens, ou quedas frequentes da sessão. São sinais de que é hora de reduzir o volume e revisar suas práticas. Checklist rápido - Número com histórico e perfil completo; - Volume crescendo aos poucos, sem picos; - Mensagens personalizadas, só para quem optou; - Mais conversa, menos disparo; - Número reserva pronto. Vai escalar o volume? Se o WhatsApp virou canal central e você precisa de campanhas em grande escala com previsibilidade, o caminho é a API Oficial. Fale com a nossa equipe para migrar com segurança.
Ligações por WhatsApp (oficial e via QR Code)
Ligações por WhatsApp, dentro da plataforma Na NexaOmni você faz e recebe ligações de voz pelo WhatsApp sem sair da conversa e sem apps externos. A chamada acontece no mesmo lugar onde você atende por mensagem — com histórico, atribuição ao atendente e gravação. Funciona tanto na conexão via API Oficial quanto na Conexão via QR Code. Como funciona em cada conexão | Recurso | API Oficial (Meta) | Conexão via QR Code | | --- | --- | --- | | Fazer e receber ligações de voz | Sim | Sim | | Ligar mesmo sem conversa aberta | Sim, com permissão de chamada | Sim | | Permissão/consentimento do cliente | Segue as regras da Meta (templates de permissão) | Boa prática recomendada | | Chamada atribuída ao atendente | Sim | Sim | | Gravação e histórico | Sim | Sim | Como fazer uma ligação 1. Abra a conversa do contato que você quer chamar; 2. Clique no ícone de ligação no topo da conversa; 3. Fale normalmente — a chamada fica registrada na conversa quando encerra. Recursos das ligações - Atribuição ao atendente: cada ligação de saída fica registrada no nome de quem ligou; - Gravação: as chamadas podem ser gravadas para qualidade e prova; - Histórico e relatórios: chamadas feitas, recebidas, perdidas e não atendidas ficam registradas para acompanhamento; - Tudo em um lugar: a ligação vive na mesma linha do tempo das mensagens do cliente. Boas práticas de ligação - Prefira ligar para quem espera seu contato ou já está conversando com você; - Respeite horário comercial; - Evite ligações em massa para números que nunca interagiram — isso aumenta denúncias e risco de bloqueio (especialmente na Conexão via QR Code); - Na API Oficial, use os fluxos de permissão de chamada da Meta quando aplicável. Dica: combine ligação e mensagem. Um áudio ou mensagem antes da chamada aumenta a taxa de atendimento e reduz a sensação de ligação indesejada. Quer ativar ligações na sua conta? Fale com a nossa equipe.
Migrar o WhatsApp Oficial para configuração manual (guia técnico)
Sobre este guia Este guia mostra como migrar uma caixa de entrada do WhatsApp conectada por cadastro incorporado (embedded signup) para a configuração manual da API do WhatsApp Cloud. A migração preserva a caixa existente — conversas, contatos, colaboradores, regras de distribuição, horário de atendimento, CSAT e configurações de bot continuam intactos. Antes de começar (Coexistência): se o seu número também é usado no aplicativo WhatsApp Business, fale com o nosso suporte antes de iniciar — números com Coexistência ainda estão em avaliação. Pré-requisitos Reúna estes três dados da API do WhatsApp Cloud na Meta: - ID da Conta do WhatsApp Business (WABA ID) — a conta dona do número; - ID do número de telefone (Phone Number ID) — identificador único do seu número na Meta; - Token de acesso permanente — token de usuário do sistema (system user) com permissões do WhatsApp. Etapa 1 — Obter os dados na Meta 1. Acesse o Meta for Developers e crie ou selecione um app, escolhendo o caso de uso "Connect with customers through WhatsApp"; 2. Selecione o portfólio de negócios dono da Conta do WhatsApp Business e finalize com "Create app"; 3. Abra Use cases → Connect with customers through WhatsApp → Customize → API Setup (em apps antigos: WhatsApp → API setup); 4. Em "Send and receive messages", escolha um número existente ou clique em "Add phone number" (para número novo: nome de exibição, dados da empresa, verificação por SMS/ligação e código OTP); 5. Copie o Phone Number ID e o WABA ID — costumam aparecer perto do número no campo "From". Etapa 2 — Gerar o token permanente 1. Abra o Meta Business Settings e selecione o portfólio dono da Conta do WhatsApp Business; 2. Vá em Users → System users e selecione (ou crie, função Admin) um usuário do sistema; 3. Clique em "Generate token", escolha o app da Etapa 1 e defina a expiração como "Never"; 4. Marque as permissões whatsapp_business_messaging, whatsapp_business_management e whatsapp_business_manage_events, gere e copie o token. Mantenha o token em segredo. Qualquer pessoa com acesso a ele pode usar a sua conexão. Não compartilhe e não salve em repositórios. Etapa 3 — Migrar na plataforma 1. Na sua conta NexaOmni, vá em Configurações → Caixas de entrada e abra a caixa do WhatsApp conectada por cadastro incorporado; 2. Clique em "Iniciar migração manual" para abrir o assistente; 3. Passo 1: revise o que é preservado (conversas, contatos, colaboradores, regras, horário, configurações) e o que é atualizado (WABA ID, Phone Number ID, token, webhook); 4. Passo 2: informe WABA ID, Phone Number ID e o número exibido; 5. Passo 3: cole o token de acesso permanente (com as três permissões acima); 6. Passo 4: revise e clique em "Reconectar caixa de entrada do WhatsApp". As credenciais são verificadas junto à Meta antes de aplicar — se falhar, a configuração atual permanece intacta. Depois da migração A caixa continua a mesma; só a conexão passa a usar a configuração manual da API. Confirme que estão funcionando: recebimento de mensagens, envio de respostas, envio e sincronização de templates e entrega de webhooks. Ficou com dúvida em alguma etapa? Fale com o nosso suporte.