🤖 Chatbot de Qualificação de Leads

Este projeto é um assistente de vendas (SDR) virtual fullstack, com o backend desenvolvido em Java com Spring Boot e o frontend em React com Ant Design. Ele utiliza a API da OpenAI para interagir com potenciais clientes, qualificá-los e, se houver interesse, oferecer horários para uma reunião via Calendly. Todas as interações e dados dos leads são sincronizados com um funil de vendas no Pipefy.

🚀 Teste a demonstração ao vivo!

✨ Tecnologias Utilizadas

Frontend: React, Vite, Ant Design
Backend: Java 17, Spring Boot 3
Comunicação: WebSockets (com STOMP)
Banco de Dados: PostgreSQL
IA: OpenAI (GPT-4o-mini)
Agendamento: Calendly API
CRM/Funil: Pipefy API
Build: Maven

🚀 Funcionalidades Principais

O projeto foi desenvolvido para ser um assistente de vendas completo e autônomo. Abaixo estão suas principais funcionalidades:

🤖 Inteligência Artificial Conversacional: Utiliza o modelo gpt-4o-mini da OpenAI para conduzir uma conversa natural e consultiva, seguindo um fluxo de qualificação pré-definido para coletar informações essenciais do lead.
📊 Coleta e Qualificação de Leads: A IA é instruída a coletar, em ordem, os seguintes dados do potencial cliente:
1. Nome
2. E-mail (com validação de formato)
3. Empresa
4. Necessidade/Desafio
5. Interesse em uma demonstração
🔄 Sincronização com CRM (Pipefy):
- Criação de Cards: Assim que o e-mail do lead é coletado, um novo card é criado automaticamente no funil do Pipefy.
- Atualização Contínua: A cada nova informação obtida (nome, empresa, necessidade, etc.), o card correspondente no Pipefy é atualizado em tempo real.
🗓️ Agendamento Inteligente de Reuniões (Calendly):
- Oferta de Horários: Após qualificar o lead e confirmar o interesse, a IA oferece horários de reunião disponíveis, buscando-os diretamente na API do Calendly.
- Confirmação via Webhook: Quando o usuário finaliza o agendamento no Calendly, um webhook é disparado. O backend recebe essa notificação, atualiza o card no Pipefy com o link e a data da reunião, e envia uma mensagem de confirmação no chat para o usuário com o link do evento.
💬 Comunicação em Tempo Real (WebSockets): A comunicação entre frontend e backend utiliza WebSockets com STOMP, permitindo que o servidor envie notificações proativas para o cliente, como a confirmação do agendamento da reunião.
⚠️ Feedback de Erros: Caso ocorra algum problema na comunicação com a API ou no processamento da mensagem, o frontend exibe uma mensagem de erro amigável, garantindo uma melhor experiência para o usuário.

⚙️ Setup do Projeto

Siga os passos abaixo para configurar e executar o projeto em seu ambiente local.

🌱 Backend (Java + Spring Boot)

1. Pré-requisitos

Antes de começar, garanta que você tenha:

✅ Java 17 (ou superior) instalado.
✅ Maven instalado.
✅ Conta no Pipefy, Calendly, OpenAI e Neon (ou outro provedor de PostgreSQL).
✅ Ngrok instalado para expor sua aplicação localmente.

2. Variáveis de Ambiente

O backend precisa de algumas chaves de API e URLs para funcionar. Você pode configurá-las como variáveis de ambiente no seu sistema ou diretamente na sua IDE.

Variável	Descrição	Exemplo
`PORT`	Porta que o Backend vai rodar.	`3000`
`FRONTEND_URL`	URL do frontend para permitir CORS.	`http://localhost:5173`
`DB_URL`	Connection string do seu banco de dados PostgreSQL.	`jdbc:postgresql://...`
`PIPEFY_TOKEN`	Token de API pessoal do Pipefy.	`eyJhbGciOi...`
`PIPEFY_PIPE_ID`	ID do seu pipe de "Pré-Vendas" no Pipefy.	`306752893`
`CALENDLY_TOKEN`	Token de API pessoal do Calendly.	`eyJraWQiOi...`
`CALENDLY_CALLBACK`	URL de webhook (via Ngrok) para receber eventos do Calendly.	`https://seu-dominio.ngrok-free.dev/calendly/webhook`
`OPENAI_TOKEN`	Chave de API da OpenAI.	`sk-proj-...`

3. Configuração dos Serviços Externos

📦 Pipefy

Crie um novo Pipe com o nome "Pré-Vendas".
Dentro do pipe, crie uma fase chamada "Pré-Vendas".
Clique em "+ Criar novo card" e adicione os seguintes campos, respeitando exatamente os nomes e tipos:
- Nome: Texto curto
- E-mail: E-mail
- Empresa: Texto curto
- Necessidade: Texto longo
- Interessado: Seleção de lista com as opções "Sim" e "Não".
- Link da Reunião: Texto Longo
- Hora da Reunião: Data e Hora
Vá em "Configurações do Pipe" e defina o campo "E-mail" como o título do card, o seu Card ao final deve ficar parecido com isso:
Obtenha seu Token de API em https://app.pipefy.com/tokens.
O PIPEFY_PIPE_ID pode ser encontrado na URL do seu pipe.

📅 Calendly

Crie uma conta e conecte-a ao seu Google Calendar.
Configure seus horários de disponibilidade (ex: 8:00 às 17:00).
Vá para "Integrations & Apps" > "API & Webhooks" para gerar seu CALENDLY_TOKEN.
Para o CALENDLY_CALLBACK, você precisará instalar o Ngrok https://ngrok.com/download/windows:
- Autentique-se no Ngrok (só precisa fazer uma vez):
```
ngrok config add-authtoken SEU_AUTH_TOKEN_AQUI
```
- Inicie o Ngrok para expor a porta da sua aplicação (padrão: 3000):
```
ngrok http 3000
```
- O Ngrok fornecerá uma URL pública (ex: https://xxxx.ngrok-free.dev). Use essa URL para montar seu CALENDLY_CALLBACK, adicionando o endpoint do webhook: https://xxxx.ngrok-free.dev/calendly/webhook.

🐘 PostgreSQL (Neon)

Crie uma conta gratuita no Neon https://neon.com/.
Crie um novo projeto.
Na dashboard do projeto, vá para a seção "Connection Details".
Copie a Connection String no formato Java e use-a para a variável DB_URL.

🧠 OpenAI

Crie uma conta na OpenAI.
Vá para a seção "API Keys" e crie uma nova chave secreta.

4. Como Rodar a Aplicação

Após configurar todas as variáveis de ambiente, você pode iniciar o backend:

# Navegue até a pasta do backend
cd Backend

# Execute a aplicação com o Maven
./mvnw spring-boot:run

Ou você pode simplismente abrir a pasta Backend no IntelliJ configurar as variáveis de ambiente e rodar, é bem mais fácil!

A aplicação estará rodando em http://localhost:3000.