Integração WhatsApp Pessoal

Esta página descreve como conectar um Agente SipPulse AI a um número WhatsApp pessoal usando escaneamento de QR Code, similar ao WhatsApp Web.

1. O que é o WhatsApp Pessoal?

WhatsApp Pessoal é um canal de implantação alternativo que permite conectar seu número WhatsApp pessoal a um agente via QR Code. Funciona de forma similar ao WhatsApp Web - você escaneia um código e seu número fica vinculado à plataforma.

Recurso Beta

Esta integração utiliza uma biblioteca não oficial e é considerada beta/experimental. Embora funcional, pode apresentar instabilidades ocasionais. A Meta pode fazer alterações no WhatsApp que afetem esta integração a qualquer momento.

Quando Usar o WhatsApp Pessoal

Cenários ideais:

• Validar rapidamente fluxos conversacionais antes de ir para produção
• Projetos pessoais ou implementações de pequena escala
• Demonstrações e provas de conceito
• Situações onde você precisa de controle manual sobre as conversas

Comparação com WhatsApp Business

Recurso	WhatsApp Business	WhatsApp Pessoal
Verificação Meta Business	Obrigatória	Não necessária
Mensagens Proativas (Templates)	Sim	Não
API Oficial	Sim	Não (conexão via QR Code)
Painel de Debug de Mensagens	Sim	Não
Envio via API	Sim	Não
Estabilidade	Alta	Pode variar
Intervenção Manual	Limitada	Total (é seu número)
Ideal para	Produção / Escala	Validação / Pequena escala

2. Configuração Inicial

Pré-requisitos

• Um número WhatsApp (recomendamos fortemente usar um número dedicado)
• O número não pode estar conectado a outro agente

Importante: Use um Número Dedicado

Recomendamos fortemente usar um número dedicado para esta integração, não seu número pessoal principal.

Por quê? Quando conectado, todas as mensagens recebidas neste número serão processadas pelo agente. Se usar seu número pessoal, conversas com família, amigos e trabalho também passarão pelo agente.

Conectar via QR Code

1. Abra ⋮ → Implantações na linha do Agente e localize o card WhatsApp Pessoal.
2. Clique em Escanear QR Code.
3. Um modal aparecerá com instruções e um QR Code.
4. No seu celular, abra WhatsApp → Configurações → Aparelhos Conectados → Conectar um aparelho.
5. Escaneie o QR Code exibido no SipPulse AI.
6. Uma vez conectado, o card exibirá seu número de telefone e o status mudará para Conectado.

Sobre o QR Code:

• Cada código é válido por aproximadamente 45 segundos
• Se expirar, um novo é gerado automaticamente
• O sistema tenta até 10 vezes antes de encerrar a sessão
• Se isso acontecer, basta reabrir o modal e tentar novamente

Um número por agente

Cada número WhatsApp só pode estar conectado a um agente por vez. Se você tentar conectar um número que já está em uso, verá uma mensagem de erro: "Este número de telefone já está conectado a outro agente."

3. Como Funciona na Prática

Fluxo de Mensagens

Usuário envia mensagem → WhatsApp → SipPulse AI → Agente processa → Resposta automática

Quando a integração está ativa, cada mensagem recebida no número conectado é enviada ao agente para processamento. O agente analisa a mensagem e gera uma resposta apropriada baseada em sua configuração.

Intervenção Humana

Como o número é seu, você pode interferir manualmente a qualquer momento:

• Abra o WhatsApp no celular e responda diretamente
• O agente verá sua mensagem como parte da conversa
• Útil para situações que o agente não consegue resolver

Vantagem Exclusiva

Esta é uma vantagem única do WhatsApp Pessoal: você tem acesso total às conversas e pode intervir quando necessário, diferente do WhatsApp Business onde o controle é apenas via API.

4. Gerenciamento

Ativar ou Desativar Rapidamente

Use o botão de alternância no card para controlar a integração:

• Ligado → O agente processa mensagens recebidas em tempo real.
• Desligado → Mensagens recebidas são ignoradas; sem cobrança de tokens.

Status de Conexão

O card exibe o status atual da conexão:

Status	Descrição
Offline	Não conectado. Clique em "Escanear QR Code" para conectar.
Conectando	QR Code gerado, aguardando escaneamento.
Conectado	Conectado com sucesso e recebendo mensagens.
Reconectando	Conexão perdida, tentando restaurar automaticamente.

Desconectar

Para desconectar seu número WhatsApp:

1. Clique no menu ⋮ no card WhatsApp Pessoal.
2. Selecione Desconectar.
3. A conexão será encerrada e o status retornará para Offline.

Você também pode desconectar pelo WhatsApp no celular (Configurações → Aparelhos Conectados).

5. Limitações e Considerações

O que NÃO é Possível

• Sem mensagens proativas: Você não pode enviar mensagens de template para iniciar conversas.
• Sem envio via API: Mensagens só podem ser recebidas e respondidas, não enviadas programaticamente.
• Sem painel de debug: O histórico de mensagens não está disponível na interface de debug.
• Dependência de sessão: A conexão depende do seu celular permanecer conectado à internet.

Considerações de Estabilidade

• Esta integração usa uma biblioteca não oficial
• Pode haver instabilidades ocasionais
• A Meta pode fazer mudanças que afetem o funcionamento
• Recomenda-se ter um plano de contingência para uso em produção

Ideal para Validação

WhatsApp Pessoal foi projetado para testes rápidos e validação do comportamento do seu agente. Para casos de uso em produção que requerem mensagens proativas, integração via API ou maior confiabilidade, use a integração WhatsApp Business.

6. Solução de Problemas

QR Code Expirado

Se o QR Code expirar antes de você escaneá-lo, o sistema gera automaticamente um novo (até 10 vezes). Se todos os códigos expirarem, simplesmente feche o modal e clique em "Escanear QR Code" novamente para iniciar uma nova sessão.

Número de Telefone Já em Uso

Se você vir "Este número de telefone já está conectado a outro agente", você precisa:

• Desconectar o número do outro agente primeiro, ou
• Usar um número WhatsApp diferente.

Conexão Fica Reconectando

Se o status continua alternando entre "Conectado" e "Reconectando":

• Certifique-se de que seu celular tem uma conexão de internet estável.
• Verifique se o WhatsApp está rodando em segundo plano no seu celular.
• Tente desconectar e reconectar via QR Code.
• Reinicie o WhatsApp no seu celular se o problema persistir.