Wassenger

Servidor MCP Wassenger para conversar, enviar mensagens e automatizar o WhatsApp a partir de qualquer cliente de modelo de IA (teste gratuito disponível).

GitHub
5
Experimente este MCPPatrocinado

Documentação

Conector MCP Wassenger WhatsApp API NPM Version

🚀 Potencialize sua automação de WhatsApp com IA! Envie mensagens, resuma conversas e gerencie chats usando linguagem natural do seu assistente de IA favorito, como ChatGPT, Claude ou agentes de IA personalizados.

✨ Integre facilmente a Wassenger WhatsApp API com qualquer cliente de IA compatível com MCP, incluindo ChatGPT, VS Code Copilot, Claude Desktop, Cursor, Windsurf e muitos outros!

💬 Transforme sua comunicação - automatize respostas, analise padrões de conversa e gerencie conversas com clientes em escala, gerencie chats e grupos do WhatsApp, tudo através de comandos simples de texto ou voz com seu assistente de IA.

👉 Leia o post do blog apresentando o servidor MCP Wassenger

⚠️ Nota: Você só precisa usar este pacote se o seu cliente MCP não suportar streaming HTTP (anteriormente conhecido como conexão SSE). Para usar uma conexão HTTP remota, leia estas instruções.

Conteúdo

Sobre

Wassenger é uma solução versátil de Chat em Equipe e API para WhatsApp voltada a mensagens empresariais, permitindo automatizar qualquer coisa no WhatsApp.

Confira a documentação da API e exemplos aqui

Atualização do produto: 🚀 Automatize qualquer coisa no WhatsApp com nossa nova solução No-Code Wassenger Flows ⚡✨

Exemplos de prompts

Converse com suas conversas do WhatsApp a partir de qualquer cliente de IA ou integração com ferramentas de agente.

Aqui estão vários prompts que você pode usar com qualquer assistente de IA para interagir com o WhatsApp através do conector MCP Wassenger:

📱 Mensagens Básicas e Comunicação

  • "Envie uma mensagem de WhatsApp para +1234567890 dizendo 'Olá! Como você está hoje?'"
  • "Envie uma mensagem para o contato chamado 'João Silva' com o texto 'Reunião confirmada para as 15h'"
  • "Envie uma mensagem urgente para +44123456789: 'Por favor, me ligue de volta o mais rápido possível'"
  • "Envie uma mensagem de WhatsApp com uma imagem de [URL] para [número-de-telefone]"
  • "Responda à mensagem [id-da-mensagem] no chat [id-do-chat] com 'Obrigado pelo seu feedback!'"

📊 Análise de Conversas e Insights

  • "Resuma minhas últimas 10 mensagens de WhatsApp com +1555123456"
  • "Analise o tom da conversa no meu chat com o grupo Equipe de Marketing"
  • "Mostre os principais tópicos discutidos na minha conversa com a Sarah na última semana"
  • "Conte quantas mensagens recebi hoje de todos os contatos"
  • "Pesquise mensagens contendo 'fatura' no chat [id-do-chat]"
  • "Gere um relatório de atividade do chat agrupado por dia neste mês"

👥 Gerenciamento de Grupos e Equipes

  • "Crie um grupo de WhatsApp chamado 'Atualizações da Equipe' com os participantes +1234567890, +0987654321"
  • "Quantos participantes há no grupo de WhatsApp 'Projeto Time Alpha'?"
  • "Liste todos os membros do meu grupo 'Conversa em Família'"
  • "Adicione +1234567890 ao grupo de WhatsApp [id-do-grupo]"
  • "Torne +1234567890 administrador no grupo [id-do-grupo]"
  • "Obtenha o link de convite para o grupo [id-do-grupo]"

