Apresentação e documentação do projeto **WhatsApp AgentKit**, um bot…

INEMA

platform.openai.com/agent-builder/edit ↗

Dá para usar só baixando o download.zip, sem precisar usar Git nem comandos no terminal, mas há duas coisinhas que precisam ser feitas direito para tudo funcionar. Aqui vai o passo a passo mais simples possível 👇

🟢 Instalação Simples (sem Git)⌗

1. Baixar o projeto⌗

Acesse: https://github.com/inematds/whatsapp-agentkit
Clique em Code → Download ZIP
Extraia o arquivo em uma pasta do seu computador (por exemplo, área de trabalho).

2. Criar o arquivo `.env`⌗

Dentro da pasta extraída, você vai ver um arquivo chamado:

.env.example

Faça assim:

Copie esse arquivo
Cole no mesmo lugar e renomeie para .env (sem o “.example”)
Abra com o Bloco de Notas e preencha:

OPENAI_API_KEY=sua_chave_aqui WORKFLOW_ID=seu_workflow_aqui

A API Key você pega em: https://platform.openai.com
O Workflow ID está no seu agente dentro do Agent Builder da OpenAI.

Salve e feche o arquivo.

3. Executar o bot⌗

Agora, dentro da pasta do projeto, basta clicar duas vezes em:

start_dev.bat (modo de teste) ou
start_prod.bat (modo normal)

O programa vai abrir o terminal automaticamente e começar a carregar os módulos.

4. Conectar ao WhatsApp Web⌗

Quando o bot terminar de iniciar, o terminal vai mostrar algo assim:

📱 Gerando QR Code...

Aparecerá um QR Code no terminal.

Faça o seguinte:

Abra o WhatsApp no seu celular
Vá em Dispositivos Conectados
Toque em Conectar um dispositivo
Escaneie o QR Code que aparece no terminal

Se aparecer:

✅ Bot conectado com sucesso!

Pronto — o bot já está ativo!

5. Testar⌗

Envie uma mensagem do seu celular para o número conectado (o mesmo WhatsApp usado no computador). Por exemplo:

Oi, tudo bem?

Você deve receber a resposta automática da IA em alguns segundos.

6. Comandos úteis⌗

Comando	O que faz
`!help`	Mostra os comandos disponíveis
`!clear`	Limpa o histórico da conversa
`!status`	Mostra se o bot está online
`!ping`	Testa a conexão

7. Dicas importantes⌗

Não feche o terminal enquanto quiser que o bot responda.
O WhatsApp Web precisa estar logado (se desconectar no celular, ele para).
Se o QR Code não aparecer, instale as dependências manualmente:

Abra o terminal na pasta do projeto
Digite:

npm install

e depois rode novamente o .bat.

⚙️ Resumo rápido⌗

Etapa	O que fazer
1	Baixar e extrair o ZIP
2	Criar `.env` com suas chaves
3	Rodar `start_dev.bat`
4	Escanear o QR Code com o WhatsApp
5	Testar com uma mensagem

Com base no relatório RELATORIO_SISTEMA.md, segue o texto atualizado explicando a nova solução do WhatsApp AgentKit, com uma explicação clara de como ela funciona, como instalar e como usar:

WhatsApp AgentKit – Automação Inteligente com OpenAI GPT-4o⌗

1. O que é⌗

O WhatsApp AgentKit é uma solução moderna que conecta o WhatsApp diretamente à inteligência artificial da OpenAI, permitindo conversas automáticas, personalizadas e contextuais com usuários — tudo rodando de forma local, simples e gratuita. Ele utiliza o whatsapp-web.js para comunicação em tempo real e o AgentKit (OpenAI) para gerar respostas inteligentes com base em fluxos criados no Agent Builder.

2. Como funciona⌗

O usuário envia uma mensagem no WhatsApp.
O sistema (via Puppeteer e whatsapp-web.js) captura a mensagem.
O módulo principal (bot.ts) processa a mensagem:

ignora grupos e mensagens do próprio bot;
verifica se é um comando especial (!help, !status, etc.);
se for mensagem normal, cria o contexto e busca o histórico. 4. O módulo (openai-simple.ts) envia o texto para a OpenAI GPT-4o, com o contexto e o ID do workflow configurado. 5. A resposta gerada volta para o bot e é enviada automaticamente ao usuário no WhatsApp. 6. O histórico de conversa é armazenado por contato, garantindo continuidade nas respostas.

3. Estrutura simplificada⌗

Usuário → WhatsApp Web → bot.ts → openai-simple.ts → OpenAI GPT-4o → Resposta no WhatsApp

4. Instalação passo a passo⌗

Pré-requisitos:

Node.js v18 ou superior
Git instalado no computador

1. Clonar o repositório

git clone https://github.com/inematds/whatsapp-agentkit.git cd whatsapp-agentkit

2. Instalar dependências

npm install

3. Configurar o arquivo .env Copie o arquivo de exemplo:

cp .env.example .env

Abra o .env e insira:

OPENAI_API_KEY=sua_chave_aqui WORKFLOW_ID=seu_workflow_id_aqui

A chave é obtida em https://platform.openai.com O ID do workflow vem do seu Agent Builder.

4. Iniciar o bot

Modo desenvolvimento:

npm run dev * Modo produção:

npm start

5. Conectar ao WhatsApp

No terminal, será exibido um QR Code.
Escaneie com o WhatsApp (Menu → Dispositivos Conectados → Conectar).
Após a autenticação, o bot estará online e pronto para responder.

5. Comandos úteis⌗

!help – Mostra comandos disponíveis
!status – Exibe o status do bot
!ping – Testa se o bot está ativo
!clear – Limpa o histórico de conversa

6. Recursos principais⌗

Integração direta com GPT-4o (modelo rápido e multimodal)
Suporte a contexto individual por usuário
Comandos administrativos nativos
Instalação e execução local
Código aberto e modular, fácil de expandir
Logs automáticos de erros e status

7. Limitações atuais⌗

Não processa imagens, áudios ou vídeos (apenas texto)
Histórico se perde ao reiniciar o bot
Não responde mensagens de grupos
Necessita de uma máquina ligada constantemente

8. Exemplos de uso⌗

Atendimento automático: responder clientes, consultas ou FAQs
Assistente pessoal: lembretes, agendamentos e anotações
Educação: responder dúvidas de alunos e auxiliar estudos
Negócios locais: responder orçamentos, horários e pedidos

9. Como personalizar⌗

Para criar um bot com personalidade própria:

No Agent Builder, monte um fluxo com seu workflow personalizado.
Copie o Workflow ID e substitua no .env.
Reinicie o bot. Agora o WhatsApp responderá conforme o fluxo e a lógica do seu agente.

10. Conclusão⌗

O WhatsApp AgentKit é uma plataforma pronta para quem quer unir inteligência artificial, automação e comunicação direta com clientes. Roda localmente, usa tecnologia moderna (Node.js + GPT-4o), é fácil de configurar e permite que qualquer pessoa crie seu próprio assistente de IA no WhatsApp.

github.com ↗

Whatsapp-AgentKit ChatBot GitHub

chatgpt.com ↗