What is Envio Mensagem Whatsapp

envio-mensagem-whatsapp is an MCP server designed for sending messages and files via WhatsApp using the Evolution API.

Use cases

Use cases include sending promotional messages to customers, automating responses in customer service, and sharing important documents or media with users via WhatsApp.

How to use

To use envio-mensagem-whatsapp, access the server page on Smithery, configure the API URL, API key, and optionally the WhatsApp instance name. For local installation, clone the repository, install dependencies, and set up the API URL and key using environment variables or directly in the code.

Key features

Key features include sending individual text messages, batch text messages with configurable intervals, sending media files (images, videos, documents, audio), batch media file sending with configurable intervals, and checking the status of WhatsApp instances.

Where to use

envio-mensagem-whatsapp can be used in various fields such as customer support, marketing campaigns, and automated notifications where WhatsApp messaging is beneficial.

Servidor MCP para WhatsApp

Este projeto implementa um servidor MCP (Multi-Cloud Protocol) para envio de mensagens e arquivos via WhatsApp utilizando a Evolution API.

Funcionalidades

• Envio de mensagens de texto para números individuais
• Envio de mensagens de texto em lote com intervalo configurável
• Envio de arquivos de mídia (imagem, vídeo, documento, áudio)
• Envio de arquivos de mídia em lote com intervalo configurável
• Verificação de status de instâncias do WhatsApp

Uso no Smithery

Este servidor está disponível no Smithery, permitindo que você utilize-o sem precisar instalar ou configurar nada localmente. Para usar através do Smithery:

1. Acesse a página do servidor no Smithery
2. Configure as seguintes opções:
   • URL da API Evolution: URL da sua instância da Evolution API
   • Chave da API: Sua chave de API da Evolution
   • Nome da Instância: (Opcional) Nome da instância do WhatsApp que você deseja usar

Todas as chamadas de API serão processadas com segurança no ambiente do Smithery.

Instalação Local

Requisitos

• Python 3.8+
• Biblioteca httpx
• Biblioteca asyncio
• Framework fastmcp
• Uma instância do Evolution API em execução

Passo a Passo

1. Clone este repositório:

git clone https://github.com/mariltonleal/envio-mensagem-whatsapp.git
cd envio-mensagem-whatsapp

2. Instale as dependências:

pip install -r requirements.txt

Configuração

1. Configure a URL da API e sua chave de API usando variáveis de ambiente:

export BASE_API_URL="https://sua-instancia-evolution-api.com"
export API_KEY="sua-chave-api"
export DEFAULT_INSTANCE="nome-da-instancia"

2. Ou modifique diretamente no arquivo envio_mensagem.py:

BASE_API_URL = "https://sua-instancia-evolution-api.com"
API_KEY = "sua-chave-api"
DEFAULT_INSTANCE = "nome-da-instancia"

3. Certifique-se de que sua instância do Evolution API esteja configurada e em execução.

Uso Local

Iniciar o servidor

python envio_mensagem.py

Exemplos de uso

Enviar mensagem de texto

await send_whatsapp_message("5511999999999", "Olá, esta é uma mensagem de teste!")

Enviar mensagens em lote

numeros = ["5511999999999", "5521888888888", "5531777777777"]
await send_whatsapp_with_interval(numeros, "Mensagem em lote de teste", interval_seconds=5)

Enviar mídia

await send_whatsapp_media("5511999999999", "https://exemplo.com/imagem.jpg", "image")

Verificar status da instância

status = await check_instance_status()
print(status)

Funções disponíveis

• send_whatsapp_message: Envia uma mensagem de texto para um número
• send_whatsapp_with_interval: Envia mensagens para múltiplos números com intervalo
• send_whatsapp_media: Envia mídia para um número
• send_whatsapp_media_with_interval: Envia mídia para múltiplos números com intervalo
• check_instance_status: Verifica o status de uma instância WhatsApp

Deployment no Smithery

Este servidor pode ser facilmente implantado no Smithery para permitir que outros usuários utilizem-no através de WebSockets. Para configurar o deployment:

1. Certifique-se de que o repositório contenha os arquivos Dockerfile e smithery.yaml
2. Adicione seu servidor ao Smithery ou reivindique-o se já estiver listado
3. Clique em “Deploy” na aba Smithery Deployments na página do seu servidor

O Smithery criará um playground para seu servidor, permitindo que usuários o testem online sem instalar dependências.

Segurança

⚠️ Importante: Não compartilhe sua chave API ou credenciais em repositórios públicos.

Licença

Este projeto é distribuído sob a licença MIT.