⏰ Agendamento de Mensagens e Automação

  • "Agende uma mensagem para +1234567890 dizendo 'Feliz Aniversário!' para ser enviada amanhã às 9h"
  • "Configure uma mensagem de lembrete para o grupo da equipe sobre a reunião na próxima sexta-feira às 14h"
  • "Configure respostas automáticas para mensagens recebidas fora do horário comercial (9h - 17h)"
  • "Crie um fluxo de trabalho: quando alguém enviar 'INFO', envie automaticamente o nosso folheto da empresa"

🔍 Gerenciamento de Contatos e Dispositivos

  • "Verifique se o número de telefone +1555987654 é um número válido de WhatsApp"
  • "Quais números de WhatsApp eu tenho conectados ao Wassenger?"
  • "Mostre o status de todos os meus dispositivos de WhatsApp"
  • "Obtenha as informações de perfil do contato +1234567890"
  • "Mostre todos os meus contatos recentes do último mês"

📈 Análises e Relatórios

  • "Gere um relatório dos meus contatos de WhatsApp mais frequentes neste mês"
  • "Mostre meus dias de conversa mais movimentados no WhatsApp nesta semana"
  • "Qual agente responde mais rápido às consultas dos clientes?"
  • "Mostre as tendências de volume de chat nos últimos 30 dias"
  • "Conte mensagens não lidas em todos os meus chats"
  • "Encontre clientes que não interagiram nos últimos 60 dias"

🔔 Status e Monitoramento

  • "Verifique o status de entrega da minha última mensagem para +1234567890"
  • "Mostre todas as falhas de entrega de mensagens de hoje"
  • "Monitore se meu contato +1555123456 leu minhas mensagens recentes"
  • "Publique 'Trabalhando em novos recursos interessantes!' como meu status do WhatsApp"

🔄 Operações em Massa e Campanhas

  • "Envie o mesmo anúncio para todos os membros do meu grupo 'Atualizações da Equipe' individualmente"
  • "Transmita uma saudação de feriado para meus 10 números mais contatados"
  • "Crie uma campanha chamada 'Série de Boas-Vindas' para enviar 'Bem-vindo ao nosso serviço!' para vários contatos"
  • "Inicie a campanha [id-da-campanha] e verifique seu status de entrega"

🎯 Automação Inteligente para Negócios

  • "Crie uma etiqueta chamada 'Cliente VIP' com cor vermelha e aplique-a em chats importantes"
  • "Atribua o chat [id-do-chat] ao agente [id-do-agente]"
  • "Mostre todos os chats com a etiqueta 'suporte'"
  • "Analise o sentimento nas conversas de suporte ao cliente e sinalize as negativas"
  • "Gere um relatório CSV de todos os chats com sua última atividade"
  • "Encontre todas as mensagens não lidas nos meus chats de WhatsApp"

🔐 Gerenciamento de Conta e Arquivos

  • "Mostre meu uso e limites atuais da conta Wassenger"
  • "Envie uma imagem de [url-da-imagem] para usar em mensagens de WhatsApp"
  • "Liste todos os arquivos enviados marcados como 'marketing'"
  • "Exporte todos os contatos do dispositivo [id-do-dispositivo] para JSON"

Esses prompts cobrem cenários reais para empresas que usam WhatsApp para atendimento ao cliente, marketing, colaboração em equipe e automação através da plataforma Wassenger.

Uso com streaming HTTP

Se o seu cliente MCP suporta streaming HTTP (anteriormente conhecido como transporte Server-Sent Events ou SSE), você pode conectar diretamente ao servidor MCP Wassenger sem instalar este pacote. Este é o método preferido, pois é mais rápido e não requer configuração local.

Clientes Suportados

A maioria dos clientes MCP modernos suporta streaming HTTP, incluindo:

  • Claude Desktop (versões mais recentes)
  • VS Code Copilot com extensão MCP
  • Cursor (v0.48.0+)
  • Windsurf
  • OpenAI Responses API
  • ChatGPT (usuários Pro têm acesso; em breve mais usuários)

Configuração do Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "wassenger": {
      "type": "http",
      "url": "https://api.wassenger.com/mcp?key=YOUR_WASSENGER_API_KEY"
    }
  }
}

