Documentación API REST

Integra WhatsApp en tu software, CRM o tienda en línea usando ZapWhat. API rápida, estable y diseñada para escalar.

Base URL: https://zapwhat.com/api

Endpoints disponibles

  • Enviar mensajes — texto, imágenes, videos, audios, documentos, stickers, contactos
  • Enviar ubicaciones — coordenadas GPS con dirección
  • Editar mensajes — actualiza el texto dentro de los primeros 15 minutos
  • Listar instancias — consulta el estado de tus conexiones
  • Webhooks — recibe mensajes entrantes en tiempo real
  • Autenticación segura mediante API Token

Autenticación

Todas las llamadas requieren tu API Token en el header Authorization usando el formato Bearer.

Tu token único se genera automáticamente al crear tu cuenta. Puedes verlo en la sección API Docs de tu Panel de Control.

Authorization: Bearer TU_API_TOKEN_AQUI
Importante: Mantén tu token en secreto. No lo compartas en repositorios públicos o código del lado del cliente.

Códigos de Error

La API utiliza códigos de estado HTTP estándar para indicar el resultado de cada solicitud.

CódigoSignificadoDescripción
200OKSolicitud exitosa.
400Bad RequestFaltan parámetros requeridos o el JSON es inválido.
401UnauthorizedToken de API faltante o inválido.
403ForbiddenNo tienes permiso para usar esta instancia.
404Not FoundInstancia, mensaje o recurso no encontrado.
405Method Not AllowedEl método HTTP no está disponible para ese endpoint.
409ConflictLa instancia no está conectada o no está lista para la operación.
422Unprocessable EntityLos datos no son válidos o la operación ya no está disponible (por ejemplo, pasaron los 15 minutos de edición).
429Too Many RequestsDemasiadas solicitudes. Espera unos segundos y reintenta.
500Internal Server ErrorError interno del servidor. Contacta a soporte si persiste.
502Bad GatewayEl servicio de mensajería no respondió correctamente. Reintenta más tarde.
{ "error": "Descripción del error" }

Listar Instancias

Obtén la lista de tus instancias de WhatsApp conectadas y su estado en tiempo real.

GET https://zapwhat.com/api/instances

Headers

HeaderValor
AuthorizationBearer TU_API_TOKEN

Respuesta

{ "success": true, "instances": [ { "instance_id": "zapwhat_u1_User_MyPhone", "status": "connected", "created_at": "2026-06-01 12:00:00" } ] }

Enviar Mensaje de Texto

Envía un mensaje de texto simple a cualquier número de WhatsApp.

POST https://zapwhat.com/api/send
ParámetroTipoRequeridoDescripción
instance_idStringSíID de tu sesión de WhatsApp (lo encuentras en tu panel).
toStringSíNúmero del receptor con código de país (ej: 5215512345678). Sin + ni espacios.
messageStringSí*Contenido del mensaje. Soporta emojis y saltos de línea.
textStringNoAlias opcional de message para integraciones que ya usan text.

Sí* Se requiere message o su alias text.

Ejemplos de Integración

$curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://zapwhat.com/api/send', CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => json_encode(array( "instance_id" => "TU_INSTANCE_ID", "to" => "5215512345678", "message" => "¡Hola desde ZapWhat API!" )), CURLOPT_HTTPHEADER => array( 'Authorization: Bearer TU_API_TOKEN_AQUI', 'Content-Type: application/json' ), )); $response = curl_exec($curl); echo $response;
const axios = require('axios'); const data = { instance_id: "TU_INSTANCE_ID", to: "5215512345678", message: "¡Hola desde ZapWhat API!" }; axios.post('https://zapwhat.com/api/send', data, { headers: { 'Authorization': 'Bearer TU_API_TOKEN_AQUI', 'Content-Type': 'application/json' } }).then(res => console.log(res.data));
import requests, json url = "https://zapwhat.com/api/send" payload = json.dumps({ "instance_id": "TU_INSTANCE_ID", "to": "5215512345678", "message": "¡Hola desde ZapWhat API!" }) headers = { 'Authorization': 'Bearer TU_API_TOKEN_AQUI', 'Content-Type': 'application/json' } response = requests.post(url, headers=headers, data=payload) print(response.text)
curl --location 'https://zapwhat.com/api/send' \ --header 'Authorization: Bearer TU_API_TOKEN_AQUI' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "to": "5215512345678", "message": "¡Hola desde ZapWhat API!" }'
Guarda el message_id de la respuesta. Es el identificador numérico que necesitas para editar, consultar o eliminar ese mensaje. También recibirás un message_log_id que puedes usar como alternativa.

