MCP cover image
See in Github
2025-04-14

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

相关推荐

  • WangRongsheng
  • 🧑‍🚀 llm 资料总结(数据处理、模型训练、模型部署、 o1 模型、mcp 、小语言模型、视觉语言模型)|摘要世界上最好的LLM资源。

  • av
  • 毫不费力地使用一个命令运行LLM后端,API,前端和服务。

  • langgenius
  • 1Panel-dev
  • 🔥1Panel提供了直观的Web接口和MCP服务器,用于在Linux服务器上管理网站,文件,容器,数据库和LLMS。

  • alibaba
  • rulego
  • ⛓️Rulego是一种轻巧,高性能,嵌入式,下一代组件编排规则引擎框架。

  • Byaidu
  • PDF科学纸翻译带有保留格式的pdf -基于ai完整保留排版的pdf文档全文双语翻译

  • hkr04
  • 轻巧的C ++ MCP(模型上下文协议)SDK

  • lasso-security
  • 基于插件的网关,可协调其他MCP,并允许开发人员在IT企业级代理上构建。

  • nbonamy
  • Witsy:桌面AI助手

    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!