Wassenger

Servidor MCP de Wassenger para chatear, enviar mensajes y automatizar WhatsApp desde cualquier cliente de modelo de IA (prueba gratuita disponible).

GitHub
6

Documentación

Conector MCP Wassenger WhatsApp API NPM Version

🚀 ¡Potencia tu automatización de WhatsApp impulsada por IA! Envía mensajes, resume conversaciones y gestiona chats usando lenguaje natural desde tu asistente de IA favorito como ChatGPT, Claude o agentes de IA personalizados.

✨ Integra fácilmente Wassenger WhatsApp API con cualquier cliente de IA compatible con MCP, incluyendo ChatGPT, VS Code Copilot, Claude Desktop, Cursor, Windsurf y muchos más!

💬 Transforma tu forma de comunicarte - automatiza respuestas, analiza patrones de conversación y gestiona conversaciones con clientes a escala, administra chats y grupos de WhatsApp, todo mediante comandos conversacionales simples de texto o voz con tu asistente de IA.

👉 Lee la publicación del blog que presenta el servidor MCP de Wassenger

⚠️ Nota: Solo necesitas usar este paquete si tu cliente MCP no admite transmisión HTTP (anteriormente conocida como conexión SSE). Para usar una conexión HTTP remota, lee estas instrucciones.

Contenido

Acerca de

Wassenger es una solución versátil de Chat de Equipo y API de WhatsApp para mensajería empresarial, que permite automatizar cualquier cosa en WhatsApp.

Consulta la documentación de la API y ejemplos aquí

Actualización del producto: 🚀 Automatiza cualquier cosa en WhatsApp con nuestra nueva solución No-Code Wassenger Flows ⚡✨

Ejemplos de indicaciones

Conversa con tus conversaciones de WhatsApp desde cualquier cliente de IA o integración de herramientas agénticas.

Aquí hay varias indicaciones que puedes usar con cualquier asistente de IA para interactuar con WhatsApp a través del conector MCP de Wassenger:

📱 Mensajería y comunicación básica

  • "Envía un mensaje de WhatsApp a +1234567890 diciendo '¡Hola! ¿Cómo estás hoy?'"
  • "Envía un mensaje al contacto llamado 'Juan Pérez' con el texto 'Reunión confirmada para las 3 PM'"
  • "Envía un mensaje urgente a +44123456789: 'Por favor, llámame de vuelta lo antes posible'"
  • "Envía un mensaje de WhatsApp con una imagen desde [URL] al [número de teléfono]"
  • "Responde al mensaje [ID de mensaje] en el chat [ID de chat] con '¡Gracias por tus comentarios!'"

📊 Análisis e información de conversaciones

  • "Resume mis últimos 10 mensajes de WhatsApp con +1555123456"
  • "Analiza el tono de la conversación en mi chat con el grupo del Equipo de Marketing"
  • "Muéstrame los temas clave discutidos en mi conversación con Sara durante la última semana"
  • "Cuenta cuántos mensajes he recibido hoy de todos los contactos"
  • "Busca mensajes que contengan 'factura' en el chat [ID de chat]"
  • "Genera un informe de actividad del chat agrupado por día para este mes"

👥 Gestión de grupos y equipos

  • "Crea un grupo de WhatsApp llamado 'Actualizaciones del Equipo' con los participantes +1234567890, +0987654321"
  • "¿Cuántos participantes hay en el grupo de WhatsApp 'Equipo Proyecto Alfa'?"
  • "Lista todos los miembros de mi grupo 'Chat Familiar'"
  • "Agrega +1234567890 al grupo de WhatsApp [ID de grupo]"
  • "Haz a +1234567890 administrador en el grupo [ID de grupo]"
  • "Obtén el enlace de invitación para el grupo [ID de grupo]"

⏰ Programación de mensajes y automatización

  • "Programa un mensaje a +1234567890 diciendo '¡Feliz cumpleaños!' para enviarlo mañana a las 9 AM"
  • "Configura un mensaje de recordatorio para el grupo del equipo sobre la reunión el próximo viernes a las 2 PM"
  • "Configura respuestas automáticas para mensajes recibidos fuera del horario laboral (9 AM - 5 PM)"
  • "Crea un flujo de trabajo: cuando alguien envíe 'INFO', envía automáticamente nuestro folleto de la empresa"

