# QR de WhatsApp

Crea un código QR que abre un chat de WhatsApp con tu número y un mensaje ya escrito.

- Página: https://herramient.as/qr-whatsapp
- Categoría: Generadores
- Dónde se ejecuta: en nuestro servidor

Es una herramienta interactiva: se usa desde el navegador en https://herramient.as/qr-whatsapp.

## Uso por API

También se puede usar por API REST, con una clave en la cabecera `Authorization: Bearer htas_...`. Referencia completa: https://herramient.as/api-docs.md

### `POST /api/v1/tools/qr/whatsapp`

Genera un código QR que abre un chat de WhatsApp

Compone un enlace wa.me con el número en formato internacional y el mensaje inicial codificado. Un número de 9 cifras sin prefijo que empieza por 6, 7, 8 o 9 se entiende español (+34).

Consume 3 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `phone` | string | sí | Número de teléfono. Admite espacios, guiones y el prefijo con + o 00 (Ejemplo: `600 12 34 56`) |
| `message` | string | no | Mensaje que aparece ya escrito al abrir el chat (Ejemplo: `Hola, quiero reservar mesa`) |
| `format` | string | no | Formato de salida. Por defecto png (Ejemplo: `png`) |
| `size` | integer | no | Ancho en píxeles. Por defecto 512. Con firma, el alto es un 8 % mayor (Ejemplo: `1024`) |
| `style` | string | no | Forma de los módulos. Por defecto rounded (Ejemplo: `rounded`) |
| `eyes` | string | no | Forma de las tres esquinas. Por defecto rounded (Ejemplo: `rounded`) |
| `color` | string | no | Color del código en hexadecimal. Por defecto #111827 (Ejemplo: `#1e3a8a`) |
| `eye_color` | string | no | Color de las esquinas. Por defecto el de color (Ejemplo: `#1e3a8a`) |
| `background` | string | no | Color del fondo. Por defecto #ffffff (Ejemplo: `#ffffff`) |
| `caption` | boolean | no | Firma «creado con herramient.as» debajo del código. Por defecto true (Ejemplo: `true`) |
| `icon` | string | no | Icono para el centro del código, dibujado en vectorial. Se ignora si se manda logo (Ejemplo: `wifi`) |
| `logo` | file | no | Imagen PNG, JPG o WebP de hasta 5 MB para el centro del código, como multipart/form-data |
| `logo_size` | string | no | Tamaño del logo. Por defecto medium (Ejemplo: `medium`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `url` | string | URL de descarga del fichero generado |
| `expires_at` | string | Cuándo se eliminará el fichero |
| `content` | string | El texto codificado en el QR |
| `format` | string | Formato generado |
| `size` | integer | Ancho pedido |
| `width` | integer | Ancho de la imagen en píxeles |
| `height` | integer | Alto de la imagen en píxeles |
| `warnings` | array | Avisos que pueden impedir escanearlo, como poco contraste. No bloquean la generación |

**Errores**

- `400`: Faltan datos, el contenido no cabe en un QR, o una opción o un color no son válidos
- `422`: El logo no se ha podido leer como imagen
- `503`: El servicio que procesa el logo no está disponible; reintenta en unos segundos

```bash
curl -X POST https://herramient.as/api/v1/tools/qr/whatsapp \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"phone":"600 12 34 56","message":"Hola, quiero reservar mesa","format":"png","size":1024,"style":"rounded","eyes":"rounded","color":"#1e3a8a","eye_color":"#1e3a8a","background":"#ffffff","caption":true,"icon":"wifi","logo_size":"medium"}'
```

## Para entenderlo

- [Cómo crear un enlace o un QR de WhatsApp para tu negocio](https://herramient.as/guias/como-crear-enlace-qr-whatsapp): Cómo se forma el enlace oficial de WhatsApp, el truco del mensaje distinto en cada cartel, y ejemplos para inmobiliarias, restaurantes, tiendas, profesionales y alojamientos turísticos.

## Preguntas frecuentes

### ¿Para qué sirve un QR de WhatsApp?

Abre un chat con tu número directamente, sin que el cliente tenga que guardarte en la agenda. Es muy útil en escaparates, tarjetas, cartas de restaurante, folletos o el mostrador, para reservas, pedidos o dudas.

### ¿Puedo dejar un mensaje ya escrito?

Sí. Lo que escribas en el mensaje inicial aparece en la caja de texto al abrir el chat, y quien escanea solo tiene que pulsar enviar. Sirve para saber de dónde viene el contacto: por ejemplo, «Hola, vengo del cartel de la tienda».

### ¿Funciona con WhatsApp Business?

Sí, con cualquier número que tenga WhatsApp, sea la aplicación normal o la de empresa. El enlace es el oficial de WhatsApp (wa.me), así que no depende de nosotros y seguirá funcionando aunque desaparezcamos.

### ¿Cómo escribo un número de otro país?

Empieza por el símbolo + y el prefijo del país, por ejemplo +351 para Portugal o +52 para México. Si escribes nueve cifras sin prefijo, entendemos que es un número español y añadimos el +34.

### ¿Se ve mi número al escanearlo?

Sí, el número va dentro del enlace y aparece en el chat que se abre. Es inevitable: WhatsApp necesita saber a quién escribir. Si no quieres usar tu número personal, usa uno de empresa.

## Herramientas relacionadas

- [Generador de códigos QR](https://herramient.as/qr): Crea códigos QR en PNG o SVG para compartir enlaces y texto. Máximo 2.000 caracteres. Los archivos se eliminan automáticamente en 24 horas.
- [QR de reseñas de Google](https://herramient.as/qr-resenas-google): Crea un código QR que lleva a tus clientes directos a dejarte una reseña en Google.
- [QR de tarjeta de contacto](https://herramient.as/qr-tarjeta-contacto): Crea un código QR con tus datos de contacto (vCard) para que te guarden en la agenda con un toque.
- [Generador DNI/NIE](https://herramient.as/dni-nif-generator): Genera números de identificación españoles (DNI, NIE) válidos con letra de control correcta para pruebas.