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

# Inicio rápido

> Ejecute GOWA, empareja una cuenta de WhatsApp y envíe su primer mensaje en unos minutos.

## 1. Iniciar el servidor

> [tab] Doctor
>
> ```bash theme={null}
> docker run -d --name gowa \
>   -p 3000:3000 \
>   -v gowa_storages:/app/storages \
>   -v gowa_statics:/app/statics \
>   -e APP_BASIC_AUTH=admin:changeme \
>   aldinokemal2104/go-whatsapp-web-multidevice:latest
> ```
>
> El comando predeterminado de la imagen es `rest`, así que no se necesitan argumentos. La misma imagen se publica como `ghcr.io/aldinokemal/go-whatsapp-web-multidevice`.

> [tab] Binario
>
> Descargar el archivo para tu plataforma desde la [última versión estable](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest). Este ejemplo utiliza el archivo v9.9.0 Linux amd64. Sustituye el nombre del archivo descargado.
>
> ```bash theme={null}
> unzip whatsapp_9.9.0_linux_amd64.zip
> chmod +x whatsapp
> ./whatsapp rest --basic-auth=admin:changeme
> ```
>
> Instale primero Fmpeg y libwebp (`cwebp`); GOWA los utiliza para la conversión de medios.

> [tab] Desde la fuente
>
> Requiere Go 1.26+, Fmpeg y libwebp.
>
> ```bash theme={null}
> git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
> cd go-whatsapp-web-multidevice/src
> go run . rest --basic-auth=admin:changeme
> ```

Compruebe que ha terminado:

```bash theme={null}
curl http://localhost:3000/health
# OK
```

> [!NOTE]
>
> El oyente no loopback por defecto requiere credenciales completas `APP_BASIC_AUTH`. Para un desarrollo local no autenticado, vincula `APP_HOST=127.0.0.1`. Un proxy de autenticación inversa puede usar la anulación explícita `APP_ALLOW_UNAUTHENTICATED=true`. Vea [authentication](https://gowa-docs.mintlify.site/es/authentication.md).

## 2. Crear un dispositivo

Cada cuenta de WhatsApp vive en una ranura de dispositivo. Crea una y dale un ID que reutilizará:

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/devices \
  -H "Content-Type: application/json" \
  -d '{"device_id": "my-device"}'
```

Omita `device_id` para obtener un UUID generado.

## 3. Emparejar la cuenta

> [tab] QR code
>
> ```bash theme={null}
> curl -u admin:changeme http://localhost:3000/devices/my-device/login
> ```
>
> Abre `results.qr_link` en un navegador y escanéalo desde WhatsApp → **Dispositivos enlazados** → **Vincula un dispositivo**. El código expira después de `results.qr_duration` segundos; solicite uno nuevo si se repite.

> [tab] Pairing code
>
> ```bash theme={null}
> curl -u admin:changeme -X POST \
>   "http://localhost:3000/devices/my-device/login/code?phone=628123456789"
> ```
>
> Introduzca `results.pair_code` en el teléfono bajo **Dispositivos enlazados** → **Enlace con el número de teléfono en su lugar**.

> [tab] Tablero
>
> Abre `http://localhost:3000/`, introduce tus credenciales de Auth Básica cuando el navegador solicite, y empareja el dispositivo desde la interfaz de usuario.

Confirma que el dispositivo está conectado (`results.is_logged_in` debe ser `true`):

```bash theme={null}
curl -u admin:changeme http://localhost:3000/devices/my-device/status
```

## 4. Enviar un mensaje

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

```json theme={null}
{
  "code": "SUCCESS",
  "message": "Success",
  "results": {
    "message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
    "status": "Message sent to 628123456789 (server timestamp: ...)"
  }
}
```

`phone` toma un número con código de país y sin `+` o espacios, o un JID completo como `628123456789@s.whatsapp.net` o `120363025246125486@g.us` para un grupo. Con solo un dispositivo registrado, `X-Device-Id` es opcional.

## 5. Recibir mensajes

Reinicia con un webhook URL y GOWA POST cada evento a él:

```bash theme={null}
export WHATSAPP_WEBHOOK_SECRET="$(openssl rand -hex 32)"
./whatsapp rest --basic-auth=admin:changeme --webhook=https://example.com/wa-hook
```

Guarde el secreto de webhook generado y configure el mismo valor en su receptor. Reutilizarlo después de reiniciar. Ver [Webhooks](https://gowa-docs.mintlify.site/es/concepts/webhooks.md) para cargas útiles y comprobaciones de firmas.

## Siguientes pasos

> [card] [Instalación](https://gowa-docs.mintlify.site/es/installation.md)
>
> Docker Compose, proxy inverso, PostgreSQL.

> [card] [Referencia de configuración](https://gowa-docs.mintlify.site/es/configuration.md)
>
> Cada bandera y variable de entorno.

> [card] [Multi-dispositivo](https://gowa-docs.mintlify.site/es/concepts/multidevice.md)
>
> Ejecutar varias cuentas en un servidor.

> [card] [Referencia API](https://gowa-docs.mintlify.site/es/api-reference/introduction.md)
>
> Todos los extremos.


## Related topics

- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/es/index.md)
- [Eventos WebSocket](https://gowa-docs.mintlify.site/es/api-reference/websocket.md)
- [Integración de Chatwoot](https://gowa-docs.mintlify.site/es/integrations/chatwoot.md)
- [Iniciar sesión con código de emparejamiento](https://gowa-docs.mintlify.site/es/api-reference/device/iniciar-sesión-con-código-de-emparejamiento.md)
- [Webhooks](https://gowa-docs.mintlify.site/es/concepts/webhooks.md)


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