🔍 Gestión de contactos y dispositivos

  • "Verifica si el número de teléfono +1555987654 es un número de WhatsApp válido"
  • "¿Qué números de WhatsApp tengo conectados a Wassenger?"
  • "Muéstrame el estado de todos mis dispositivos de WhatsApp"
  • "Obtén la información de perfil del contacto +1234567890"
  • "Muéstrame todos mis contactos recientes del último mes"

📈 Analítica e informes

  • "Genera un informe de mis contactos de WhatsApp más frecuentes este mes"
  • "Muéstrame mis días de conversación de WhatsApp más ocupados esta semana"
  • "¿Qué agente responde más rápido a las consultas de los clientes?"
  • "Muéstrame las tendencias de volumen de chat en los últimos 30 días"
  • "Cuenta los mensajes no leídos en todos mis chats"
  • "Encuentra clientes que no han interactuado en los últimos 60 días"

🔔 Estado y monitoreo

  • "Verifica el estado de entrega de mi último mensaje a +1234567890"
  • "Muéstrame todas las entregas de mensajes fallidas de hoy"
  • "Monitorea si mi contacto +1555123456 ha leído mis mensajes recientes"
  • "Publica '¡Trabajando en nuevas funciones emocionantes!' como mi estado de WhatsApp"

🔄 Operaciones masivas y campañas

  • "Envía el mismo anuncio a todos los miembros de mi grupo 'Actualizaciones del Equipo' individualmente"
  • "Transmite un saludo navideño a mis 10 números más contactados"
  • "Crea una campaña llamada 'Serie de Bienvenida' para enviar '¡Bienvenido a nuestro servicio!' a múltiples contactos"
  • "Inicia la campaña [ID de campaña] y verifica su estado de entrega"

🎯 Automatización empresarial inteligente

  • "Crea una etiqueta llamada 'Cliente VIP' con color rojo y aplícala a chats importantes"
  • "Asigna el chat [ID de chat] al agente [ID de agente]"
  • "Muéstrame todos los chats con la etiqueta 'soporte'"
  • "Analiza el sentimiento en las conversaciones de atención al cliente y marca las negativas"
  • "Genera un informe CSV de todos los chats con su última actividad"
  • "Encuentra todos los mensajes no leídos en mis chats de WhatsApp"

🔐 Gestión de cuenta y archivos

  • "Muéstrame mi uso y límites actuales de la cuenta de Wassenger"
  • "Sube una imagen desde [URL de imagen] para usarla en mensajes de WhatsApp"
  • "Lista todos los archivos subidos etiquetados como 'marketing'"
  • "Exporta todos los contactos del dispositivo [ID de dispositivo] a JSON"

Estas indicaciones cubren escenarios del mundo real para empresas que usan WhatsApp para servicio al cliente, marketing, colaboración en equipo y automatización a través de la plataforma Wassenger.

Uso de transmisión HTTP

Si tu cliente MCP admite transmisión HTTP (anteriormente conocida como Server-Sent Events o transporte SSE), puedes conectarte directamente al servidor MCP de Wassenger sin instalar este paquete. Este es el método preferido, ya que es más rápido y no requiere configuración local.

Clientes compatibles

La mayoría de los clientes MCP modernos admiten transmisión HTTP, incluyendo:

  • Claude Desktop (versiones más recientes)
  • VS Code Copilot con extensión MCP
  • Cursor (v0.48.0+)
  • Windsurf
  • API de Respuestas de OpenAI
  • ChatGPT (los usuarios Pro tienen acceso, pronto más usuarios)

Configuración de Claude Desktop

Agrega esto a tu claude_desktop_config.json:

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

O usando variables de entorno:

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

Configuración de VS Code Copilot

En la configuración de VS Code (formato JSON):

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

Beneficios de la transmisión HTTP

  • ✅ Sin instalación local requerida
  • ✅ Conexión más rápida
  • ✅ Actualizaciones automáticas - siempre usa la versión más reciente del servidor
  • ✅ Mayor confiabilidad - sin problemas de dependencias de Node.js
  • ✅ Configuración más simple - solo una URL

Cómo obtener tu clave API

  1. Regístrate en Wassenger.com
  2. Ve a tu configuración de API
  3. Copia tu clave API
  4. Reemplaza YOUR_WASSENGER_API_KEY en la configuración anterior

Herramientas MCP compatibles

El servidor MCP de Wassenger proporciona herramientas integrales de automatización de WhatsApp organizadas en categorías funcionales. Todas las herramientas usan parámetros basados en acciones para interacciones amigables con LLM:

