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.
PUThttps://zapwhat.com/api/messages
Parámetro
Tipo
Requerido
Descripción
instance_id
String
Sí
ID de tu sesión de WhatsApp (también acepta el ID numérico del panel).
message_id
String
Sí*
ID devuelto como message_id al enviar el mensaje.
message_log_id
Integer
No
Alternativa a message_id. Identificador devuelto por ZapWhat al enviar.
text
String
Sí
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"
}
}
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.
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.
POSThttps://zapwhat.com/api/send-media
Parámetro
Tipo
Requerido
Descripción
instance_id
String
Sí
ID de tu sesión de WhatsApp.
to
String
Sí
Número del receptor con código de país.
type
String
Sí
Tipo de archivo: image, video, audio, document, sticker, contact
url
String
Sí*
URL pública del archivo. No necesario si type=contact.
caption
String
No
Texto descriptivo (aplica para image y video).
filename
String
No
Nombre del archivo a mostrar (útil para document).
contact_name
String
Sí*
Nombre del contacto (requerido si type=contact).
contact_phone
String
Sí*
Teléfono del contacto (requerido si type=contact).
Los audios se envían como nota de voz. Los stickers deben estar en formato WebP.
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.
// 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
En n8n abre Settings → Community nodes → Install a community node e instala n8n-nodes-zapwhat.
Reinicia n8n si el nodo no aparece en el panel.
Crea la credencial ZapWhat API con tu Base URL y tu API Token (usa Test para validarla).
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.
Usa el ZapWhat Trigger con el evento incoming e ignora los mensajes con fromMe en true, o el flujo se responderá a sí mismo.
Agrega un nodo de IA (OpenAI, Anthropic o el AI Agent) y pega el prompt de abajo como mensaje de sistema.
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.
Respuesta automática con filtro03-respuesta-automatica.jsonDescargar JSON
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