WaliChat WhatsApp API

Automatiza WhatsApp enviando mensajes, resumiendo conversaciones y gestionando chats usando lenguaje natural con asistentes de IA.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Conector MCP WaliChat 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 WaliChat 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 interacciones con clientes a escala, administra chats y grupos de WhatsApp, todo mediante comandos conversacionales simples de texto o voz con tu asistente de IA.

⚠️ 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

WaliChat es una solución versátil de Chat de Equipo y API para WhatsApp orientada a mensajería empresarial para 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 WaliChat Flows ⚡✨

Ejemplos de comandos

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

Aquí hay varios comandos que puedes usar con cualquier asistente de IA para interactuar con WhatsApp a través del conector MCP de WaliChat:

📱 Mensajería y Comunicación Básica

  • "Envía un mensaje de WhatsApp al +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 al +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-del-mensaje] en el chat [id-del-chat] con '¡Gracias por tus comentarios!'"

📊 Análisis de Conversaciones y Perspectivas

  • "Resume mis últimos 10 mensajes de WhatsApp con +1555123456"
  • "Analiza el tono de la conversación en mi chat con el grupo 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-del-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-del-grupo]"
  • "Haz a +1234567890 administrador en el grupo [id-del-grupo]"
  • "Obtén el enlace de invitación para el grupo [id-del-grupo]"

⏰ Programación de Mensajes y Automatización

  • "Programa un mensaje al +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 válido de WhatsApp"
  • "¿Qué números de WhatsApp tengo conectados a WaliChat?"
  • "Muéstrame el estado de todos mis dispositivos de WhatsApp"
  • "Obtén la información del 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 más ocupados en WhatsApp 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 al +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-la-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 los chats importantes"
  • "Asigna el chat [id-del-chat] al agente [id-del-agente]"
  • "Muéstrame todos los chats con la etiqueta 'soporte'"
  • "Analiza el sentimiento en las conversaciones de soporte 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 actual de la cuenta de WaliChat y los límites"
  • "Sube una imagen desde [url-de-la-imagen] para usarla en mensajes de WhatsApp"
  • "Lista todos los archivos subidos etiquetados como 'marketing'"
  • "Exporta todos los contactos del dispositivo [id-del-dispositivo] a JSON"

Estos comandos 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 WaliChat.

Uso con transmisión HTTP

Si tu cliente MCP admite transmisión HTTP (anteriormente conocida como transporte de Eventos Enviados por el Servidor o SSE), puedes conectarte directamente al servidor MCP de WaliChat 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 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": {
    "walichat": {
      "type": "http",
      "url": "https://api.wali.chat/mcp?key=YOUR_WALICHAT_API_KEY"
    }
  }
}

O usando variables de entorno:

{
  "mcpServers": {
    "walichat": {
      "type": "http",
      "url": "https://api.wali.chat/mcp?key=${WALICHAT_API_KEY}",
      "env": {
        "WALICHAT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuración de VS Code Copilot

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

{
  "mcp.servers": {
    "walichat": {
      "url": "https://api.wali.chat/mcp?key=YOUR_WALICHAT_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 WaliChat.com
  2. Ve a tu configuración de API
  3. Copia tu clave API
  4. Reemplaza YOUR_WALICHAT_API_KEY en la configuración anterior

Herramientas MCP Compatibles

El servidor MCP de WaliChat 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: texto, multimedia, ubicación, contacto, encuesta, evento, programado, en vivo, efímero, agente y mensajería con plantillas
  • manage_whatsapp_message_interactions - Interacciones con mensajes: responder, reenviar, reaccionar 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 multimedia
  • 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 multimedia 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 filtrado avanzado: 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 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 acciones
  • manage_whatsapp_contact_actions - Bloqueo de contactos: operaciones de bloqueo y desbloqueo
  • manage_whatsapp_labels - Gestión de etiquetas: listar, crear, actualizar, eliminar con organización codificada por colores

📁 Gestión de Archivos y Multimedia

  • 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

📊 Analítica y Perspectivas

Todas las herramientas incluyen capacidades analíticas exhaustivas:

  • Seguimiento de entrega de mensajes y estadísticas
  • Análisis y reportes de actividad de chats
  • Métricas de rendimiento de dispositivos y monitoreo
  • Analítica de campañas y seguimiento de éxito
  • Perspectivas de productividad del equipo y reportes

Cada herramienta admite filtrado extenso, paginación, ordenamiento y capacidades de exportación, lo que las hace perfectas tanto para operaciones manuales como para flujos de trabajo automatizados a través de asistentes de IA.

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-walichat",
        "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 CLI --header:

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

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

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

Uso como herramienta en OpenAI

Así es como puede usar el servidor MCP de WaliChat como herramienta con el cliente JavaScript de OpenAI:

import OpenAI from 'openai';

const walichatKey = process.env.WALICHAT_API_KEY || 'walichat-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: 'walichat',
      server_url: `https://api.wali.chat/mcp?key=${walichatKey}`,
      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 WALICHAT_API_KEY="your-walichat-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 WaliChat 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-walichat.
      "command": "npx",
      "args": [
        "-y"
        "mcp-walichat",
        "API_KEY_GOES_HERE"
      ]
  • Para forzar a npx a verificar siempre una versión actualizada de mcp-walichat, agregue la bandera @latest:
      "args": [
        "mcp-walichat@latest"
      ]
  • Para cambiar el puerto en el que mcp-walichat 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-walichat",
        "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 renovación de tokens.
      "args": [
        "mcp-walichat",
        "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-walichat.

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 WaliChat 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 walichatKey = process.env.WALICHAT_API_KEY || 'your-walichat-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: 'walichat',
      server_url: `https://api.wali.chat/mcp?key=${walichatKey}`,
      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

walichat_key = os.getenv('WALICHAT_API_KEY', 'your-walichat-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': 'walichat',
            'server_url': f'https://api.wali.chat/mcp?key={walichat_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 WALICHAT_API_KEY="your-walichat-api-key"

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

Solución de Problemas

Limpie su directorio ~/.mcp-auth

mcp-walichat almacena toda la información de credenciales dentro de ~/.mcp-auth (o donde sea que su MCP_REMOTE_CONFIG_DIR apunte). Si tiene 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-walichat",
        "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 renovación de tokens o problemas de autenticación, use la bandera --debug:

"args": [
  "mcp-walichat",
  "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 renovació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-walichat@latest mcp-walichat-client API_KEY_GOES_HERE

Esto ejecutará todo el flujo de autorización e intentará listar las herramientas y recursos en la URL remota. Pruebe 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 obvio en estos registros que en los de su cliente MCP.

Licencia

MIT