> ## 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.

# Selección de dispositivo y dispositivo múltiple

> Ejecute varias cuentas de WhatsApp en un servidor GOWA y elija la que utiliza cada solicitud con X-Device-Id.

![GOWA Multi Device Whats App Archicture](https://mintcdn.com/gowa-docs/ccA2Yz4DVI9xOiS8/images/GOWA-Multi-Device-WhatsApp-Architecture.png?fit=max\&auto=format\&n=ccA2Yz4DVI9xOiS8\&q=85\&s=116b948218cb46aa9eca0b959634eaaf)

"Multi-dispositivo" significa dos cosas en GOWA:

* **Protocolo multidispositivo de WhatsApp.** GOWA enlaza con una cuenta como un dispositivo de compañero, como WhatsApp Web. El teléfono no necesita permanecer en línea, y cada cuenta permite hasta cuatro acompañantes vinculados.
* **Múltiples cuentas por servidor.** Un proceso de GOWA puede contener muchas **ranuras de dispositivos**. Cada ranura empareja con una cuenta diferente de WhatsApp, o con el mismo número que un compañero separado.

## Ranuras de dispositivo

Una ranura tiene un ID que usted elige (o un UUID generado), un estado, y una vez emparejado el JID de la cuenta.

| Estado | Comenzando |
| - | - |
| `disconnected` | No conectado a WhatsApp. Aquí comienza una ranura nueva o desconectada. |
| `connecting` | Conexión en curso. |
| `connected` | Socket abierto, no ha iniciado sesión (por ejemplo, mientras se espera un análisis de QR). |
| `logged_in` | Emparejado y listo para enviar y recibir. |

### Administrar ranuras

```bash theme={null}
# Create (device_id is optional)
curl -u admin:changeme -X POST http://localhost:3000/devices \
  -H "Content-Type: application/json" \
  -d '{"device_id": "sales"}'

# List
curl -u admin:changeme http://localhost:3000/devices

# Inspect / live status
curl -u admin:changeme http://localhost:3000/devices/sales
curl -u admin:changeme http://localhost:3000/devices/sales/status

# Pair, log out, reconnect
curl -u admin:changeme http://localhost:3000/devices/sales/login
curl -u admin:changeme -X POST "http://localhost:3000/devices/sales/login/code?phone=628123456789"
curl -u admin:changeme -X POST http://localhost:3000/devices/sales/logout
curl -u admin:changeme -X POST http://localhost:3000/devices/sales/reconnect

# Remove the slot and its session and chat data
curl -u admin:changeme -X DELETE http://localhost:3000/devices/sales
```

Las rutas `/devices/...` toman el dispositivo de la ruta, por lo que nunca necesitan `X-Device-Id`. Las sesiones persisten a través de reinicios.

## Seleccionar un dispositivo

Cada otra ruta de alcance del dispositivo (`/send/*`, `/message/*`, `/chat*`, `/group*`, `/user/*`, `/newsletter/*`, `/call/*` y `/app/*` excepto `/app/info` y `/app/metrics`) necesita saber con qué cuenta actuar. GOWA lo resuelve en este orden:

1. La cabecera `X-Device-Id` (URL-decoded).
2. El parámetro de consulta `device_id`.
3. Si ninguna de las dos es dada y existe **exactamente una** ranura, esa ranura.

El valor puede ser el ID de la ranura o el JID de la cuenta (por ejemplo `628123456789@s.whatsapp.net`).

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" \
  -H "X-Device-Id: sales" \
  -d '{"phone": "628123456789", "message": "Hi from the sales number"}'

# Equivalent, using the query parameter
curl -u admin:changeme -X POST "http://localhost:3000/send/message?device_id=sales" \
  -H "Content-Type: application/json" \
  -d '{"phone": "628123456789", "message": "Hi from the sales number"}'
```

> [!TIP]
>
> Siempre enviar `X-Device-Id`, incluso con una ranura. Si se añade una segunda ranura más adelante haría que cada llamada sin alcance fallara con `DEVICE_ID_REQUIRED`.

### Errores de selección

| HTTP | `code` | Causa |
| - | - | - |
| 400 | `DEVICE_ID_REQUIRED` | No existe ningún dispositivo y cero o varias ranuras. |
| 404 | `DEVICE_NOT_FOUND` | Ninguna ranura coincide con el ID o JID dados. |
| 503 | `DEVICE_MANAGER_UNAVAILABLE` | El servidor no ha terminado de inicializarse. |

Un slot que existe pero que no está conectado pasa la selección; la solicitud falla con un error de WhatsApp como "no has iniciado sesión".

## Características por dispositivo

| Característica | Cómo se encuadra |
| - | - |
| Webhooks | Cada carga útil lleva `device_id` (cuenta JID) y `session_id` (slot ID). Una ranura puede tener su propio webhook: `PATCH /devices/{device_id}/webhook`. Ver [Webhooks](https://gowa-docs.mintlify.site/es/concepts/webhooks.md#webhooks-por-dispositivo). |
| WebSocket | Conecta a `/ws?device_id=<id>` para seleccionar el contexto del dispositivo. El hub actual transmite eventos a cada socket conectado, por lo que los clientes deben filtrar por los identificadores de dispositivo del evento. Los orígenes del navegador deben ser de confianza. |
| Envíos programados | Pertenece a la ranura que los creó; listándolos con el `X-Device-Id` de esa ranura. |
| MCP | `X-Device-Id` en la conexión MCP, o un argumento `device_id` por llamada de herramienta. Vea [Servidor MCP](https://gowa-docs.mintlify.site/es/integrations/mcp.md). |
| Chatwoot | `CHATWOOT_DEVICE_ID` para una única bandeja de entrada, o por dispositivo configura una bandeja de entrada por slot. Ver [Chatwoot](https://gowa-docs.mintlify.site/es/integrations/chatwoot.md). |

## Límites y advertencias

* WhatsApp permite hasta cuatro compañeros vinculados por cuenta. Cada ranura de GOWA vinculada a esa cuenta utiliza uno.
* WhatsApp desvincula un compañero si el teléfono permanece desconectado durante unos 14 días.
* La sincronización de historial después de emparejar es parcial y controlada por WhatsApp; GOWA almacena lo que recibe en su almacenamiento de chat.
* Las lecturas de mensajes y chat orientados al usuario utilizan la identidad de almacenamiento de la cuenta registrada. No sustituya la cabecera de un dispositivo de una slot cuando busque los mensajes de otra slot. Una ranura sincronizada recibe eventos a través de su cliente actual.
* Cada ranura es una conexión completa de WhatsApp. La memoria y la CPU crecen con el número de ranuras y el volumen de tráfico.


## Related topics

- [Listar suscripciones de actualizaciones en vivo del dispositivo](https://gowa-docs.mintlify.site/es/api-reference/newsletter/listar-suscripciones-de-actualizaciones-en-vivo-del-dispositivo.md)
- [Referencia API](https://gowa-docs.mintlify.site/es/api-reference/introduction.md)
- [Obtener lista de dispositivos conectados](https://gowa-docs.mintlify.site/es/api-reference/app/obtener-lista-de-dispositivos-conectados.md)
- [Lista de configuraciones de Chatwoot por dispositivo](https://gowa-docs.mintlify.site/es/api-reference/chatwoot/lista-de-configuraciones-de-chatwoot-por-dispositivo.md)
- [Servidor MCP](https://gowa-docs.mintlify.site/es/integrations/mcp.md)


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