Ou usando variáveis de ambiente:

{
  "mcpServers": {
    "wassenger": {
      "type": "http",
      "url": "https://api.wassenger.com/mcp?key=${WASSENGER_API_KEY}",
      "env": {
        "WASSENGER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuração do VS Code Copilot

Nas configurações do VS Code (formato JSON):

{
  "mcp.servers": {
    "wassenger": {
      "url": "https://api.wassenger.com/mcp?key=YOUR_WASSENGER_API_KEY",
      "transport": "http-streaming"
    }
  }
}

Benefícios do Streaming HTTP

  • ✅ Sem instalação local necessária
  • ✅ Conexão mais rápida
  • ✅ Atualizações automáticas - sempre usa a versão mais recente do servidor
  • ✅ Maior confiabilidade - sem problemas de dependência do Node.js
  • ✅ Configuração mais simples - apenas uma URL

Obtendo sua Chave de API

  1. Cadastre-se em Wassenger.com
  2. Acesse suas configurações de API
  3. Copie sua chave de API
  4. Substitua YOUR_WASSENGER_API_KEY na configuração acima

Ferramentas MCP Suportadas

O servidor MCP Wassenger fornece ferramentas abrangentes de automação de WhatsApp organizadas em categorias funcionais. Todas as ferramentas usam parâmetros baseados em ações para interações amigáveis com LLMs:

📱 Mensagens e Comunicação Principal

  • manage_whatsapp_messages - Envio universal de mensagens com 11 tipos de ação: texto, mídia, localização, contato, enquete, evento, agendada, ao vivo, expirante, agente e mensagens de modelo
  • manage_whatsapp_message_interactions - Interações com mensagens: responder, encaminhar, reagir e votar em enquetes
  • get_whatsapp_chat_messages - Recuperação abrangente de mensagens: recentes, pesquisa, intervalo de datas, por remetente, por tipo, por ID, pesquisa avançada, contexto de tópico e filtragem de mídia
  • analyze_whatsapp_chat_messages - Análises de mensagens: estatísticas, rastreamento de status de entrega e exportação de dados em vários formatos

💬 Gerenciamento de Chats e Conversas

  • get_whatsapp_chats - Recuperação universal de chats com 9 ações: recentes, não lidos, por status, atribuídos, por tipo de contato, por ID, pesquisa, arquivados e filtragem por intervalo de datas
  • analyze_whatsapp_chats - Análises e exportação de chats com estatísticas abrangentes e recursos de exportação de dados
  • search_whatsapp_chats_by_name - Pesquisa rápida de chats por nome de contato, nome de grupo ou nome de canal

👥 Gerenciamento de Grupos e Equipes

  • manage_whatsapp_groups - Operações completas de grupo: pesquisa, criação, atualização, entrada, saída, gerenciamento de convites com 8 tipos de ação
  • manage_whatsapp_group_participants - Gerenciamento de participantes: adicionar, remover, promover, rebaixar, fluxo de aprovação com 7 tipos de ação
  • manage_whatsapp_team - Gerenciamento de membros da equipe: pesquisa, criação, atualização, exclusão, controle de acesso a dispositivos com 7 tipos de ação
  • manage_whatsapp_departments - Organização de departamentos: listar, criar, atualizar, excluir com atribuições de agentes e personalização visual

📺 Canais e Transmissão

  • manage_whatsapp_channels - Gerenciamento do ciclo de vida de canais: listar, criar, atualizar, pesquisar, entrar, sair, atualizações de imagem com 9 tipos de ação
  • manage_whatsapp_channel_messages - Recuperação de mensagens de canal com filtragem e paginação
  • manage_whatsapp_status - Gerenciamento de Status do WhatsApp (Stories): obter, publicar, agendar com suporte a mídia e agendamento avançado

🔄 Campanhas e Operações em Massa

  • manage_whatsapp_campaigns - Campanhas de mensagens em massa: pesquisa, criação, atualização, início, parada, exclusão com 7 tipos de ação
  • manage_whatsapp_campaign_contacts - Gerenciamento de destinatários de campanha: pesquisa, adição, remoção de contatos com opções de filtragem
  • manage_whatsapp_queue - Controle de fila de mensagens: monitoramento de status, gerenciamento de fila, exclusão em massa com 3 tipos de ação

📱 Gerenciamento de Dispositivos e Contas

  • get_whatsapp_devices - Listagem de dispositivos com filtros avançados: status, sessão, busca, filtros de ativo/online
  • get_whatsapp_device_details - Informações detalhadas do dispositivo: configuração, status da sessão, métricas e insights
  • health_check - Verificação abrangente de saúde do sistema para o servidor MCP e dispositivos WhatsApp conectados

👤 Gerenciamento de Contatos e Etiquetas

  • manage_whatsapp_contacts - Operações CRUD de contatos: listar, obter, criar, atualizar, excluir, operações em lote, gerenciamento de metadados com 8 tipos de ação
  • manage_whatsapp_contact_actions - Bloqueio de contatos: operações de bloquear e desbloquear
  • manage_whatsapp_labels - Gerenciamento de etiquetas: listar, criar, atualizar, excluir com organização por código de cores

📁 Gerenciamento de Arquivos e Mídia

  • search_whatsapp_outbound_files - Busca de arquivos enviados com filtros avançados por tipo, tamanho, data, tags e metadados
  • search_whatsapp_chat_files - Busca de arquivos recebidos de conversas do WhatsApp com opções abrangentes de filtragem

🔧 Sistema e Utilitários

  • ping - Teste básico de conectividade com status do servidor e medição de tempo de resposta

Uso

Todos os clientes MCP mais populares (Claude Desktop, VS Code Copilot, Cursor, Windsurf...) usam o seguinte formato de configuração:

{
  "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-wassenger",
        "api-key-goes-here"
      ]
    }
  }
}

Cabeçalhos Personalizados

Para contornar a autenticação, ou para emitir cabeçalhos personalizados em todas as solicitações ao seu servidor remoto, passe os argumentos de CLI --header:

{
  "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-wassenger",
        "${WASSENGER_API}"
      ],
      "env": {
        "WASSENGER_API": "..."
      }
    },
  }
}

