SunchatPlus
StatusEm breveSuporteAcessar plataforma
Comece aquiGuia da plataformaAPI PúblicaAjudaNovidades
    • O que fazemos?
    • Nossos recursos
    • Criando sua conta
    • Acessando a plataforma
    • Tarefas iniciais
    • Convidando a equipe
    • Conectando o primeiro canal

Documentação

SunchatPlus

© 2026 SunchatPlus. Todos os direitos reservados.

O WhatsApp Web conecta um número de WhatsApp comum: você lê um QR Code com o celular e o número passa a receber e enviar mensagens pelo SunchatPlus. É a forma mais rápida de começar com o número que a empresa já usa, sem passar pela aprovação da Meta. As conversas chegam na mesma caixa de entrada dos demais canais.

Muita gente chama esse formato de API não oficial, WhatsApp não oficial ou API não oficial do WhatsApp. Não confunda com o WhatsApp Oficial, que é a Cloud API autorizada pela Meta.

Se você ainda está decidindo entre esse formato e o WhatsApp Oficial, a comparação entre os dois está em Canais.

Esta é uma conexão não oficial, com risco alto de banimento. O WhatsApp Web não é um canal autorizado pela Meta: a plataforma não reconhece o uso do número por sistemas externos e pode bloquear ou banir o número a qualquer momento, sem aviso e sem direito a recurso. O risco é maior do que no WhatsApp Oficial e aumenta com disparos em massa, mensagens para quem não pediu contato, números novos e bloqueios ou denúncias de destinatários.

A SunchatPlus não se responsabiliza pelo banimento de números. Ao conectar um número por WhatsApp Web, a sua empresa assume esse risco. Para operações de volume alto, campanhas ou números críticos para o negócio, use o WhatsApp Oficial.

Conectando o canal

Abra a tela de canais

No menu lateral, vá em Configurações > Atendimento > Canais, clique em Incluir e escolha WhatsApp Web. O painel Conectar WhatsApp Web abre.

Dê um nome ao canal

Preencha Nome do canal. Ele é obrigatório, aceita até 100 caracteres e serve só para você identificar o canal dentro do SunchatPlus (por exemplo, "WhatsApp Vendas"). Sem nome, o código não é gerado.

Gere o QR Code

Com a opção QR Code selecionada, clique em Gerar QR Code. O canal já é criado nesse momento, antes da leitura: ele aparece na lista mesmo se você fechar o painel sem concluir.

Leia o código com o celular

O painel mostra o código e os três passos a seguir no aparelho: Abra o WhatsApp no celular, Toque em Dispositivos conectados e Aponte a câmera para o código.

Aguarde a confirmação

Ao conectar, o painel se fecha na hora (a confirmação Canal conectado! só aparece por um instante) e o canal passa a figurar na lista com o status Conectado.

Formulário de conexão do WhatsApp Web com opção para gerar o QR Code

O código tem validade curta. O SunchatPlus acompanha a leitura por cerca de 30 segundos. Passado esse tempo sem confirmação, aparece o aviso "O QR Code expirou. Gere um novo para tentar novamente." — clique em Gerar novo QR Code e leia outra vez.

Na criação de um WhatsApp Web não existe botão de salvar: o rodapé traz só Fechar, porque é a leitura do código que conclui a conexão. Departamento padrão, fluxo, agente de IA e ligações aparecem depois, quando você reabre o canal para editar.

Conectando por passkey

Algumas contas são obrigadas pelo WhatsApp a parear por passkey, em vez de QR Code. Para esses casos, o painel de conexão tem a opção Passkey ao lado de QR Code.

Escolha Passkey e inicie

Selecione Passkey e clique em Iniciar pareamento. Depois, clique em Abrir pareamento por passkey: abre em outra aba uma página com o passo a passo e o atalho de pareamento.

Guarde o atalho nos favoritos

Nessa página, arraste o botão 🔑 Parear passkey para a barra de favoritos do navegador. Se arrastar não funcionar, copie o código exibido no fim da página (botão Copiar código) e crie um favorito novo colando esse código no lugar do endereço.

Entre no WhatsApp Web

Abra web.whatsapp.com e faça login na mesma conta que você quer conectar.

Clique no favorito e autorize

Com o web.whatsapp.com aberto, clique no favorito Parear passkey e autorize com a sua biometria ou PIN quando o navegador pedir. A assinatura só funciona dentro do site do WhatsApp — por isso o atalho, e não um botão no painel.

Volte ao SunchatPlus

Em alguns segundos o canal conecta sozinho. Enquanto isso, o painel mostra um código de confirmação: confira se é o mesmo que aparece no seu dispositivo ao autorizar.

O SunchatPlus fica aguardando a autorização por cerca de cinco minutos. Se esse tempo passar, reinicie o pareamento.