📱 Mensajería y comunicación principal

  • manage_whatsapp_messages - Envío universal de mensajes con 11 tipos de acción: mensajería de texto, medios, ubicación, contacto, encuesta, evento, programada, en vivo, efímera, agente y plantilla
  • manage_whatsapp_message_interactions - Interacciones con mensajes: responder, reenviar, reacción y votación en encuestas
  • get_whatsapp_chat_messages - Recuperación integral de mensajes: recientes, búsqueda, rango de fechas, por remitente, por tipo, por ID, búsqueda avanzada, contexto de hilo y filtrado de medios
  • analyze_whatsapp_chat_messages - Analítica de mensajes: estadísticas, seguimiento de estado de entrega y exportación de datos en múltiples formatos

💬 Gestión de chats y conversaciones

  • get_whatsapp_chats - Recuperación universal de chats con 9 acciones: recientes, no leídos, por estado, asignados, por tipo de contacto, por ID, búsqueda, archivados y filtrado por rango de fechas
  • analyze_whatsapp_chats - Analítica y exportación de chats con estadísticas integrales y capacidades de exportación de datos
  • search_whatsapp_chats_by_name - Búsqueda rápida de chats por nombre de contacto, nombre de grupo o nombre de canal

👥 Gestión de grupos y equipos

  • manage_whatsapp_groups - Operaciones completas de grupos: búsqueda, creación, actualización, unirse, salir, gestión de invitaciones con 8 tipos de acción
  • manage_whatsapp_group_participants - Gestión de participantes: agregar, eliminar, ascender, degradar, flujo de aprobación con 7 tipos de acción
  • manage_whatsapp_team - Gestión de miembros del equipo: búsqueda, creación, actualización, eliminación, control de acceso a dispositivos con 7 tipos de acción
  • manage_whatsapp_departments - Organización de departamentos: listar, crear, actualizar, eliminar con asignaciones de agentes y personalización visual

📺 Canales y transmisión

  • manage_whatsapp_channels - Gestión del ciclo de vida de canales: listar, crear, actualizar, buscar, unirse, salir, actualizaciones de imagen con 9 tipos de acción
  • manage_whatsapp_channel_messages - Recuperación de mensajes de canal con filtrado y paginación
  • manage_whatsapp_status - Gestión de Estado de WhatsApp (Historias): obtener, publicar, programar con soporte de medios y temporización avanzada

🔄 Campañas y operaciones masivas

  • manage_whatsapp_campaigns - Campañas de mensajería masiva: búsqueda, creación, actualización, inicio, detención, eliminación con 7 tipos de acción
  • manage_whatsapp_campaign_contacts - Gestión de destinatarios de campaña: búsqueda, agregar, eliminar contactos con opciones de filtrado
  • manage_whatsapp_queue - Control de cola de mensajes: monitoreo de estado, gestión de cola, eliminación masiva con 3 tipos de acción

📱 Gestión de Dispositivos y Cuentas

  • get_whatsapp_devices - Listado de dispositivos con filtros avanzados: estado, sesión, búsqueda, filtrado por activo/en línea
  • get_whatsapp_device_details - Información detallada del dispositivo: configuración, estado de sesión, métricas y perspectivas
  • health_check - Verificación integral de salud del sistema para el servidor MCP y los dispositivos WhatsApp conectados

👤 Gestión de Contactos y Etiquetas

  • manage_whatsapp_contacts - Operaciones CRUD de contactos: listar, obtener, crear, actualizar, eliminar, operaciones masivas, gestión de metadatos con 8 tipos de acción
  • manage_whatsapp_contact_actions - Bloqueo de contactos: operaciones de bloquear y desbloquear
  • manage_whatsapp_labels - Gestión de etiquetas: listar, crear, actualizar, eliminar con organización codificada por colores

📁 Gestión de Archivos y Medios

  • search_whatsapp_outbound_files - Búsqueda de archivos subidos con filtrado avanzado por tipo, tamaño, fecha, etiquetas y metadatos
  • search_whatsapp_chat_files - Búsqueda de archivos recibidos de chats de WhatsApp con opciones de filtrado exhaustivas

🔧 Sistema y Utilidades

  • ping - Prueba básica de conectividad con estado del servidor y medición del tiempo de respuesta

Uso

Todos los clientes MCP más populares (Claude Desktop, VS Code Copilot, Cursor, Windsurf...) utilizan el siguiente formato de configuración:

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

