Saltar al contenido principal
GOWA ofrece dos maneras de recibir mensajes:

Webhooks

Iniciar GOWA con un webhook URL y secreto:
Un mensaje de texto llega como:
En un grupo, chat_id es el grupo JID (...@g.us) y from es el miembro que lo envió.

Ejemplo: robot de respuesta automática

Verificar la firma, reconocer, luego responder a través de la API con el mismo dispositivo:
Este ejemplo mínimo reconoce antes de enviar la respuesta. Para la producción, encolar el evento verificado de forma duradera antes de reconocerlo, deduplicar por dispositivo, chat y mensaje ID, y reintentar los envíos fallidos en su trabajador. Omitir eventos sin session_id o resolver el dispositivo correcto explícitamente. Para una respuesta fija a cada mensaje, WHATSAPP_AUTO_REPLY="We'll get back to you soon" hace esto sin ningún código. Ver Webhooks para cada tipo de evento, campos de medios, reintentos y URLs por dispositivo.

Maneja nuevas formas de evento

Un encabezado de álbum es un evento message con payload.album y sin cuerpo de texto. Cada imagen o video sigue como un evento multimedia separado con payload.album_id. Agrupa los medios con esa ID en lugar de tratar la cabecera como un mensaje perdido. newsletter.message contiene las actualizaciones de los canales y no garantiza un nuevo mensaje. Las actualizaciones de contactos en línea y fuera de línea utilizan presence, requieren POST /user/presence/subscribe, y requieren que tu cliente permanezca disponible. Los cambios de nombre de grupo usan group.info. Suscríbete a device.logged_out, device.temporary_ban, y device.reachout_timelock para distinguir las restricciones de la cuenta de las desconexiones normales. Estos eventos siempre identifican la slot con session_id. Vea Webhooks para los campos y la configuración de presencia.

API de almacenamiento de chat

GOWA registra chats y mensajes para cada ranura en su almacenamiento local de chat. Consulta por dispositivo:
Sólo los mensajes que GOWA ha visto (recibidos mientras se conecta, o entregados por la sincronización del historial de WhatsApp) están disponibles. Para pedir al teléfono un historial más antiguo en un chat, llama a POST /chat/{chat_jid}/history con {"count": 50}; los mensajes llegan de forma asincrónica. Las encuestas son aptas para ponerse al día y vistas de bandeja de entrada. Para bots y automatizaciones, utilice webhooks.

Descargando medios

Con auto-download en (por defecto), el webhook da una ruta bajo statics/media/, servido en http://localhost:3000/statics/media/<file>. De lo contrario, obtendrá los medios bajo demanda:
Ver Medios entrantes para ver las condiciones bajo las cuales GOWA puede recuperar un archivo caducado.

Leer recibos

Marca un mensaje leído (ticks azules) con POST /message/{message_id}/read y {"phone": "<chat_jid>"}, o establecer WHATSAPP_AUTO_MARK_READ=true para marcar cada mensaje entrante leído automáticamente.