Nota: Cursor e Claude Desktop (Windows) têm um bug onde espaços dentro de args não são escapados quando ele invoca npx, o que acaba corrompendo esses valores. Você pode contornar isso usando:

{
  // rest of config...
  "args": [
    "mcp-wassenger",
    "${WASSENGER_API}"
  ],
  "env": {
    "WASSENGER_API": "<wassenger-api-get-here>"
  }
},

Uso como ferramenta no OpenAI

Veja como você pode usar o servidor MCP Wassenger como uma ferramenta com o cliente JavaScript da OpenAI:

import OpenAI from 'openai';

const wassengerKey = process.env.WASSENGER_API_KEY || 'wassenger-api-key-here'

const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
});

// Example: Send a WhatsApp message using OpenAI's new Responses API with MCP
const response = await openai.responses.create({
  model: 'o4-mini',
  tools: [
    {
      type: 'mcp',
      server_label: 'wassenger',
      server_url: `https://api.wassenger.com/mcp?key=${wassengerKey}`,
      require_approval: 'never'
    }
  ],
  input: 'Send a WhatsApp message to +1234567890 saying "Hello from AI!"'
});

console.log('Response:', response);

Certifique-se de instalar as dependências necessárias:

npm install openai

E defina suas variáveis de ambiente:

export OPENAI_API_KEY="your-openai-api-key"
export WASSENGER_API_KEY="your-wassenger-api-key"

Esta abordagem usa a nova API Responses da OpenAI com integração MCP, que automaticamente lida com descoberta de ferramentas, execução e comunicação com o servidor MCP Wassenger sem exigir configuração manual do cliente MCP.