Se o pareamento não completar, fale com o administrador. O navegador aberto em web.whatsapp.com precisa conseguir chamar o SunchatPlus, e essa liberação (da origem https://web.whatsapp.com) é feita por quem administra o ambiente. Sem ela, o clique no favorito não dá erro visível: o canal simplesmente nunca conecta.

Status possíveis do canal

StatusO que significaO que fazer
ConectadoSessão ativa, mensagens fluindoNada
DesconectadoA sessão do aparelho caiu ou foi encerrada em Dispositivos conectadosAguarde a reconexão automática, use Reiniciar ou reabra o canal para ler um novo QR Code
DuplicadoO número já está conectado em outro canal. Nesse caso o SunchatPlus encerra a sessão nova automaticamenteExclua o canal repetido e conecte de novo, mantendo um só por número
—O canal foi criado, mas nunca chegou a conectarReabra o canal e leia o QR Code

Enquanto a conexão está sendo estabelecida, o status pode aparecer em inglês, como CONNECTING — ou seja, "conectando". É um estado passageiro, e ele não muda sozinho na tela: a lista de canais é recarregada quando você executa uma ação nela ou digita algo na busca.

Quando o canal cai

O WhatsApp Web depende da sessão do seu aparelho. Mantenha o celular com bateria e internet: se ele ficar muito tempo desligado, ou se alguém remover o SunchatPlus de Dispositivos conectados, o canal cai.

O que acontece quando isso ocorre:

  • Os administradores da conta recebem uma notificação avisando que o canal foi desconectado.
  • O SunchatPlus passa a tentar restabelecer a sessão sozinho: a verificação roda a cada 5 minutos, começa depois de 5 minutos sem conexão e vai até 50 tentativas. Um canal parado há mais de 6 horas volta a ser reconectado à força, mesmo tendo estourado as tentativas. Se der certo, o status volta para Conectado sem você fazer nada.
  • Na tela do Chat, o ícone do canal na conversa fica vermelho enquanto ele está desconectado (e cinza quando o status ainda não é conhecido).

Se a reconexão automática não resolver, você tem duas saídas: a ação Reiniciar, que força o canal a recomeçar a conexão, ou uma nova leitura de QR Code.

Ao reabrir um canal WhatsApp Web que não está conectado, o SunchatPlus já gera um novo QR Code automaticamente — e gerar um código novo encerra a sessão atual no celular. Só reabra um canal desconectado quando estiver com o aparelho em mãos para ler o código.

Ações da lista de canais

Em Configurações > Atendimento > Canais, o menu de ações da linha traz para o WhatsApp Web:

  • Editar — abre o canal para ajustes. Clicar na linha faz o mesmo.
  • Reiniciar — força o canal a recomeçar a conexão. A confirmação aparece como "Canal reiniciado.". Na visão em lista, cada canal WhatsApp Web também tem um botão de reiniciar fixo no fim da linha.
  • Sincronizar contatos — importa para o SunchatPlus os contatos daquele WhatsApp. A importação roda em segundo plano ("Sincronização de contatos iniciada.").
  • Excluir — remove o canal. A confirmação avisa que o canal será desconectado. As conversas já registradas continuam no histórico dos contatos.

Na visão em cards as opções são outras: Configurar (abre o canal), reiniciar e excluir. Sincronizar contatos existe só no menu da linha, na visão em lista.

Configurações disponíveis depois de conectado

Reabra o canal para ajustar:

  • Nome do canal.
  • Identificador do canal — o código do canal, útil em integrações.
  • Fluxo padrão — fluxo iniciado automaticamente quando uma conversa nova chega. A opção Desabilitar fluxo neste canal ignora o fluxo e manda as mensagens direto para o atendimento.
  • Departamento padrão — setor que recebe as conversas iniciadas nesse canal.
  • Agente de IA — assistente que responde antes de encaminhar a um atendente humano.
  • Ligações — ver abaixo.
  • Sincronização de histórico — importa atendimentos, mensagens e mídias de um sistema externo para este canal.

Clique em Salvar ao terminar. O tipo do canal não pode ser trocado. O passo a passo completo está em Canais.

Envio livre, sem janela de 24 horas

Diferente do WhatsApp Oficial, o WhatsApp Web não tem a restrição da janela de 24 horas: você pode escrever para um contato a qualquer momento, sem modelo aprovado. Isso facilita o dia a dia, mas é justamente o uso que mais expõe o número. Vale tratar essa liberdade com cuidado.

Ligações

Na edição do canal, a opção Habilitar ligações neste canal libera as chamadas de voz: o canal passa a aparecer no discador e as ligações recebidas tocam para a equipe.

Com a opção desligada, o canal sai do discador e as ligações recebidas não tocam — são recusadas automaticamente e ficam registradas na conversa como tentativa de ligação.

As ligações funcionam no WhatsApp Web e também no WhatsApp Oficial. A diferença: no Oficial, a Meta exige que o contato autorize a ligação antes de a empresa discar. No WhatsApp Web não existe esse pedido de permissão.

Reduzindo o risco de bloqueio

Nenhuma prática elimina o risco, mas estas reduzem bastante a chance de o número ser bloqueado:

  • Não dispare em massa. Envios repetidos para muitos contatos que nunca falaram com você são o principal gatilho de bloqueio.
  • Fale com quem pediu contato. Mensagens não solicitadas viram denúncia, e denúncia derruba o número.
  • Aqueça números novos. Um chip recém-comprado que começa mandando centenas de mensagens é bloqueado rápido. Aumente o volume aos poucos.
  • Facilite a saída. Em comunicados, ofereça uma forma clara de o contato pedir para não receber mais.
  • Evite conteúdo repetido. Textos idênticos enviados em sequência para muitos contatos chamam atenção dos filtros da plataforma.

Dúvidas frequentes

Edit with