Automação de WhatsApp com IA integrada. Dispare campanhas, converse com clientes e deixe agentes de IA atenderem por você.

• Sobre
• O que você pode fazer
• Instalação Rápida
• Primeiros Passos
• Como Usar
• Configurações
• Problemas Comuns
• FAQ
• Suporte

SmartZap é uma plataforma completa de automação de WhatsApp que ajuda você a se comunicar com clientes de forma mais inteligente e produtiva.

• Instalação em minutos: Deploy na Vercel + wizard que configura tudo
• Campanhas em massa: Dispare mensagens para milhares de contatos com templates aprovados
• Inbox em tempo real: Converse com clientes direto do navegador
• Agentes de IA: Deixe a IA responder automaticamente com contexto personalizado
• Memória de conversas: A IA lembra do histórico de cada cliente
• Funciona em qualquer lugar: Instale como app (PWA) e receba notificações

• Dispare mensagens para toda sua base de contatos
• Use templates aprovados pela Meta (marketing, utilidade, autenticação)
• Acompanhe métricas em tempo real (enviados, entregues, lidos)
• Pré-validação antes do disparo para evitar erros
• Reenvio automático para contatos que falharam

• Receba mensagens de clientes direto no navegador
• Responda manualmente ou deixe a IA atender
• Veja histórico completo de cada conversa
• Notificações push quando chegam mensagens

• Configure agentes com personalidade e instruções
• A IA responde automaticamente às mensagens
• Memória persistente: a IA lembra do contexto de cada cliente
• Logs completos de todas as interações

• Importe contatos via CSV
• Campos personalizados para segmentação
• Status de opt-in/opt-out automático
• Validação de números no formato internacional

• Sincronize templates aprovados da sua conta Meta
• Visualize preview antes de usar
• Crie novos templates direto da plataforma

• Crie formulários de captura embeddáveis
• Receba leads automaticamente na plataforma

Tempo estimado: 15-20 minutos

Método recomendado: Fork → Vercel → Wizard

Este guia vai te levar do zero até ter o SmartZap funcionando.

1. Fazer fork do repositório no GitHub
2. Fazer deploy na Vercel
3. Rodar o wizard de instalação
4. Começar a usar!

flowchart LR A[Fork no GitHub] --> B[Deploy na Vercel] B --> C[Abrir /install] C --> D[Wizard configura tudo] D --> E[Pronto!] 

Antes de começar, você precisa de contas nestes serviços:

Dica: Crie as contas antes de começar e deixe abertas em abas diferentes.

1. Acesse o repositório do SmartZap
2. Clique no botão Fork (canto superior direito)
3. Escolha sua conta pessoal ou organização
4. Aguarde o fork ser criado

Pronto quando: Você ver o repositório smartzap na sua conta do GitHub

1. Acesse vercel.com e faça login
2. Clique em Add New Project
3. Conecte sua conta do GitHub (se ainda não conectou)
4. Selecione smartzap (seu fork)
5. Clique em Deploy

Aguarde: O deploy leva cerca de 2-3 minutos

