> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos WebSocket

> Conecte un panel de control a WebSocket de GOWA, maneje el dispositivo y los eventos de emparejamiento y actualice el estado del dispositivo después de volver a conectar o completar un inicio de sesión.

GOWA empuja eventos de emparejamiento y dispositivo sobre `/ws`. Cada frame contiene un objeto JSON con un `code` legible por máquina, un `message` legible por humanos, y un `result` cuya forma depende del evento.

## Conectar

Usa `/ws` bajo tu `APP_BASE_PATH`, tal como `wss://gowa.example.com/gowa/ws`. Selecciona un dispositivo con `?device_id=<id>`. Cuando Basic Auth está habilitado, los clientes del navegador pasan el valor base64 codificado por URL de `user:password` como `authorization`. Los clientes que pueden establecer la cabecera `Authorization` pueden usar Auth Básica a través de esa cabecera. Use `wss://` y redacte la cadena de consulta en los registros de proxy. Añade el origen del panel de control a los [orígenes del navegador de confianza](https://gowa-docs.mintlify.site/es/authentication.md#cors) si lo alojas por separado.

Cada socket conectado recibe cada transmisión, incluso cuando la conexión especifica un dispositivo. Use `result.device_id` para identificar la ranura afectada cuando esté presente. Conceder acceso a WebSocket sólo a las personas que llamen en confianza con todos los dispositivos.

## Carga útil del evento

| `code` | Cuando llegue | `result` |
| - | - | - |
| `LIST_DEVICES` | Un cliente envía `FETCH_DEVICES`. | Lista de dispositivos con entradas `name`, `device` y `jid`. |
| `LOGIN_SUCCESS` | WhatsApp empareja el dispositivo. | `null`. Actualizar el estado del dispositivo sobre REST. |
| `PASSKEY_REQUEST` | WhatsApp solicita una afirmación de clave de acceso. | `device_id`, `challenge` (opciones WebAuthn). |
| `PASSKEY_CONFIRMATION` | WhatsApp reporta el resultado de la entrega de claves de acceso. | `device_id`, `code`, `skip_handoff_ux`. Cuando `skip_handoff_ux` es verdadero, el flujo QR activo envía la confirmación automáticamente. De lo contrario, compare el código con el teléfono y llame a `POST /app/passkey/confirm`. |
| `PASSKEY_ERROR` | El emparejamiento de Passkey falla. | `device_id`, `continuation`. Lee el texto de error de `message`. |
| `DEVICE_LOGGED_OUT` | El dispositivo se desconecta y mantiene su ranura. | `device_id` y ya sea `reason` para un cierre de sesión remoto o `devices` para un cierre de sesión de la API. La forma de la lista depende del punto final de salida. |
| `DEVICE_REMOVED` | La ranura del dispositivo ha sido eliminada. | `device_id`, `devices` (ranuras restantes). |
| `DEVICE_STREAM_REPLACED` | Otro cliente se conecta con la misma sesión de WhatsApp. | `device_id`. |
| `DEVICE_TEMPORARY_BAN` | WhatsApp reporta un baneo temporal. | `device_id`, `code`, `reason`, `expires_in_seconds`, y `expires_at` cuando WhatsApp proporciona un vencimiento. |
| `DEVICE_REACHOUT_TIMELOCK` | WhatsApp informa o levanta una restricción para iniciar nuevas conversaciones. | `device_id`, `is_active`, y opcional `enforcement_type` y `ends_at`. |
| `DEVICE_WEBHOOK_UPDATED` | La URL del webhook del dispositivo cambia. | `device_id`, `webhook_url`. |
| `DEVICE_WEBHOOK_CONFIG_UPDATED` | Los ajustes del webhook del dispositivo cambian. | `device_id`. |

## Actualizar estado del dispositivo

Para solicitar una lista a través del socket, envía `{"code":"FETCH_DEVICES"}` como trama de texto. GOWA difunde el evento `LIST_DEVICES` resultante a todos los sockets. Para obtener el estado actual tras volver a conectarte o emparejar, llama a `GET /devices` o `GET /devices/{device_id}/status`. Los eventos WebSocket son transitorios.

```javascript theme={null}
const url = new URL("wss://gowa.example.com/ws");
url.searchParams.set("device_id", "my-device");
url.searchParams.set("authorization", btoa("admin:changeme"));

const socket = new WebSocket(url);
socket.addEventListener("open", () => {
  socket.send(JSON.stringify({ code: "FETCH_DEVICES" }));
});
socket.addEventListener("message", ({ data }) => {
  const { code, result } = JSON.parse(data);
  if (code === "LIST_DEVICES") {
    console.log("Device list", result);
  }
  if (code === "DEVICE_LOGGED_OUT" && result?.device_id === "my-device") {
    console.log("Device logged out", result.device_id);
  }
});
```

Vea [Emparejamiento de contraseña](https://gowa-docs.mintlify.site/es/authentication.md#clave) para las llamadas REST que completan una solicitud de clave de acceso. Use [webhooks](https://gowa-docs.mintlify.site/es/concepts/webhooks.md) para procesar mensajes y recibos de WhatsApp.


## Related topics

- [Autenticación](https://gowa-docs.mintlify.site/es/authentication.md)
- [Autenticación de API](https://gowa-docs.mintlify.site/es/api-reference/authentication.md)
- [Selección de dispositivo y dispositivo múltiple](https://gowa-docs.mintlify.site/es/concepts/multidevice.md)
- [Webhooks](https://gowa-docs.mintlify.site/es/concepts/webhooks.md)
- [Referencia API](https://gowa-docs.mintlify.site/es/api-reference/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.