Encabezados Personalizados

Para omitir la autenticación, o para emitir encabezados personalizados en todas las solicitudes a su servidor remoto, pase los argumentos de línea de comandos --header:

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

Nota: Cursor y Claude Desktop (Windows) tienen un error donde los espacios dentro de args no se escapan cuando se invoca npx, lo que termina distorsionando estos valores. Puede solucionarlo usando:

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

Uso como herramienta en OpenAI

Así es como puede usar el servidor MCP de Wassenger como herramienta con el cliente JavaScript de 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);

Asegúrese de instalar las dependencias requeridas:

npm install openai

Y configure sus variables de entorno:

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

Este enfoque utiliza la nueva API de Respuestas de OpenAI con integración MCP, que maneja automáticamente el descubrimiento de herramientas, la ejecución y la comunicación con el servidor MCP de Wassenger sin requerir configuración manual del cliente MCP.

Banderas

  • Si npx está produciendo errores, considere agregar -y como primer argumento para aceptar automáticamente la instalación del paquete mcp-wassenger.
      "command": "npx",
      "args": [
        "-y"
        "mcp-wassenger",
        "API_KEY_GOES_HERE"
      ]
  • Para forzar que npx siempre verifique una versión actualizada de mcp-wassenger, agregue la bandera @latest:
      "args": [
        "mcp-wassenger@latest"
      ]
  • Para cambiar el puerto en el que mcp-wassenger escucha una redirección OAuth (por defecto 3334), agregue un argumento adicional después de la URL del servidor. Tenga en cuenta que cualquier puerto que especifique, si no está disponible, se elegirá un puerto abierto al azar.
      "args": [
        "mcp-wassenger",
        "API_KEY_GOES_HERE"
      ]
  • Para habilitar registros de depuración detallados, agregue la bandera --debug. Esto escribirá registros verbosos en ~/.mcp-auth/{server_hash}_debug.log con marcas de tiempo e información detallada sobre el proceso de autenticación, conexiones y actualización 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.

Solución de Problemas

Limpie su directorio ~/.mcp-auth

mcp-wassenger almacena toda la información de credenciales dentro de ~/.mcp-auth (o donde apunte su MCP_REMOTE_CONFIG_DIR). Si está teniendo problemas persistentes, intente ejecutar:

rm -rf ~/.mcp-auth

Luego reinicie su cliente MCP.

Verifique su versión de Node

Asegúrese de que la versión de Node que tiene instalada sea 18 o superior. Claude Desktop usará la versión de Node de su sistema, incluso si tiene una versión más nueva instalada en otro lugar.

Reinicie Claude

Al modificar claude_desktop_config.json puede ser útil reiniciar Claude por completo

Certificados VPN

Puede encontrar problemas si está detrás de una VPN; puede intentar configurar la variable de entorno NODE_EXTRA_CA_CERTS para que apunte al archivo de certificado CA. Si usa claude_desktop_config.json, esto podría verse así:

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

Verifique los registros

  • Siga los registros de Claude Desktop en tiempo real
  • MacOS / Linux:
    tail -n 20 -F ~/Library/Logs/Claude/mcp*.log
  • Para bash en 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

Depuración

Registros de Depuración

Para solucionar problemas complejos, especialmente con la actualización de tokens o problemas de autenticación, use la bandera --debug:

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

Esto crea registros detallados en ~/.mcp-auth/{server_hash}_debug.log con marcas de tiempo e información completa sobre cada paso del proceso de conexión y autenticación. Cuando encuentre problemas con la actualización de tokens, problemas de suspensión/reanudación de la computadora portátil o problemas de autenticación, proporcione estos registros al buscar soporte.

Errores de Autenticación

Si encuentra el siguiente error, devuelto por la URL /callback:

Authentication Error
Token exchange failed: HTTP 400

Puede ejecutar rm -rf ~/.mcp-auth para limpiar cualquier estado y tokens almacenados localmente.

Modo "Cliente"

Ejecute lo siguiente en la línea de comandos (no desde un servidor MCP):

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

Esto ejecutará todo el flujo de autorización e intentará listar las herramientas y recursos en la URL remota. Intente esto después de ejecutar rm -rf ~/.mcp-auth para ver si las credenciales obsoletas son su problema; de lo contrario, con suerte el problema será más evidente en estos registros que en los de su cliente MCP.

Licencia

MIT