Resumen
Z-API, pasarela de WhatsApp de Brasil: comprueba la conexión de la instancia, explora chats y contactos, verifica si un número está en WhatsApp y envía mensajes de texto, imagen y documento a través de un número de WhatsApp vinculado por código QR.
Configuración guiada
Conecta Z-API a ChatGPT en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Z-API con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
El plugin de AnythingMCP en el directorio de ChatGPT responde, en AnythingMCP Cloud, a preguntas sobre las bases de datos de tu empresa (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, solo lectura): abre la ficha (se abre en una pestaña nueva) y pulsa Install plugin. Los demás conectores se añaden a ChatGPT como servidor MCP personalizado con la URL MCP de tu AnythingMCP.
Prueba a pedir
Prompts de ejemplo para Z-API
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Z-API, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin
git clone, sin servidor local.
Z-API + ChatGPT
Z-API, pasarela de WhatsApp de Brasil: comprueba la conexión de la instancia, explora chats y contactos, verifica si un número está en WhatsApp y envía mensajes de texto, imagen y documento a través de un número de WhatsApp vinculado por código QR.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
ZAPI_INSTANCE_ID, ZAPI_INSTANCE_TOKEN, ZAPI_CLIENT_TOKEN
Paso 1 — Obtener credenciales
- En el panel de Z-API (app.z-api.io), abre Instances, crea o elige una instancia y haz clic en editar. Copia el ID de la instancia en
ZAPI_INSTANCE_IDy el token de la instancia enZAPI_INSTANCE_TOKEN. - Abre la pestaña Security, módulo Account Security Token, haz clic en Set Up Now y copia el token en
ZAPI_CLIENT_TOKEN. Después haz clic en Activate Token para que todas las solicitudes tengan que incluirlo. - Vincula el teléfono: escanea el código QR de la instancia con WhatsApp (Linked devices). Mientras el número no esté vinculado, todos los envíos fallan.
- Empieza con
z_api_get_status:connected: falsesignifica que hay que volver a escanear el código QR;smartphoneConnected: false, que el teléfono está sin conexión.
Z-API es una pasarela de terceros que ejecuta una sesión de WhatsApp Web para tu número. No es la API oficial de WhatsApp Business de Meta, y WhatsApp puede restringir los números que envían mensajes masivos. Los números de teléfono llevan solo dígitos, con código de país y de área, sin +, espacios ni guiones (5511999999999). Las herramientas de envío mandan mensajes reales de WhatsApp: confirma primero el destinatario y el texto, y nunca repitas un envío que haya devuelto un messageId. Si activaste la restricción por IP en la pestaña Security de Z-API, permite la dirección de salida de AnythingMCP.
Paso 2 — Instalar el adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en ChatGPT
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
Z-API. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| Tool | What it does |
|---|---|
z_api_get_status | Check whether the Z-API instance is linked to a WhatsApp account and whether the phone is online |
z_api_get_instance | Get the Z-API instance name, connection flag, payment status and expiry date (Unix timestamp in due) |
z_api_get_device | Get the phone linked to the instance: its number, profile name, device model and whether it is a WhatsApp Business account |
z_api_check_phone_exists | Check whether a phone number has a WhatsApp account |
z_api_list_chats | List the WhatsApp chats of the linked number (people and groups) with phone or group ID, name, unread count and last message time |
z_api_get_chat | Get metadata of one chat: unread count, last message time, mute and spam flags, profile status and notes (WhatsApp Business only) |
z_api_list_contacts | List WhatsApp contacts known to the linked number, including people from shared groups, with phone, saved name and WhatsApp profile name |
z_api_list_queue | List messages still waiting in the instance's send queue, with phone, text and IDs |
z_api_send_text | Send a WhatsApp text message to a contact or group from the linked number |
z_api_send_image | Send an image by public HTTPS URL to a contact or group, with an optional caption |
z_api_send_document | Send a document (PDF, XLSX, DOCX...) by public HTTPS URL to a contact or group |
FAQ
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?