Editar un Mensaje

Edita un mensaje de texto enviado desde ZapWhat. WhatsApp solo permite editar mensajes durante los primeros 15 minutos después del envío; pasado ese periodo la operación se rechaza.

Importante: usa el message_id que devuelve POST /api/send. No uses el ID interno de WhatsApp (key.id) ni el ID del mensaje en el teléfono del destinatario.
PUT https://zapwhat.com/api/messages
ParámetroTipoRequeridoDescripción
instance_idStringSíID de tu sesión de WhatsApp (también acepta el ID numérico del panel).
message_idStringSí*ID devuelto como message_id al enviar el mensaje.
message_log_idIntegerNoAlternativa a message_id. Identificador devuelto por ZapWhat al enviar.
textStringSíNuevo contenido del mensaje. Soporta emojis y saltos de línea.

Sí* Se requiere message_id o message_log_id.

Respuesta

{ "success": true, "message_id": "123456789", "message_log_id": 42, "message": { "id": "123456789", "text": "Hola, el evento empieza a las 7 pm.", "status": "edited", "edited_at": "2026-10-20T18:30:00+00:00" } }

Ejemplos de Integración

$curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://zapwhat.com/api/messages', CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'PUT', CURLOPT_POSTFIELDS => json_encode(array( "instance_id" => "TU_INSTANCE_ID", "message_id" => "123456789", "text" => "Hola, el evento empieza a las 7 pm." )), CURLOPT_HTTPHEADER => array( 'Authorization: Bearer TU_API_TOKEN_AQUI', 'Content-Type: application/json' ), )); $response = curl_exec($curl); echo $response;
const axios = require('axios'); const data = { instance_id: "TU_INSTANCE_ID", message_id: "123456789", text: "Hola, el evento empieza a las 7 pm." }; axios.put('https://zapwhat.com/api/messages', data, { headers: { 'Authorization': 'Bearer TU_API_TOKEN_AQUI', 'Content-Type': 'application/json' } }).then(res => console.log(res.data));
import requests, json url = "https://zapwhat.com/api/messages" payload = json.dumps({ "instance_id": "TU_INSTANCE_ID", "message_id": "123456789", "text": "Hola, el evento empieza a las 7 pm." }) headers = { 'Authorization': 'Bearer TU_API_TOKEN_AQUI', 'Content-Type': 'application/json' } response = requests.put(url, headers=headers, data=payload) print(response.text)
curl --request PUT 'https://zapwhat.com/api/messages' \ --header 'Authorization: Bearer TU_API_TOKEN_AQUI' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "message_id": "123456789", "text": "Hola, el evento empieza a las 7 pm." }'
Errores frecuentes: 422 cuando ya pasaron los 15 minutos o el mensaje no es de texto; 404 cuando el mensaje no fue enviado desde ZapWhat o el identificador no existe; 409 cuando la instancia no está conectada o no tiene credenciales listas.

Consultar o eliminar el mensaje

El mismo endpoint acepta GET para consultar el estado actual y DELETE para eliminarlo para todos, usando los mismos parámetros de identificación.

# Consultar curl --request GET 'https://zapwhat.com/api/messages?instance_id=TU_INSTANCE_ID&message_id=123456789' \ --header 'Authorization: Bearer TU_API_TOKEN_AQUI' # Eliminar curl --request DELETE 'https://zapwhat.com/api/messages' \ --header 'Authorization: Bearer TU_API_TOKEN_AQUI' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "message_id": "123456789" }'

Enviar Archivo / Media

Envía imágenes, videos, audios, documentos, stickers o tarjetas de contacto a cualquier número de WhatsApp. Todos los tipos de media se envían al mismo endpoint.

POST https://zapwhat.com/api/send-media
ParámetroTipoRequeridoDescripción
instance_idStringSíID de tu sesión de WhatsApp.
toStringSíNúmero del receptor con código de país.
typeStringSíTipo de archivo: image, video, audio, document, sticker, contact
urlStringSí*URL pública del archivo. No necesario si type=contact.
captionStringNoTexto descriptivo (aplica para image y video).
filenameStringNoNombre del archivo a mostrar (útil para document).
contact_nameStringSí*Nombre del contacto (requerido si type=contact).
contact_phoneStringSí*Teléfono del contacto (requerido si type=contact).
Los audios se envían como nota de voz. Los stickers deben estar en formato WebP.