6. Quando terminar, copie a URL do seu projeto (ex: https://smartzap-abc123.vercel.app)

Pronto quando: Você tiver uma URL funcionando

1. Acesse o wizard

   • Abra: https://SEU-PROJETO.vercel.app/install

2. O wizard tem 5 etapas:

   Etapa 1 - Seus dados:

   • Nome completo
   • Email
   • Senha (será usada para login)

   Etapa 2 - Vercel:

   • Vá em vercel.com/account/tokens
   • Clique em Create Token
   • Dê um nome (ex: "SmartZap Installer")
   • Cole o token no wizard e selecione o projeto

   Etapa 3 - Supabase:

   • Vá em supabase.com/dashboard/account/tokens
   • Clique em Generate new token
   • Nome: smartzap
   • Cole o token no wizard
   • 💡 O projeto será criado automaticamente!

   Etapa 4 - QStash:

   • Crie uma conta no console.upstash.com
   • Clique em QStash no menu lateral
   • Na aba Details, copie o QSTASH_TOKEN
   • Cole no wizard

   Etapa 5 - Redis:

   • No console.upstash.com/redis, clique em Create Database
   • Nome: smartzap • Região: São Paulo (ou mais próxima)
   • Após criar, vá na aba REST API
   • Copie UPSTASH_REDIS_REST_URL e UPSTASH_REDIS_REST_TOKEN
   • Cole ambos no wizard

3. Confirme e execute

   Após preencher tudo, o wizard vai:

   • Criar projeto Supabase automaticamente
   • Configurar variáveis de ambiente na Vercel
   • Aplicar migrations no banco
   • Criar usuário administrador
   • Fazer redeploy automático

   Tempo: 3-5 minutos

4. Pronto!

   Você será redirecionado para fazer login com email e senha.

Pronto quando: Você conseguir fazer login!

Acesse o sistema e faça login com o email e senha que você configurou no wizard.

1. Vá em Configurações
2. Na seção WhatsApp, preencha:
   • Phone Number ID
   • Business Account ID
   • Access Token
3. Configure o Webhook no Meta Business Suite:
   • URL: https://seu-dominio.com/api/webhook
   • Verify Token: o mesmo que você configurou

1. Vá em Templates
2. Clique em Sincronizar
3. Seus templates aprovados aparecerão na lista

1. Vá em Contatos
2. Clique em Importar CSV
3. Mapeie as colunas (nome, telefone, etc.)
4. Importe!

1. Vá em Campanhas → Nova Campanha
2. Escolha um template
3. Selecione os contatos
4. Rode o Precheck para validar
5. Dispare!

1. Vá em Inbox
2. Peça para alguém enviar uma mensagem para seu número
3. A mensagem aparecerá em tempo real!

O SmartZap tem estas áreas principais:

• Campanhas: Criar e gerenciar disparos em massa
• Contatos: Lista de contatos e importação
• Templates: Templates do WhatsApp
• Inbox: Chat em tempo real com clientes
• Configurações: WhatsApp, IA, Integrações

1. Vá em Campanhas → Nova Campanha
2. Dê um nome para a campanha
3. Escolha o template que quer usar
4. Selecione os contatos (pode filtrar por tags)
5. Clique em Precheck para validar
6. Se tudo estiver OK, clique em Disparar
7. Acompanhe as métricas em tempo real

O Inbox mostra todas as conversas com clientes:

1. Clique em uma conversa para ver o histórico
2. Digite sua mensagem e envie
3. Ou ative o AI Agent para responder automaticamente

Para ter respostas automáticas:

1. Vá em Configurações → IA
2. Configure uma chave de API (Gemini, OpenAI ou Anthropic)
3. Vá em Agentes
4. Crie um agente com:
   • Nome
   • Instruções (prompt do sistema)
   • Configurações de memória
5. Ative o agente

Você precisa de uma conta no Meta Business Suite com acesso à Cloud API.

O que configurar:

• Phone Number ID: ID do número de telefone
• Business Account ID: ID da conta business
• Access Token: Token de acesso (permanente recomendado)
• Verify Token: Token para verificação do webhook

Para usar AI Agents, configure uma chave de API:

Depois:

1. Vá em Configurações → IA
2. Cole a chave de API
3. Escolha o modelo
4. Salve

O SmartZap usa dois serviços do Upstash:

QStash - Fila para processar campanhas em lote:

• Vá em upstash.com → QStash
• Copie o QSTASH_TOKEN

Redis - Cache e dados de sessão:

• Vá em upstash.com → Redis → Create Database
• Copie UPSTASH_REDIS_REST_URL e UPSTASH_REDIS_REST_TOKEN

Ambos são configurados automaticamente pelo wizard.

Possíveis causas:

• Senha incorreta
• Wizard não foi completado

Solução:

• Verifique se completou a instalação via wizard
• Confirme a senha que você configurou
• Veja a seção FAQ → Como resetar minha senha?

Possíveis causas:

• Credenciais do WhatsApp incorretas
• Token expirado
• Template não aprovado

Solução:

1. Verifique as credenciais em Configurações
2. Confirme que o template está aprovado no Meta
3. Veja os logs da campanha para erros específicos

Possíveis causas:

• URL do webhook incorreta
• Verify token não confere
• Webhook não configurado no Meta

Solução:

1. Verifique se a URL está correta: https://seu-dominio.com/api/webhook
2. Confirme o verify token nas duas pontas
3. Teste com: curl "https://seu-dominio.com/api/webhook?hub.verify_token=SEU_TOKEN&hub.challenge=test&hub.mode=subscribe"

Possíveis causas:

• Chave de API não configurada
• Agente não está ativo
• Créditos da API esgotados

Solução:

1. Vá em Configurações → IA
2. Verifique se a chave está preenchida
3. Confirme que o agente está ativo
4. Verifique os logs do agente

Possíveis causas:

• Problema no QStash
• Erro no template

Solução:

1. Veja o status em Campanhas
2. Clique na campanha para ver detalhes
3. Se necessário, pause e retome

Possíveis causas:

• PWA não instalado
• Permissões negadas

Solução:

1. Instale o app como PWA (adicionar à tela inicial)
2. Aceite as permissões de notificação
3. Em iOS, precisa adicionar à tela inicial primeiro

1. Acesse vercel.com e faça login
2. Clique no seu projeto SmartZap
3. Clique em Settings (menu da esquerda)
4. Clique em Environment Variables
5. Ache MASTER_PASSWORD na lista
6. Clique nos 3 pontinhos do lado direito → Edit
7. Apague tudo e digite sua nova senha (ex: MinhaSenha123)
8. Clique em Save
9. Clique em Deployments (menu da esquerda)
10. No primeiro da lista, clique nos 3 pontinhos → Redeploy → Redeploy
11. Espera 1 minuto
12. Pronto! Entra com a nova senha.

• Guia de Configuração: Setup completo para produção
• Inbox e AI Agents: Chat e agentes de IA
• Integração Mem0: Memória de conversas
• Changelog: Histórico de alterações

• Problemas: Abra uma issue no GitHub
• Dúvidas: Entre em contato com o mantenedor

Esta seção é apenas para quem quer contribuir ou entender a arquitetura técnica.

• Frontend: Next.js 16, React 19, Tailwind CSS v4, shadcn/ui
• Backend: Next.js API Routes
• Banco: Supabase (PostgreSQL + Realtime)
• Fila: Upstash QStash
• IA: Vercel AI SDK v6 + Mem0
• WhatsApp: Meta Cloud API v24

# 1. Clone o repositório git clone https://github.com/SEU-USUARIO/smartzap.git cd smartzap # 2. Instale dependências npm install # 3. Configure variáveis de ambiente cp .env.example .env.local # Preencha as variáveis # 4. Inicie o servidor npm run dev

npm run dev # Desenvolvimento npm run build # Build de produção npm run lint # Verificar código npm run test # Rodar testes npm run test:e2e # Testes E2E

smartzap/ ├── app/ # Rotas Next.js (App Router) │ ├── (auth)/ # Páginas de auth (login, install) │ ├── (dashboard)/ # Páginas do dashboard │ └── api/ # API Routes ├── components/ # Componentes React ├── hooks/ # Hooks customizados ├── lib/ # Bibliotecas e utilitários ├── services/ # Camada de acesso à API └── supabase/ # Migrations do banco 

Para mais detalhes técnicos, veja:

• CLAUDE.md - Guia para desenvolvedores/IA

⬆ Voltar ao topo

Feito com ❤️ para comunicação mais inteligente