7.4 KiB
Transcrição e Resumo de Áudios no WhatsApp usando Python
Este projeto permite transcrever e resumir áudios enviados pelo WhatsApp usando inteligência artificial e integração com APIs. Ideal para automatizar o processamento de mensagens de áudio, oferecendo um resumo claro e prático.
📋 Pré-requisitos
Antes de começar, certifique-se de ter os seguintes requisitos:
- Python 3.10+ instalado (Download)
- Docker e Docker Compose instalados (Instruções)
- Uma conta Evolution API com chave válida
- Uma conta GROQ API com chave válida
⚙️ Setup Local
Ambiente Virtual
Configure o ambiente virtual para instalar as dependências do projeto:
Linux ou macOS
virtualenv venv
source ./venv/bin/activate
pip install -r requirements.txt
Windows
python -m venv .venv
source .venv/Scripts/activate
pip install -r requirements.txt
Para sair do ambiente virtual, use:
deactivate
🚀 Como Executar Localmente
Certifique-se de que todas as dependências foram instaladas. Rode o comando abaixo para iniciar o servidor:
uvicorn main:app --host 0.0.0.0 --port 8005
Acesse o serviço localmente em: http://127.0.0.1:8005/transcreve-audios. Insira este endereço na Evolution API para consumir as transcrições.
🌐 Configuração de Webhook na Evolution API
Endpoint para Webhook Use o seguinte endpoint para configurar seu webhook na Evolution API:
https://transcricaoaudio.seudominio.com.br/transcreve-audios
Testando Localmente
Se estiver rodando localmente, use o comando curl para testar:
curl --location 'http://127.0.0.1:8005/transcreve-audios'
🐳 Instalação com Docker Swarm e Traefik
Se preferir rodar o projeto em um ambiente de produção com Docker Swarm e Traefik, use o arquivo de configuração abaixo como referência.
docker-compose.yaml
version: "3.7"
services:
transcricaoaudio:
image: impacteai/transcrevezap:latest
build: .
networks:
- suarededocker #troque pela sua rede do docker
ports:
- 8005:8005
environment:
Uvicorn_port: 8005
Uvicorn_host: 0.0.0.0
Uvicorn_reload: "true"
Uvicorn_workers: 1
WHATSAPP_API_KEY: "substitua_sua_chave_aqui" #coloque sua api key evolution aqui
WHATSAPP_API_URL: "https://suaevolutionapi.sedominio.com.br/" #coloque sua url evolution aqui
WHATSAPP_INSTANCE: "substitua_sua_instancia_aqui" #coloque nome da sua instancia evolution aqui
GROQ_API_KEY: "substitua_sua_chave_GROQ_aqui" #coloque sua chave GROQ aqui
BUSINESS_MESSAGE: "substitua_sua_mensagem_de_servico_aqui" #coloque a mensagem que será enviada ao final da transcrição aqui
PROCESS_GROUP_MESSAGES: "false" # Define se mensagens de grupos devem ser processadas
deploy:
mode: replicated
replicas: 1
placement:
constraints:
- node.role == manager
labels:
- traefik.enable=true
- traefik.http.routers.transcricaoaudio.rule=Host(`transcricaoaudio.seudominio.com.br`) #coloque seu subdominio apontado aqui
- traefik.http.routers.transcricaoaudio.entrypoints=websecure
- traefik.http.routers.transcricaoaudio.tls.certresolver=letsencryptresolver
- traefik.http.services.transcricaoaudio.loadbalancer.server.port=8005
- traefik.http.services.transcricaoaudio.loadbalancer.passHostHeader=true
- traefik.http.routers.transcricaoaudio.service=transcricaoaudio
- traefik.http.middlewares.traefik-compress.compress=true
- traefik.http.routers.transcricaoaudio.middlewares=traefik-compress
resources:
limits:
cpus: "1"
memory: 1024M
networks:
suarededocker: #troque pela sua rede do docker
external: true
name: suarededocker #troque pela sua rede do docker
🐳 Rodando com Docker Compose (Sem Traefik)
Se você prefere rodar a aplicação em um ambiente simples, sem usar o Traefik para gerenciamento de subdomínios, siga as orientações abaixo.
1. Usando docker run diretamente
Execute o seguinte comando para rodar o contêiner:
docker run -d \
--name transcricaoaudio \
-p 8005:8005 \
-e Uvicorn_port=8005 \
-e Uvicorn_host=0.0.0.0 \
-e Uvicorn_reload="true" \
-e Uvicorn_workers=1 \
-e WHATSAPP_API_KEY="substitua_sua_chave_aqui" \
-e WHATSAPP_API_URL="https://suaevolutionapi.sedominio.com.br/" \
-e WHATSAPP_INSTANCE="substitua_sua_instancia_aqui" \
-e GROQ_API_KEY="substitua_sua_chave_GROQ_aqui" \
-e BUSINESS_MESSAGE="substitua_sua_mensagem_de_servico_aqui" \
-e PROCESS_GROUP_MESSAGES="false" \
impacteai/transcrevezap:latest
Usando docker-compose.yaml
Crie um arquivo chamado docker-compose.yaml com o seguinte conteúdo:
version: "3.7"
services:
transcricaoaudio:
image: impacteai/transcrevezap:latest
ports:
- 8005:8005
environment:
Uvicorn_port: 8005
Uvicorn_host: 0.0.0.0
Uvicorn_reload: "true"
Uvicorn_workers: 1
WHATSAPP_API_KEY: "substitua_sua_chave_aqui" # Coloque sua chave API Evolution aqui
WHATSAPP_API_URL: "https://suaevolutionapi.sedominio.com.br/" # URL da sua instância Evolution
WHATSAPP_INSTANCE: "substitua_sua_instancia_aqui" # Nome da sua instância Evolution
GROQ_API_KEY: "substitua_sua_chave_GROQ_aqui" # Chave da API GROQ
BUSINESS_MESSAGE: "substitua_sua_mensagem_de_servico_aqui" # Mensagem adicionada ao final da transcrição
PROCESS_GROUP_MESSAGES: "false" # Define se mensagens de grupos devem ser processadas
Para rodar com Docker Compose, execute:
docker-compose up -d
- Acessando o serviço
- Após rodar a aplicação, acesse: http://127.0.0.1:8005/transcreve-audios para ambiente local, inserindo este endereço na Evolution API. Você pode substituir 127.0.0.1 pelo IP ou domínio público, se configurado.
📖 Configuração das Variáveis de Ambiente
Ao usar o Docker Compose, configure as seguintes variáveis de ambiente no arquivo docker-compose.yaml:
| Variável | Descrição |
|---|---|
WHATSAPP_API_KEY |
Chave da API Evolution para integração com o WhatsApp. |
WHATSAPP_API_URL |
URL da sua instância da Evolution API. |
WHATSAPP_INSTANCE |
Nome da instância configurada na Evolution API. |
GROQ_API_KEY |
Chave da API GROQ para realizar transcrições e resumos de áudios. |
BUSINESS_MESSAGE |
Mensagem de divulgação que será adicionada ao final das transcrições. |
PROCESS_GROUP_MESSAGES |
Define se mensagens enviadas em grupos devem ser processadas (true) ou ignoradas (false). |
📄 Licença
Este projeto está licenciado sob a Licença MIT. Isso significa que você pode usar, modificar e distribuir este software livremente, desde que mantenha o aviso de copyright e a licença original em todas as cópias ou partes substanciais do software.
Você pode consultar o texto completo da licença no arquivo LICENSE.