Ejemplos de Integración

// Ejemplo: enviar imagen con caption $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://zapwhat.com/api/send-media', CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => json_encode(array( "instance_id" => "TU_INSTANCE_ID", "to" => "5215512345678", "type" => "image", "url" => "https://ejemplo.com/imagen.jpg", "caption" => "Mira esta imagen!" )), CURLOPT_HTTPHEADER => array( 'Authorization: Bearer TU_API_TOKEN', 'Content-Type: application/json' ), )); $response = curl_exec($curl); // Ejemplo: enviar sticker $payload = json_encode(array( "instance_id" => "TU_INSTANCE_ID", "to" => "5215512345678", "type" => "sticker", "url" => "https://ejemplo.com/sticker.webp" )); // Ejemplo: enviar contacto $payload = json_encode(array( "instance_id" => "TU_INSTANCE_ID", "to" => "5215512345678", "type" => "contact", "contact_name" => "Juan Pérez", "contact_phone" => "5215598765432" ));
const axios = require('axios'); // Enviar imagen con caption const data = { instance_id: "TU_INSTANCE_ID", to: "5215512345678", type: "image", url: "https://ejemplo.com/imagen.jpg", caption: "Mira esta imagen!" }; axios.post('https://zapwhat.com/api/send-media', data, { headers: { 'Authorization': 'Bearer TU_API_TOKEN', 'Content-Type': 'application/json' } }).then(res => console.log(res.data)); // Enviar documento const docData = { instance_id: "TU_INSTANCE_ID", to: "5215512345678", type: "document", url: "https://ejemplo.com/reporte.pdf", filename: "Reporte_2026.pdf" }; axios.post('https://zapwhat.com/api/send-media', docData, { headers: { 'Authorization': 'Bearer TU_API_TOKEN', 'Content-Type': 'application/json' } }).then(res => console.log(res.data)); // Enviar contacto const contactData = { instance_id: "TU_INSTANCE_ID", to: "5215512345678", type: "contact", contact_name: "Juan Pérez", contact_phone: "5215598765432" }; axios.post('https://zapwhat.com/api/send-media', contactData, { headers: { 'Authorization': 'Bearer TU_API_TOKEN', 'Content-Type': 'application/json' } }).then(res => console.log(res.data));
import requests, json url = "https://zapwhat.com/api/send-media" headers = { 'Authorization': 'Bearer TU_API_TOKEN', 'Content-Type': 'application/json' } # Enviar imagen con caption payload = json.dumps({ "instance_id": "TU_INSTANCE_ID", "to": "5215512345678", "type": "image", "url": "https://ejemplo.com/imagen.jpg", "caption": "Mira esta imagen!" }) response = requests.post(url, headers=headers, data=payload) print(response.text) # Enviar sticker payload = json.dumps({ "instance_id": "TU_INSTANCE_ID", "to": "5215512345678", "type": "sticker", "url": "https://ejemplo.com/sticker.webp" }) response = requests.post(url, headers=headers, data=payload) print(response.text) # Enviar contacto payload = json.dumps({ "instance_id": "TU_INSTANCE_ID", "to": "5215512345678", "type": "contact", "contact_name": "Juan Pérez", "contact_phone": "5215598765432" }) response = requests.post(url, headers=headers, data=payload) print(response.text)
# Enviar imagen curl --location 'https://zapwhat.com/api/send-media' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "to": "5215512345678", "type": "image", "url": "https://ejemplo.com/imagen.jpg", "caption": "Mira esta imagen!" }' # Enviar documento curl --location 'https://zapwhat.com/api/send-media' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "to": "5215512345678", "type": "document", "url": "https://ejemplo.com/reporte.pdf", "filename": "Reporte_2026.pdf" }'

Enviar Ubicación

Envía coordenadas GPS con nombre y dirección opcional.

POST https://zapwhat.com/api/send-location
ParámetroTipoRequeridoDescripción
instance_idStringSíID de tu sesión de WhatsApp.
toStringSíNúmero del receptor con código de país.
latFloatSíLatitud de la ubicación. Ej: 19.4326
lngFloatSíLongitud de la ubicación. Ej: -99.1332
addressStringNoDirección física en formato texto.
nameStringNoNombre del lugar o establecimiento.

