Explicação Técnica Completa do Projeto IntegrAI

1. Visão Geral da Arquitetura

O IntegrAI é um sistema modular que integra:

• WhatsApp (via Evolution API)
• Modelo de linguagem (LLM) (via Groq DeepSeek)
• Banco de dados (Django ORM/PostgreSQL)
• API Web (FastAPI)
• Processamento de áudio (transcrição com Groq Whisper)

O objetivo é criar um assistente inteligente que interaja com usuários via WhatsApp, entendendo comandos de texto e voz, mantendo histórico de conversas e podendo ser expandido para automações.

2. Fluxo de Processamento: Passo a Passo

2.1. Recebimento da Mensagem (Webhook)

• O Evolution API recebe mensagens do WhatsApp e encaminha para o endpoint /webhook do IntegrAI (FastAPI).
• O arquivo principal para isso é webhook.py.

Resumo do fluxo inicial:

1. O Evolution API faz um POST para /webhook com os dados da mensagem.
2. O FastAPI recebe a requisição e executa a função assíncrona webhook.

2.2. Processamento Inicial da Requisição

• O corpo da requisição é lido e convertido de JSON para dicionário Python.
• O código identifica se a mensagem é de texto ou áudio.