Ir para o conteúdo

Configuração do WhatsApp

Canais Canais

O FRENZY.BOT inclui uma integração de WhatsApp com um clique, alimentada pelo WAHA (WhatsApp HTTP API). Uma vez ativado, seu assistente de IA pode receber e responder mensagens de WhatsApp automaticamente — com captura de leads, suporte a transbordo humano e rastreamento de conversas.

Pré-requisitos

  • Canal de WhatsApp habilitado em Channels
  • Um número de telefone capaz de usar WhatsApp
  • Serviço de WhatsApp habilitado no seu servidor (tratado automaticamente durante a configuração)

Configuração passo a passo

Passo 1: Adicionar o canal do WhatsApp

  1. Vá para Channels na barra lateral do painel.
  2. Na seção Catalog (navegação esquerda), clique em WhatsApp.
  3. Alterne o canal para Active.

Instalação automática

O serviço de WhatsApp é pré-instalado e está pronto para uso quando seu servidor é provisionado. Nenhuma configuração adicional é necessária além da ativação.

Passo 2: Iniciar o serviço de WhatsApp

  1. Uma vez ativado, você verá o painel Service Status.
  2. O painel mostra o status do serviço:
    • Running (verde): O serviço está ativo e pronto.
    • Starting (âmbar): O serviço está iniciando. Aguarde de 10 a 30 segundos.
    • Stopped (vermelho): Clique em Start para iniciar o serviço.
  3. Use os botões Start / Stop / Restart para controlar o serviço.

Passo 3: Conectar sua conta de WhatsApp

  1. Assim que o serviço mostrar Running e a API estiver acessível, a seção do WhatsApp será desbloqueada.
  2. Clique em Connect WhatsApp.
  3. Um código QR aparecerá na tela.
  4. Abra o WhatsApp no seu telefone → Configurações → Aparelhos conectados → Conectar um aparelho.
  5. Escaneie o código QR.
  6. Aguarde até que o status da conexão mostre Connected.

Tempo do código QR

O código QR é atualizado a cada 30 segundos. Se ele expirar, clique em Refresh QR para gerar um novo. Mantenha seu telefone por perto durante a configuração.

Passo 4: Testar a conexão

  1. Envie uma mensagem para o seu número de WhatsApp a partir de um telefone diferente.
  2. O bot deve responder usando sua base de conhecimento e o modelo de IA.
  3. Verifique a página Conversations no painel para confirmar que a mensagem apareceu.

Como funciona

Uma vez conectado, o FRENZY.BOT gerencia as mensagens de WhatsApp de ponta a ponta:

  1. Mensagem recebida → O WAHA a recebe e encaminha para o FRENZY.BOT via webhook.
  2. Processamento de IA → O bot recupera o conteúdo relevante da base de conhecimento e gera uma resposta.
  3. Resposta enviada → A resposta é enviada de volta pelo WhatsApp para o usuário.
  4. Captura de leads → Se o usuário fornecer detalhes de contato, um lead é criado automaticamente.
  5. Transbordo → Se o usuário solicitar um atendente humano, a conversa é escalada para seus agentes de chat ao vivo.

Estilo de resposta do canal

As respostas do WhatsApp são automaticamente adaptadas para o formato de mensagens:

  • Respostas mais curtas e conversacionais (menos de 2 frases por padrão).
  • Tom amigável adequado para mensagens móveis.
  • Você pode personalizar o estilo de resposta do WhatsApp em Settings → Channels.

Gerenciando o serviço de WhatsApp

Controles de serviço

O painel fornece controles diretos para o serviço de WhatsApp:

Ação O que faz
Start Inicia o serviço se ele estiver parado
Stop Para o serviço de forma segura
Restart Para e reinicia (útil após mudanças de configuração)
Status Mostra o estado atual + verificação de integridade da API

Desconectar o WhatsApp

Para desconectar sua conta de WhatsApp sem remover o módulo:

  1. Vá para Settings → WhatsApp.
  2. Clique em Disconnect.
  3. O bot para de receber mensagens de WhatsApp imediatamente.
  4. O histórico de conversas e leads são preservados.

Para reconectar mais tarde, basta escanear um novo código QR.

Segurança

  • O serviço de WhatsApp é protegido por firewall e acessível apenas pelo seu servidor.
  • As chaves de API são geradas automaticamente e armazenadas de forma segura.
  • As mensagens de WhatsApp são processadas no seu servidor privado — elas nunca passam por serviços de nuvem de terceiros.

FAQ

P: O código QR não escaneia.

  • Certifique-se de que o serviço WAHA mostra Running e a verificação de integridade da API está verde.
  • Tente atualizar o código QR.
  • Certifique-se de que seu telefone tem uma conexão de internet estável.

P: As mensagens não estão sendo recebidas.

  • Verifique se o status da sessão do WhatsApp mostra Connected.
  • Verifique se a URL do webhook está configurada corretamente (isso é automático na maioria das configurações).
  • Entre em contato com seu gerente de conta se o problema persistir.

P: Posso usar a API do WhatsApp Business em vez disso?

  • O FRENZY.BOT atualmente utiliza o WAHA (WhatsApp baseado em dispositivo). O suporte para a API do WhatsApp Business (baseada em nuvem) está no roteiro de desenvolvimento.

P: Quantas conversas o WhatsApp pode aguentar?

  • O motor NOWEB é leve e lida com volumes empresariais padrão de forma eficiente. Para volumes muito altos (+1000 chats simultâneos), entre em contato com seu gerente de conta para opções de escalonamento.

P: Vou perder meu histórico de chat do WhatsApp se reiniciar o serviço?

  • Não. Reiniciar o serviço preserva a sessão do WhatsApp. Você só precisa reescanear o código QR se desconectar explicitamente.