Flags

  • Se npx estiver produzindo erros, considere adicionar -y como primeiro argumento para aceitar automaticamente a instalação do pacote mcp-wassenger.
      "command": "npx",
      "args": [
        "-y"
        "mcp-wassenger",
        "API_KEY_GOES_HERE"
      ]
  • Para forçar npx a sempre verificar se há uma versão atualizada de mcp-wassenger, adicione a flag @latest:
      "args": [
        "mcp-wassenger@latest"
      ]
  • Para alterar em qual porta mcp-wassenger escuta um redirecionamento OAuth (por padrão 3334), adicione um argumento adicional após a URL do servidor. Observe que, independentemente da porta que você especificar, se ela estiver indisponível, uma porta aberta será escolhida aleatoriamente.
      "args": [
        "mcp-wassenger",
        "API_KEY_GOES_HERE"
      ]
  • Para habilitar logs detalhados de depuração, adicione a flag --debug. Isso gravará logs detalhados em ~/.mcp-auth/{server_hash}_debug.log com carimbos de data/hora e informações detalhadas sobre o processo de autenticação, conexões e renovação de tokens.
      "args": [
        "mcp-wassenger",
        "API_KEY_GOES_HERE",
        "--debug"
      ]

Claude Desktop

Official Docs

In order to add an MCP server to Claude Desktop you need to edit the configuration file located at:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

If it does not exist yet, you may need to enable it under Settings > Developer.

Restart Claude Desktop to pick up the changes in the configuration file. Upon restarting, you should see a hammer icon in the bottom right corner of the input box.

VS Code Extension / Copilot

Official Docs. Add MCP servers through VS Code settings or via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) by searching for "MCP". Configuration is managed through VS Code's settings interface.

Cursor

Official Docs. The configuration file is located at ~/.cursor/mcp.json.

As of version 0.48.0, Cursor supports unauthed SSE servers directly. If your MCP server is using the official MCP OAuth authorization protocol, you still need to add a "command" server and call mcp-wassenger.

Windsurf

Official Docs. The configuration file is located at ~/.codeium/windsurf/mcp_config.json.

Cline

Official Docs. The configuration file is located at ~/.cline/mcp_servers.json.

Continue.dev

Official Docs. The configuration file is located at ~/.continue/config.json. Continue.dev supports MCP servers for enhanced code context and AI-powered development workflows.

Zed Editor

Official Docs. Configure MCP servers in Zed's settings to extend the AI assistant capabilities. Zed provides native MCP integration for seamless development experience.

Jan AI

Official Docs. Jan AI supports MCP servers through its extension system, allowing you to integrate external tools and data sources with local AI models.

Open WebUI

Official MCP Integration. Open WebUI provides MCP support for connecting external tools and services to your self-hosted AI interface, enabling powerful workflow automation.

Sourcegraph Cody

Official Docs. Cody supports MCP integration for enhanced code understanding and AI-assisted development across your entire codebase.

OpenAI Responses API

You can use the Wassenger MCP server as a tool with OpenAI's new Responses API, which provides native MCP integration without requiring manual client setup.

JavaScript Example

import OpenAI from 'openai';

const wassengerKey = process.env.WASSENGER_API_KEY || 'your-wassenger-api-key';

const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
});

// Send a WhatsApp message using OpenAI's Responses API with MCP
const response = await openai.responses.create({
  model: 'o1-mini',
  tools: [
    {
      type: 'mcp',
      server_label: 'wassenger',
      server_url: `https://api.wassenger.com/mcp?key=${wassengerKey}`,
      require_approval: 'never'
    }
  ],
  input: 'Send a WhatsApp message to +1234567890 saying "Hello from AI!"'
});

console.log('Response:', response);

Python Example

import os
from openai import OpenAI

wassenger_key = os.getenv('WASSENGER_API_KEY', 'your-wassenger-api-key')

client = OpenAI(
    api_key=os.getenv('OPENAI_API_KEY')
)

