Como conectar seu WhatsApp ao Deskito (guia completo)
Tutorial extremamente detalhado: pré-requisitos, passo a passo, precauções críticas e troubleshooting da integração WhatsApp.
1. Visão geral da integração
O Deskito integra o WhatsApp através da plataforma Nexxa One, que se conecta à API oficial da Meta (WhatsApp Business Platform). Isso significa que suas mensagens trafegam por uma infraestrutura estável, autorizada pela Meta e preparada para volume comercial — sem depender do app instalado no seu celular.
Existem três tipos de WhatsApp no mercado, e é importante entender a diferença antes de integrar:
📱 WhatsApp Pessoal — App comum, uso individual, NÃO suportado. 💼 WhatsApp Business App — App grátis para pequenos negócios, com etiquetas e respostas rápidas. Funciona só no celular. ☁️ WhatsApp Business API (Cloud API) — Solução oficial Meta para empresas. É o que o Deskito usa via Nexxa.
Por que usar via Deskito? Você ganha multi-atendimento (vários operadores no mesmo número), automações, integração com CRM, KITO AI, templates aprovados pela Meta e histórico unificado — tudo o que o Business App sozinho não entrega.
2. Antes de começar — Checklist obrigatório
Confira se você tem tudo em mãos antes de iniciar a conexão. Pular qualquer item pode bloquear o processo no meio.
Plano Professional ou Business ativo no Deskito (o plano Grátis não inclui WhatsApp).
Módulo WhatsApp contratado — adicional de R$ 59,90/mês cobrado junto com sua assinatura.
Acesso de Owner (proprietário) no workspace. Apenas o dono pode iniciar a integração.
Um número de telefone EXCLUSIVO para o Deskito. Recomendamos um chip novo ou um número que não esteja sendo usado em nenhum WhatsApp ativo.
Para usar número próprio com API Meta: Conta Meta Business verificada (Business Manager) e acesso administrativo a ela.
Se o número escolhido já está logado em um WhatsApp Pessoal ou Business App, você precisa fazer logout completo dele ANTES de conectar ao Deskito. Caso contrário, a integração falha ou é desconectada minutos depois.
3. Escolha do tipo de número
O Deskito oferece duas formas de conectar. A escolha impacta custo, agilidade e portabilidade.
🟢 Número Virtual Nexxa • Ativação imediata (poucos minutos) • Sem necessidade de chip ou celular • Ideal para quem está começando do zero • Número fica vinculado ao Deskito enquanto o módulo estiver ativo 🔵 Número Próprio (Meta API) • Usa um número que já é seu • Mantém histórico de marca / contatos sabem o número • Exige Meta Business verificado • Processo de verificação demora de 10 min a 24h
Para agências: comece com número virtual para validar o fluxo, e depois migre para número próprio quando a operação estiver madura.
Para freelancers: número virtual é o caminho mais rápido. Você separa 100% o pessoal do profissional sem comprar chip novo.
Migrando de WhatsApp Business App? Antes de conectar, faça backup das suas conversas (elas NÃO migram para a API), avise seus clientes principais e desinstale o app oficial do número que será migrado.
4. Passo a passo detalhado da conexão
Acesse o menu lateral e vá em Configurações → Integrações → WhatsApp.
Clique em "Ativar integração". Leia atentamente os termos de uso e a política de cobrança adicional, depois aceite.
Confirme a contratação do módulo (R$ 59,90/mês). A cobrança será adicionada à próxima fatura.
Aguarde alguns segundos enquanto sua instância é provisionada na Nexxa (status fica 🔵 Criando).
Escolha o tipo de número: "Número Virtual Nexxa" ou "Número Próprio (Meta)".
4A. Caminho A — Número Próprio (Meta API)
Clique em "Conectar com Meta". Uma janela popup do Facebook/Meta será aberta.
Faça login com a conta administradora do seu Business Manager.
Selecione o Business Manager e a conta WhatsApp Business (WABA) que serão usados.
Cadastre o número de telefone que deseja conectar e escolha o método de verificação (SMS ou ligação).
Insira o código de 6 dígitos recebido no número. ATENÇÃO: este código só serve uma vez.
Autorize todas as permissões solicitadas (envio/recebimento de mensagens, gestão de templates, métricas).
4B. Caminho B — Número Virtual Nexxa
Selecione o DDD desejado (regiões disponíveis aparecem na tela).
Confirme a alocação. Em poucos minutos um número novo é gerado e atribuído ao seu workspace.
O status muda automaticamente para 🟠 Conectando e depois para 🟢 Conectado, sem necessidade de QR Code.
4C. Validação final
Aguarde até o status ficar 🟢 Conectado (geralmente 1–3 minutos).
Envie uma mensagem de teste a partir do seu celular pessoal para o número conectado.
Verifique se a mensagem aparece no Inbox do Deskito em até 10 segundos.
Responda pelo Inbox e confirme que a mensagem chega no celular pessoal. Pronto, está integrado!
5. Estados da conexão e o que cada um significa
Durante e após a integração, o status na tela de Integrações pode assumir diferentes cores. Saber interpretar cada uma evita pânico desnecessário.
🔵 Criando — Instância está sendo provisionada na Nexxa. Aguarde, não recarregue a página. 🟡 Aguardando — Pendente uma ação sua (autorização Meta, código SMS, escolha de DDD). 🟠 Conectando — Sincronizando com a infraestrutura do WhatsApp. Pode levar até 5 min. 🟢 Conectado — Tudo certo, mensagens fluindo nos dois sentidos. 🔴 Desconectado — A conexão caiu. Reabra o assistente e clique em "Reconectar".
Se o status ficar travado em 🟡 Aguardando ou 🟠 Conectando por mais de 10 minutos, clique no botão "Completar Configuração" que aparece no card. Ele retoma o fluxo do ponto onde parou.
6. ⚠️ Precauções críticas pós-conexão
Esta é a seção mais importante deste tutorial. Quase 100% dos casos de "WhatsApp desconectou sozinho" vêm de violar uma destas regras.
🚫 NÃO abra o WhatsApp Business App no celular com o mesmo número. A Meta detecta uso simultâneo do número em duas sessões e desconecta a integração imediatamente.
🚫 NÃO use o WhatsApp Web (web.whatsapp.com) com o número conectado. Mesmo problema de sessão simultânea.
🚫 NÃO troque o chip do número para outro celular durante o uso. A Meta invalida a sessão e exige nova verificação por SMS.
🚫 NÃO restaure backups do WhatsApp no número conectado. Restaurar backup força login no app oficial e quebra a integração.
🚫 NÃO faça logout pelo app oficial. Se você tinha o app instalado antes, desinstale ou simplesmente não o abra mais com este número.
🚫 NÃO compartilhe o número em campanhas pagas com expectativa de respostas em massa antes de fazer warm-up (veja seção 7).
✅ Boa notícia: depois de conectado via API oficial, você NÃO precisa manter celular ligado, com bateria ou internet. A Nexxa cuida de toda a infraestrutura 24/7.
7. Boas práticas de uso diário
Janela de 24 horas
Quando um cliente te envia uma mensagem, abre uma janela de 24h durante a qual você pode responder com mensagens livres (texto, mídia, qualquer conteúdo). Após 24h sem interação do cliente, você só consegue iniciar contato usando um Template aprovado pela Meta.
Aquecimento de número novo (warm-up)
Números recém-conectados têm reputação zero na Meta. Disparar 500 mensagens no primeiro dia é um pedido de banimento.
Semana 1: até 50 mensagens/dia, focando em conversas reais. Semana 2: até 150 mensagens/dia. Semana 3: até 350 mensagens/dia. Semana 4 em diante: aumente conforme a qualidade das respostas (verde no painel Meta = liberado para escalar).
Horários e frequência
Envie em horário comercial (08h–20h, fuso do destinatário). Evite madrugada e domingos — gera bloqueio em massa por reportes de spam.
Limite a 2–3 mensagens automatizadas por contato por dia. Mais que isso é considerado abuso pelos algoritmos da Meta.
Templates rejeitados consecutivamente prejudicam a "qualidade" do número (visível no Business Manager). Qualidade Vermelha por 7 dias = banimento permanente.
8. Configuração do telefone do Owner (KITO AI)
O KITO (assistente de IA do Deskito) precisa saber qual é o telefone do dono para enviar relatórios, alertas e responder comandos via WhatsApp.
Vá em Configurações → Perfil → Telefone WhatsApp.
Cadastre seu número PESSOAL no formato +55 11 9XXXX-XXXX (não use o número da integração).
Confirme o código de validação enviado por mensagem.
Em Equipe → Membros, vincule cada operador para que recebam atribuições de conversas no Inbox.
Apenas o Owner pode ativar e configurar o KITO. Membros da equipe usam o KITO por delegação dentro do Inbox.
9. Como testar se está tudo funcionando
Envie uma mensagem do seu celular pessoal para o número integrado e confirme a chegada no Inbox em segundos.
Responda pelo Inbox e confirme a chegada no celular pessoal.
Peça a um cliente real (ou colega) para te enviar uma mensagem — confirma que a entrada externa também funciona.
Crie uma automação simples (ex: resposta automática "Recebemos sua mensagem!") e teste o disparo.
Envie um Template aprovado para um contato e confirme entrega.
10. Troubleshooting — Problemas comuns
Conexão caiu sozinha após algumas horas
Causa quase certa: alguém abriu o WhatsApp Business App ou WhatsApp Web com o mesmo número. Solução: desinstale o app oficial, faça logout do Web, depois reconecte pelo Deskito.
Status preso em 🟠 Conectando há mais de 10 min
Clique em "Completar Configuração". Se persistir, recarregue a página. Se ainda assim travar, exclua a integração e refaça do zero (os dados de inbox não são perdidos).
Popup de login Meta não abre
Seu navegador está bloqueando pop-ups. Libere para o domínio deskito.com.br e tente de novo. Em iOS Safari, desabilite "Bloquear pop-ups" temporariamente.
Mensagens não chegam no Inbox
Verifique: (1) status está 🟢 Conectado; (2) o webhook Nexxa está configurado (visível em Integrações → WhatsApp → Diagnóstico); (3) o cliente não está bloqueado. Se nada disso resolver, abra um chamado.
Templates rejeitados pela Meta
Causas comuns: linguagem promocional excessiva, links encurtados (bit.ly), pedidos diretos de dados sensíveis, ausência de botão de opt-out. Reescreva o template seguindo as diretrizes oficiais e reenvie para aprovação.
Como reconectar com segurança
Garanta que NENHUM dispositivo está usando o número (app oficial fechado, Web deslogado).
Acesse Configurações → Integrações → WhatsApp e clique em "Reconectar".
Repita o processo de validação (código SMS, se número próprio).
Aguarde 🟢 Conectado e faça o teste de envio/recebimento.
11. Quando contatar o suporte
Se mesmo após o troubleshooting o problema persistir, abra um ticket. Quanto mais informações você enviar, mais rápida a resolução.
• ID da instância (visível em Integrações → WhatsApp → Detalhes) • Print do status atual (com a cor visível) • Print do Diagnóstico Nexxa • Horário aproximado em que o problema começou • Última ação realizada antes do problema (mudou plano, restaurou backup, etc.) • Tipo do número (virtual ou próprio)
Use o atalho ⌘K (ou Ctrl+K) em qualquer tela do Deskito e busque por "suporte" para abrir um ticket sem sair do app.
Casos de banimento Meta (qualidade Vermelha permanente) NÃO podem ser revertidos pelo Deskito — apenas a própria Meta libera. Por isso, prevenção (warm-up + boas práticas) é essencial.