Ejemplos de Integración

$curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://zapwhat.com/api/send-location', CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => json_encode(array( "instance_id" => "TU_INSTANCE_ID", "to" => "5215512345678", "lat" => 19.4326, "lng" => -99.1332, "address" => "Zócalo de la CDMX", "name" => "Centro Histórico" )), CURLOPT_HTTPHEADER => array( 'Authorization: Bearer TU_API_TOKEN', 'Content-Type: application/json' ), )); $response = curl_exec($curl); echo $response;
const axios = require('axios'); const data = { instance_id: "TU_INSTANCE_ID", to: "5215512345678", lat: 19.4326, lng: -99.1332, address: "Zócalo de la CDMX", name: "Centro Histórico" }; axios.post('https://zapwhat.com/api/send-location', data, { headers: { 'Authorization': 'Bearer TU_API_TOKEN', 'Content-Type': 'application/json' } }).then(res => console.log(res.data));
import requests, json url = "https://zapwhat.com/api/send-location" payload = json.dumps({ "instance_id": "TU_INSTANCE_ID", "to": "5215512345678", "lat": 19.4326, "lng": -99.1332, "address": "Zócalo de la CDMX", "name": "Centro Histórico" }) headers = { 'Authorization': 'Bearer TU_API_TOKEN', 'Content-Type': 'application/json' } response = requests.post(url, headers=headers, data=payload) print(response.text)
curl --location 'https://zapwhat.com/api/send-location' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "to": "5215512345678", "lat": 19.4326, "lng": -99.1332, "address": "Zócalo de la CDMX", "name": "Centro Histórico" }'

Verificar si un Número está en WhatsApp

Verifica si un número de teléfono está registrado en WhatsApp. Requiere una instancia conectada.

POST https://zapwhat.com/api/check-number
ParámetroTipoRequeridoDescripción
instance_idStringSíID de tu sesión de WhatsApp conectada.
phoneStringSíNúmero a verificar (ej: 5215512345678).
curl --location 'https://zapwhat.com/api/check-number' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "phone": "5215512345678" }'

Listar Contactos

Obtén todos los contactos sincronizados con tu sesión de WhatsApp.

POST https://zapwhat.com/api/contacts
curl --location 'https://zapwhat.com/api/contacts' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "action": "list" }'

Información de un Contacto

POST https://zapwhat.com/api/contacts
curl --location 'https://zapwhat.com/api/contacts' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "action": "info", "phone": "5215512345678" }'

Bloquear / Desbloquear Contacto

POST https://zapwhat.com/api/contacts
# Bloquear curl --location 'https://zapwhat.com/api/contacts' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "action": "block", "phone": "5215512345678" }' # Desbloquear curl --location 'https://zapwhat.com/api/contacts' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "action": "unblock", "phone": "5215512345678" }'

Crear o Actualizar Contacto

Guarda o actualiza un contacto en la agenda de tu sesión de WhatsApp.

POST https://zapwhat.com/api/contacts
curl --location 'https://zapwhat.com/api/contacts' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "action": "sync", "phone": "5215512345678", "name": "Juan Pérez" }'

Listar Grupos

Obtén todos los grupos donde está presente tu sesión de WhatsApp.

POST https://zapwhat.com/api/groups
curl --location 'https://zapwhat.com/api/groups' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "action": "list" }'

Crear Grupo

Crea un nuevo grupo de WhatsApp con los participantes indicados.

POST https://zapwhat.com/api/groups
ParámetroTipoRequeridoDescripción
instance_idStringSíID de tu sesión.
actionStringSícreate
nameStringSíNombre del grupo.
participantsArraySíArray de números a agregar (ej: ["5215512345678"]).
curl --location 'https://zapwhat.com/api/groups' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "action": "create", "name": "Mi Grupo", "participants": ["5215512345678", "5215598765432"] }'

Gestionar Grupo

Administra participantes, configuración, y más desde un solo endpoint.

