Cover image
Try Now
2025-04-14

3 years

Works with Finder

0

Github Watches

0

Github Forks

0

Github Stars

WhatsApp Simulator - Sistema de Atendimento Automatizado

License Python Version Status

📱 Sobre o Projeto

Interface do Sistema

O WhatsApp Simulator é um sistema avançado de atendimento automatizado que simula a interface e funcionalidades do WhatsApp. Desenvolvido para empresas que desejam automatizar e melhorar seu atendimento ao cliente, o sistema oferece uma experiência familiar aos usuários enquanto proporciona ferramentas poderosas de automação.

🌟 Desenvolvedor

🚀 Funcionalidades

Interface do Usuário

  • 💬 Chat em tempo real
  • 🎤 Gravação e envio de áudio
  • 📷 Envio de imagens
  • 🔄 Status de conexão em tempo real
  • 🗑️ Gerenciamento de conversas

Processamento de Mídia

  • 🎵 Otimização automática de áudio
    • Formato MP3
    • Taxa de amostragem: 16kHz
    • Áudio mono
    • Limite de 30 segundos
    • Compressão inteligente
  • 🖼️ Otimização de imagens
    • Redimensionamento automático
    • Compressão JPEG
    • Qualidade adaptativa
    • Suporte a múltiplos formatos

Comunicação

  • 🔌 API Webhook
  • ⚡ Comunicação assíncrona
  • 🔒 Tratamento seguro de dados
  • 📊 Monitoramento de status

🛠️ Tecnologias Utilizadas

  • Python 3.8+
  • Tkinter - Interface gráfica
  • Requests - Comunicação HTTP
  • SoundDevice - Processamento de áudio
  • Pillow - Processamento de imagens
  • PyDub - Manipulação de áudio
  • NumPy - Processamento numérico
  • Base64 - Codificação de mídia

⚙️ Instalação

  1. Clone o repositório
git clone [[URL_DO_REPOSITÓRIO](https://github.com/Marcelohxt/whats-MCP-agent.git)]
cd MCP-WHATSAPP-main
  1. Crie um ambiente virtual
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows
  1. Instale as dependências
pip install -r requirements.txt

🚦 Uso

Exemplo de Uso

⚙️ Configuração

1. Meta Developer Portal

  1. Acesse Meta Developers
  2. Crie um novo app ou use um existente
  3. Adicione o produto "WhatsApp" ao seu app
  4. Configure o webhook
  5. Obtenha as credenciais necessárias

2. Variáveis de Ambiente

Edite o arquivo .env com suas configurações:

WHATSAPP_TOKEN=seu_token_aqui
VERIFY_TOKEN=seu_token_de_verificacao

3. Inicialização

  1. Inicie o servidor
python server.py
  1. Execute o simulador
python whatsapp_simulator.py
  1. Configure o Postman (para testes)
  • Importe a coleção de endpoints
  • Configure as variáveis de ambiente
  • Execute os testes disponíveis

📡 API Endpoints

POST /webhook

{
    "messages": [
        {
            "from": "5511930779357",
            "type": "text|audio|image",
            "body": "conteúdo_da_mensagem",
            "filename": "nome_do_arquivo"  // para mídia
        }
    ]
}

GET /api/status

  • Retorna o status atual do servidor

🔧 Configurações do Sistema

Configurações do Servidor

HOST = "localhost"
PORT = 8000
MAX_AUDIO_DURATION = 30  # segundos
MAX_FILE_SIZE = 5 * 1024 * 1024  # 5MB

Configurações de Mídia

AUDIO_SAMPLE_RATE = 16000
AUDIO_CHANNELS = 1
IMAGE_MAX_SIZE = (800, 800)
IMAGE_QUALITY = 85

🎯 Casos de Uso

  • Clínicas e Consultórios

    • Agendamento automatizado
    • Confirmação de consultas
    • Envio de resultados
  • Comércio

    • Atendimento ao cliente
    • Catálogo de produtos
    • Status de pedidos
  • Serviços

    • Orçamentos automáticos
    • Agendamento de serviços
    • Suporte técnico

📈 Roadmap

  • Integração com IA para respostas automáticas
  • Painel administrativo web
  • Análise de sentimentos
  • Relatórios e métricas
  • Integração com CRM
  • Suporte a múltiplos idiomas

🤝 Contribuição

Contribuições são bem-vindas! Para contribuir:

  1. Faça um Fork do projeto
  2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
  3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
  4. Push para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

📞 Suporte

Para suporte e dúvidas, entre em contato:

🙏 Agradecimentos

  • Equipe de desenvolvimento
  • Contribuidores
  • Usuários e testadores

Desenvolvido com ❤️ por Marcelo Henrique

⬆ Voltar ao topo

相关推荐

  • av
  • Effortlessly run LLM backends, APIs, frontends, and services with one command.

  • 1Panel-dev
  • 🔥 1Panel provides an intuitive web interface and MCP Server to manage websites, files, containers, databases, and LLMs on a Linux server.

  • WangRongsheng
  • 🧑‍🚀 全世界最好的LLM资料总结(数据处理、模型训练、模型部署、o1 模型、MCP、小语言模型、视觉语言模型) | Summary of the world's best LLM resources.

  • Byaidu
  • PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/MCP/Docker/Zotero

  • rulego
  • ⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.

  • sigoden
  • Easily create LLM tools and agents using plain Bash/JavaScript/Python functions.

  • hkr04
  • Lightweight C++ MCP (Model Context Protocol) SDK

  • RockChinQ
  • 😎简单易用、🧩丰富生态 - 大模型原生即时通信机器人平台 | 适配 QQ / 微信(企业微信、个人微信)/ 飞书 / 钉钉 / Discord / Telegram / Slack 等平台 | 支持 ChatGPT、DeepSeek、Dify、Claude、Gemini、xAI、PPIO、Ollama、LM Studio、阿里云百炼、火山方舟、SiliconFlow、Qwen、Moonshot、ChatGLM、SillyTraven、MCP 等 LLM 的机器人 / Agent | LLM-based instant messaging bots platform, supports Discord, Telegram, WeChat, Lark, DingTalk, QQ, Slack

  • dmayboroda
  • On-premises conversational RAG with configurable containers

  • paulwing
  • A test repository created using MCP service

    Reviews

    4 (1)
    Avatar
    user_lhWKaeJW
    2025-04-24

    The whats-MCP-agent by Marcelohxt is a phenomenal addition to the MCP application family. It offers seamless integration and easy navigation, making user interaction incredibly efficient. The interface is user-friendly, and the overall performance is top-notch. Highly recommended for anyone looking to streamline their workflow!