# Send a WhatsApp message using OpenAI's Responses API with MCP
response = client.responses.create(
    model='o1-mini',
    tools=[
        {
            'type': 'mcp',
            'server_label': 'wassenger',
            'server_url': f'https://api.wassenger.com/mcp?key={wassenger_key}',
            'require_approval': 'never'
        }
    ],
    input='Send a WhatsApp message to +1234567890 saying "Hello from AI!"'
)

print('Response:', response)

Installation

Make sure to install the required dependencies:

JavaScript:

npm install openai

Python:

pip install openai

Environment Variables

Set your API keys as environment variables:

export OPENAI_API_KEY="your-openai-api-key"
export WASSENGER_API_KEY="your-wassenger-api-key"

This approach uses OpenAI's native MCP integration, which automatically handles tool discovery, execution, and communication with the Wassenger MCP server without requiring manual MCP client configuration.

Solução de Problemas

Limpe seu diretório ~/.mcp-auth

mcp-wassenger armazena todas as informações de credenciais dentro de ~/.mcp-auth (ou onde quer que seu MCP_REMOTE_CONFIG_DIR aponte). Se você estiver tendo problemas persistentes, tente executar:

rm -rf ~/.mcp-auth

Em seguida, reinicie seu cliente MCP.

Verifique sua versão do Node

Certifique-se de que a versão do Node que você tem instalada seja 18 ou superior. O Claude Desktop usará a versão do Node do seu sistema, mesmo se você tiver uma versão mais nova instalada em outro lugar.

Reinicie o Claude

Ao modificar claude_desktop_config.json, pode ser útil reiniciar completamente o Claude

Certificados VPN

Você pode encontrar problemas se estiver atrás de uma VPN; você pode tentar definir a variável de ambiente NODE_EXTRA_CA_CERTS para apontar para o arquivo de certificado CA. Se estiver usando claude_desktop_config.json, isso pode parecer:

{
 "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-wassenger",
        "API_KEY_GOES_HERE"
      ],
      "env": {
        "NODE_EXTRA_CA_CERTS": "{your CA certificate file path}.pem"
      }
    }
  }
}

Verifique os logs

  • Siga os logs do Claude Desktop em tempo real
  • MacOS / Linux:
    tail -n 20 -F ~/Library/Logs/Claude/mcp*.log
  • Para bash no WSL:
    tail -n 20 -f "C:\Users\YourUsername\AppData\Local\Claude\Logs\mcp.log"
  • Powershell:
    Get-Content "C:\Users\YourUsername\AppData\Local\Claude\Logs\mcp.log" -Wait -Tail 20

Depuração

Logs de Depuração

Para solucionar problemas complexos, especialmente com renovação de tokens ou problemas de autenticação, use a flag --debug:

"args": [
  "mcp-wassenger",
  "API_KEY_GOES_HERE",
  "--debug"
]

Isso cria logs detalhados em ~/.mcp-auth/{server_hash}_debug.log com carimbos de data/hora e informações completas sobre cada etapa do processo de conexão e autenticação. Quando você encontrar problemas com renovação de tokens, problemas de suspensão/retomada do laptop ou problemas de autenticação, forneça esses logs ao buscar suporte.

Erros de Autenticação

Se você encontrar o seguinte erro, retornado pela URL /callback:

Authentication Error
Token exchange failed: HTTP 400

Você pode executar rm -rf ~/.mcp-auth para limpar qualquer estado e tokens armazenados localmente.

Modo "Cliente"

Execute o seguinte na linha de comando (não a partir de um servidor MCP):

npx -p mcp-wassenger@latest mcp-wassenger-client API_KEY_GOES_HERE

Isso executará todo o fluxo de autorização e tentará listar as ferramentas e recursos na URL remota. Tente isso após executar rm -rf ~/.mcp-auth para ver se credenciais desatualizadas são o seu problema; caso contrário, esperamos que o problema fique mais óbvio nesses logs do que nos do seu cliente MCP.

Licença

MIT