POST https://zapwhat.com/api/groups
AcciónDescripciónParámetros adicionales
metadataObtener info del grupogroup_id
participantsListar participantesgroup_id
add-participantsAgregar miembrosgroup_id, participants [array]
remove-participantsEliminar miembrosgroup_id, participants [array]
settingsCambiar nombre/descripcióngroup_id, subject, description
invite-linkObtener link de invitacióngroup_id
leaveSalir del grupogroup_id
# Obtener metadata curl --location 'https://zapwhat.com/api/groups' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "action": "metadata", "group_id": "[email protected]" }' # Agregar participantes curl --location 'https://zapwhat.com/api/groups' \ --header 'Authorization: Bearer TU_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "instance_id": "TU_INSTANCE_ID", "action": "add-participants", "group_id": "[email protected]", "participants": ["5215512345678"] }'
El group_id es el JID del grupo (ej: [email protected]). Puedes obtenerlo con la acción list.

Recibir Mensajes (Webhooks)

Para recibir mensajes entrantes, configura una URL de Webhook desde la sección Instancias de tu Panel de Control. Cada vez que tu número reciba un mensaje, ZapWhat enviará una petición POST a tu servidor con los detalles.

Puedes configurar una URL de webhook diferente para cada instancia desde el panel.

Estructura del JSON Recibido

{ "event": "message.incoming", "sessionId": "TU_SESSION_ID", "text": "Hola, necesito información", "from": "5215512345678", "data": { "messages": { "key": { "remoteJid": "[email protected]", "fromMe": false, "id": "MSG_ID_12345" }, "message": { "conversation": "Hola, necesito información" }, "messageTimestamp": 1781289344 } } }

Ejemplo de Implementación en PHP

// webhook.php - Recibir notificaciones de ZapWhat // 1. Leer los datos del POST $input = file_get_contents('php://input'); $data = json_decode($input, true); if (!$data) { http_response_code(400); exit('JSON inválido'); } // 2. Extraer los datos principales $messageText = $data['text'] ?? ''; $senderNumber = $data['from'] ?? ''; // 3. Procesar o registrar if (!empty($senderNumber) && !empty($messageText)) { $log = date('Y-m-d H:i:s') . " | Remitente: $senderNumber | Mensaje: $messageText" . PHP_EOL; file_put_contents('webhooks.log', $log, FILE_APPEND); } // 4. Responder con éxito http_response_code(200); echo json_encode(['status' => 'processed']);

Integración con n8n

Conecta ZapWhat con n8n mediante el nodo comunitario n8n-nodes-zapwhat, publicado en npm. Incluye nodo de acción, trigger por webhook y la credencial ZapWhat API.

Instalación

  1. En n8n abre Settings → Community nodes → Install a community node e instala n8n-nodes-zapwhat.
  2. Reinicia n8n si el nodo no aparece en el panel.
  3. Crea la credencial ZapWhat API con tu Base URL y tu API Token (usa Test para validarla).
docker exec -it n8n sh -c "cd /home/node/.n8n && npm install n8n-nodes-zapwhat" docker restart n8n

Credencial ZapWhat API

La credencial envía el token en la cabecera Authorization: Bearer …, así que nunca aparece en los parámetros del nodo. La petición de prueba consulta GET /api/instances.

Acciones disponibles

Mensajes (texto, archivo, ubicación, consultar, editar, eliminar), contactos (listar, información, foto, bloquear, sincronizar), grupos (crear, metadatos, participantes, ajustes, enlace de invitación, salir), verificación de números y listado de instancias.

Trigger (mensajes entrantes)

El nodo ZapWhat Trigger expone un webhook público en /webhook/zapwhat. Pega esa URL (o la de prueba, /webhook-test/zapwhat) en Dashboard → Instancia → Webhook de ZapWhat.

La ruta del webhook es fija, así que solo un workflow puede escucharla. Si necesitas varios flujos, ramifica con un nodo Switch sobre instanceId o category.

Paquete npm: n8n-nodes-zapwhat. Su README cubre la instalación, todas las acciones y las limitaciones conocidas.

Página dedicada con la instalación paso a paso, tres recetas (incluida la respuesta automática con IA) y plantillas de workflow listas para importar: zapwhat.com/n8n.

Tres recetas para empezar

Recrea estos flujos nodo por nodo. Las etiquetas del nodo ZapWhat están en español; cada operación corresponde a la referencia de la API en este sitio.

1. Respuesta automática con IA

Cada mensaje entrante pasa por un modelo de lenguaje y la respuesta se envía al mismo chat, citando el mensaje original.

ZapWhat Trigger → AI Agent / Basic LLM Chain → ZapWhat · Mensaje · Enviar texto
  1. Usa el ZapWhat Trigger con el evento incoming e ignora los mensajes con fromMe en true, o el flujo se responderá a sí mismo.
  2. Agrega un nodo de IA (OpenAI, Anthropic o el AI Agent) y pega el prompt de abajo como mensaje de sistema.
  3. Responde con ZapWhat · Mensaje · Enviar texto: to = {{ $json.from }} y replyTo = {{ $json.messageId }}.
Eres el agente de soporte de WhatsApp de mi negocio. Responde en el mismo idioma que usó el cliente, en 60 palabras o menos. Nunca inventes precios, stock ni fechas de entrega: si no lo sabes, responde "Te paso con un asesor" y detente. No uses markdown, emojis ni enlaces salvo que el cliente los pida.
El texto del mensaje sale de tu servidor y va a tu proveedor de IA: revisa tu aviso de privacidad y agrega un respaldo humano cuando el modelo dude. Mantén las respuestas cortas: WhatsApp es un chat, no correo.

2. Enrutar mensajes sin IA

Usa la categoría del mensaje de WhatsApp o palabras clave simples para mandar cada mensaje por una rama distinta del flujo.

ZapWhat Trigger → Switch → Enviar texto / Enviar archivo / Contacto · Sincronizar
  1. Haz el Switch sobre {{ $json.category }} para separar text, image, audio, document y group.
  2. Dentro de la rama de texto usa la expresión de abajo para etiquetar precios, horarios o soporte.
  3. Guarda prospectos con ZapWhat · Contacto · Sincronizar usando phone = {{ $json.from }}.
{{ $json.text.toLowerCase().includes('precio') ? 'pricing' : ($json.text.toLowerCase().includes('horario') ? 'hours' : 'other') }}
Las palabras clave son gratis, predecibles e instantáneas: úsalas antes de pagar una llamada al modelo.

3. Notificaciones desde tu sistema

Dispara el flujo desde tu ERP, tu CRM o una programación y entrega el mensaje a un número o a un grupo.

Webhook / Schedule Trigger → Número · Verificar número → ZapWhat · Mensaje
  1. Verifica primero al destinatario con Número · Verificar número y descarta los números que no tienen WhatsApp.
  2. Envía texto, un documento (por ejemplo el PDF de una factura) o una ubicación con el recurso Mensaje.
  3. Para grupos usa el JID como destino, por ejemplo [email protected].
# Tu sistema llama al webhook de n8n POST https://tu-n8n.ejemplo.com/webhook/zapwhat-notify { "to": "5215512345678", "text": "Tu pedido está listo" }
El trigger escucha en una ruta fija, así que usa una instancia por workflow y enruta varios números con un Switch.

Descarga las plantillas

Importa los archivos JSON en n8n (Workflows → Import from file), coloca el ID de tu instancia en el nodo ZapWhat y elige tu credencial ZapWhat API.

Las plantillas son exportaciones normales de n8n y nunca incluyen credenciales ni tokens.

Buenas Prácticas

1. Anti-Spam y Límites de WhatsApp

La API no impone un límite estricto de mensajes por segundo, pero tu número de WhatsApp sigue sujeto a las políticas anti-spam de Meta. Para evitar bloqueos:

  • Introduce pausas aleatorias (3-8 segundos) entre envíos masivos
  • Varia el contenido de los mensajes (no uses plantillas idénticas)
  • Evita enviar mensajes a usuarios que no te tengan en sus contactos
  • Monitorea la tasa de bloqueos y ajusta la velocidad

2. Manejo de Errores

  • Implementa reintentos con backoff exponencial (espera 1s, 2s, 4s...)
  • Registra todos los errores y respuestas de la API para depuración

3. Seguridad

  • Nunca expongas tu API Token en código del lado del cliente
  • Usa variables de entorno para almacenar tokens

4. Proxies Integrados

ZapWhat incluye una red global de proxies rotativos integrados en todas tus instancias de forma automática para máxima estabilidad. No necesitas configurar ni comprar proxies adicionales.

  • Protección automática contra bloqueos mediante IPs dinámicas
  • Asignación inteligente de ubicaciones para coincidir con tu región
  • Alta disponibilidad garantizada sin configuraciones extra