---
title: "WATokens — API de WhatsApp para todos"
description: "Conecta y envía mensajes de WhatsApp mediante peticiones HTTP. API REST, webhooks, chatbot con reglas e IA, envíos programados, control desde asistentes de IA (MCP) y validador de números."
url: https://watokens.com/
language: es
updated: 2026-10-15
format: text/markdown
sources:
  - https://watokens.com/
  - https://watokens.com/pricing
  - https://documenter.getpostman.com/view/12557860/2sAXjKaY2Q
---

# WATokens — API de WhatsApp para todos

> WATokens es una plataforma SaaS que permite conectar uno o varios números de WhatsApp y enviar mensajes mediante peticiones HTTP (API REST). Incluye mensajes ilimitados (sin cupo mensual), webhooks, chatbot basado en reglas y con IA, envíos programados, control desde asistentes de IA (MCP) y validación de números. Se vincula el número propio escaneando un código QR, igual que en WhatsApp Web.

**Actualizado:** 15 oct 2026 · **Sitio:** https://watokens.com/ · **Idioma:** español

Este documento resume en Markdown el contenido público del sitio, los planes y la documentación de la API para que personas y asistentes de IA puedan leerlo, citarlo e indexarlo fácilmente. Los precios y planes se gestionan dinámicamente en el sitio; ante cualquier diferencia, prevalece https://watokens.com/pricing.

## Índice

1. [Qué es WATokens](#qué-es-watokens)
2. [Funcionalidades](#funcionalidades)
3. [Planes y precios](#planes-y-precios)
4. [Prueba gratis](#prueba-gratis)
5. [Preguntas frecuentes](#preguntas-frecuentes)
6. [API REST](#api-rest)
7. [Webhooks](#webhooks)
8. [Formato de mensajes](#formato-de-mensajes)
9. [Límites](#límites)
10. [Glosario](#glosario)
11. [Contacto y enlaces](#contacto-y-enlaces)

---

## Qué es WATokens

- **Producto:** API de WhatsApp y panel web para empresas y desarrolladores.
- **Lema:** "Conecta WhatsApp via HTTP requests".
- **Público objetivo:** desarrolladores, pymes y empresas que necesitan enviar notificaciones, automatizar conversaciones o integrar WhatsApp en sus sistemas.
- **Integración:** API REST utilizable desde cualquier lenguaje de programación. El sitio muestra ejemplos en C#, Python, PHP y Node.js.
- **Conexión del número:** se vincula el número de WhatsApp propio escaneando un código QR (como WhatsApp Web). Una vez vinculado, se muestran el logotipo, nombre y estado de la cuenta.
- **Cobro:** sin cargos por mensaje ni cupo mensual; los envíos son ilimitados mientras la cuenta esté activa. El único límite es el ritmo seguro que exige WhatsApp (Meta), que el servidor de WATokens controla con pausas y límite por hora.

## Funcionalidades

### Destacadas en el sitio

- **Lema del home (desde 15 oct 2026):** "Conecta tu WhatsApp con IA y con tu sistema".
- **Para integradores:** API REST con token para enviar texto, imágenes y PDF desde CRM, ERP, tiendas online o sistemas de turnos; webhooks para recibir mensajes entrantes y cambios de estado; gestión de instancias, validación de números y grupos. Documentación en Postman.
- **Control desde IA (MCP):** gestiona WhatsApp desde Claude, ChatGPT o Gemini conversando (vincular teléfonos, enviar mensajes, programar recordatorios, verificar números). Detalle en https://watokens.com/mcp.
- **IA y mensajería:** chatbot con IA y por reglas, respuesta automática y envíos programados (recordatorios de citas, pagos y entregas).
- **Uso responsable:** pensado para notificaciones, recordatorios y atención a clientes que esperan el mensaje; no es una herramienta de spam. El servidor aplica pausas aleatorias y límite por hora en los envíos programados. Ninguna herramienta garantiza que WhatsApp no bloquee un número.

### Incluidas en todos los planes

- Mensajes ilimitados, sin cupo mensual.
- API REST con token y webhooks.
- Chatbot basado en reglas y chatbot de IA.
- Envíos programados y validación de números.
- Control desde asistentes de IA (MCP).
- Importación de archivos desde Dropbox, Google Drive y OneDrive.

### Módulos del panel

- Conexión de cuentas de WhatsApp por QR y gestión de instancias.
- API REST con token de acceso.
- Respuesta automática (autoresponder).
- Chatbot por reglas y chatbot con IA.
- Envíos programados por fecha y hora (notificaciones y recordatorios a contactos que esperan el mensaje).
- Plantillas de mensajes. Los mensajes interactivos no son funciones oficiales de WhatsApp y pueden fallar (ver https://watokens.com/terms_of_service).
- Gestión de contactos (importación ilimitada desde Excel).
- Exportación de participantes de grupos.
- Generador de enlaces de WhatsApp.
- Reportes por envío: contactos a los que se envió el mensaje y contactos en los que falló.

## Planes y precios

Precios en USD capturados de https://watokens.com/pricing el 15 oct 2026. El sitio ofrece pago **Mensual** y pago **Anual** (un solo pago por los 12 meses, con descuento).

| Plan | Pago mensual | Pago anual (total) | Ahorro anual | Números de WhatsApp | Almacenamiento | Máx. por archivo |
|---|---|---|---|---|---|---|
| Starter | $10/mes | $120/año | — | 1 | 100 MB | 2 MB |
| Pyme | $50/mes | $540/año | $60 | 30 | 100 MB | 2 MB |
| Business | $95/mes | $1,020/año | $120 | 150 | 100 MB | 2 MB |
| Factory | $250/mes | $2,700/año | $300 | 300 | 500 MB | 2 MB |

- Todos los planes incluyen: mensajes ilimitados sin cupo mensual, API REST, webhooks, chatbot basado en reglas y de IA, envíos programados, validación de números y control desde IA (MCP).
- "No se requiere tarjeta, cancela en cualquier momento."
- ¿No encuentras el plan que necesitas? Contáctanos (ver [Contacto y enlaces](#contacto-y-enlaces)).

## Prueba gratis

- Duración: **7 días**.
- No necesitas ingresar un medio de pago para registrarte.
- La versión demo incluye mensajes ilimitados durante 7 días y conexión a **1 dispositivo**.
- Al terminar la prueba, la cuenta se bloquea automáticamente hasta contratar un plan.
- Registro: https://watokens.com/signup

## Preguntas frecuentes

### ¿Qué es un Token?
Un token es una llave de acceso que se crea en tu cuenta de WATokens para que puedas hacer uso de la API REST.

### ¿Qué es una Instancia?
Una instancia es una conexión existente con WhatsApp. Al conectarte con la API o en la plataforma se crea una secuencia alfanumérica única por cada número y token, con la cual puedes identificar dicha vinculación.

### ¿Puedo integrar en mi desarrollo la lectura de un QR para conectar WhatsApp?
Sí, siguiendo las guías de integración (endpoints `create_instance` y `get_qrcode`).

### ¿Existe algún límite para enviar archivos?
Sí. Los archivos enviados a través de la API no pueden ser mayores a 2 MB.

### ¿Me cobran por envío?
No. Con WATokens los envíos son ilimitados durante el tiempo que tengas activa tu cuenta.

### ¿Puedo verificar si un número tiene WhatsApp antes de enviar?
Sí. El servicio `check_phone` consulta un número en formato internacional e indica si tiene WhatsApp.

### ¿Qué sucede después de la prueba gratis?
Luego de los 7 días de prueba, la cuenta se bloquea automáticamente y no podrás seguir administrándola.

### ¿Necesito ingresar un medio de pago para registrarme?
No. Puedes comenzar tu prueba gratis inmediatamente, sin ingresar ningún método de pago.

### ¿WATokens tiene una API para integrarlo a sistemas externos?
Sí. Puedes enviar mensajes de WhatsApp y todo tipo de archivos no mayores a 2 MB.

### ¿Cuántos contactos puedo cargar?
Tantos como tengas. Se pueden cargar contactos ilimitados desde un archivo de Excel y cambiar la lista tantas veces como necesites.

### ¿Puedo usar mi propio número de WhatsApp?
Sí. Solo necesitas vincular tu cuenta escaneando el código QR, del mismo modo que con WhatsApp Web.

### ¿Puedo enviar texto en negrita, cursiva y tachado?
Sí. Consulta [Formato de mensajes](#formato-de-mensajes).

### ¿El software genera reportes?
Sí. Por cada envío se genera un reporte con los contactos a los que se envió el mensaje y aquellos en los que el envío falló. El reporte se puede guardar; de lo contrario, se reemplaza en el siguiente envío.

### ¿Qué incluye la versión demo?
Mensajes ilimitados durante 7 días y conexión a 1 dispositivo.

---

## API REST

- **URL base:** `https://watokens.com/api/`
- **Documentación oficial (Postman):** https://documenter.getpostman.com/view/12557860/2sAXjKaY2Q
- **Autenticación:** parámetro `access_token` (el token de tu cuenta).
- **Instancia:** parámetro `instance_id` (identificador de la conexión de WhatsApp).
- **Parámetros:** se envían en la query string o en el cuerpo de la petición. Los endpoints de envío también aceptan un cuerpo JSON.
- **Formato de respuesta:** JSON con `status` (`success` o `error`) y `message`.
- **Formato de números:** internacional, solo dígitos, sin `+` (ejemplo: `593989869767`).

En los ejemplos, sustituye `TOKEN` por tu token y `INSTANCE_ID` por tu instancia. Nunca publiques tu token.

### Flujo básico

1. Crea una instancia con `create_instance`.
2. Obtén el QR con `get_qrcode` y escanéalo desde WhatsApp → Dispositivos vinculados.
3. (Opcional) Configura un webhook con `set_webhook`.
4. Envía mensajes con `send` o `send_group`.

### Gestión de instancias

#### `GET create_instance`
Crea un nuevo identificador de instancia.

```bash
curl "https://watokens.com/api/create_instance?access_token=TOKEN"
```

```json
{ "status": "success", "message": "Instance ID generated successfully", "instance_id": "INSTANCE_ID" }
```

#### `GET get_qrcode`
Devuelve el código QR (imagen PNG en base64) para vincular el número.

```bash
curl "https://watokens.com/api/get_qrcode?instance_id=INSTANCE_ID&access_token=TOKEN"
```

```json
{ "status": "success", "message": "Success", "base64": "data:image/png;base64,..." }
```

#### `GET reconnect`
Reconecta la instancia y devuelve los datos de la cuenta vinculada (`id`, `name`, `avatar`, entre otros).

```bash
curl "https://watokens.com/api/reconnect?instance_id=INSTANCE_ID&access_token=TOKEN"
```

#### `GET reboot`
Cierra la sesión de WhatsApp de la instancia y genera un nuevo QR.

```bash
curl "https://watokens.com/api/reboot?instance_id=INSTANCE_ID&access_token=TOKEN"
```

#### `GET reset_instance`
Cierra la sesión y elimina todos los datos de la instancia.

```bash
curl "https://watokens.com/api/reset_instance?instance_id=INSTANCE_ID&access_token=TOKEN"
```

#### `request_pairing_code` (alternativa al QR)
Solicita un código de emparejamiento de 8 caracteres para vincular el número sin escanear QR. Parámetros: `phone`, `instance_id`, `access_token`. Disponible en el código del servicio; no figura en la colección de Postman.

### Validación de números

#### `GET check_phone`
Indica si un número tiene WhatsApp.

```bash
curl "https://watokens.com/api/check_phone?access_token=TOKEN&phone=593989869767"
```

```json
{
  "status": "success",
  "message": "available",
  "number": "593989869767",
  "data": [{ "exists": true, "jid": "593989869767@s.whatsapp.net" }],
  "is_valid": true
}
```

### Envío de mensajes

#### `POST send` — texto

| Parámetro | Requerido | Descripción |
|---|---|---|
| `number` | Sí | Número de destino en formato internacional. |
| `type` | Sí | `text` |
| `message` | Sí | Texto del mensaje. |
| `instance_id` | Sí | Instancia emisora. |
| `access_token` | Sí | Token de acceso. |

```bash
curl -X POST "https://watokens.com/api/send" \
  -d "number=593989869767" \
  -d "type=text" \
  -d "message=Hola desde WATokens" \
  -d "instance_id=INSTANCE_ID" \
  -d "access_token=TOKEN"
```

```json
{
  "status": "success",
  "message": "Success",
  "data": { "key": { "...": "..." }, "message": { "...": "..." }, "messageTimestamp": "...", "status": "SUCCESS" }
}
```

#### `POST send` — archivo por URL (imagen, PDF u otro)

| Parámetro | Requerido | Descripción |
|---|---|---|
| `type` | Sí | `media` |
| `media_url` | Sí* | URL pública del archivo. |
| `filename` | Recomendado | Nombre del archivo, por ejemplo `factura.pdf`. |
| `message` | No | Texto o pie del archivo. |

```bash
curl -X POST "https://watokens.com/api/send" \
  -d "number=593989869767" \
  -d "type=media" \
  -d "message=Tu factura" \
  -d "media_url=https://example.com/factura.pdf" \
  -d "filename=factura.pdf" \
  -d "instance_id=INSTANCE_ID" \
  -d "access_token=TOKEN"
```

#### `POST send` — archivo en base64

\*En lugar de `media_url` se puede enviar el parámetro `file` con el contenido del archivo en base64 (por ejemplo, un PDF generado por tu sistema) junto con `filename`.

```json
{
  "number": "593989869767",
  "type": "media",
  "message": "Proforma adjunta",
  "filename": "proforma.pdf",
  "file": "JVBERi0xLjQK...",
  "instance_id": "INSTANCE_ID",
  "access_token": "TOKEN"
}
```

#### `GET get_groups`
Lista los grupos de la cuenta vinculada (`id` con sufijo `@g.us`, `name`, `size`).

```bash
curl "https://watokens.com/api/get_groups?instance_id=INSTANCE_ID&access_token=TOKEN"
```

#### `POST send_group`
Envía un mensaje a un grupo. Acepta los mismos `type`, `message`, `media_url`, `filename` y `file` que `send`, usando `group_id` en lugar de `number`.

```bash
curl -X POST "https://watokens.com/api/send_group" \
  -d "group_id=120363000000000000@g.us" \
  -d "type=text" \
  -d "message=Hola grupo" \
  -d "instance_id=INSTANCE_ID" \
  -d "access_token=TOKEN"
```

#### `POST send_template` (solo WhatsApp Cloud API)
Envía una plantilla aprobada por Meta en cuentas conectadas mediante WhatsApp Cloud API. Cuerpo JSON: `number`, `template_name`, `language_code` (por defecto `en`), `components` (opcional), `instance_id`, `access_token`.

### Errores frecuentes

| Mensaje | Causa |
|---|---|
| `Access token is required` / `Access token does not exist` | Falta el token o no es válido. |
| `Instance ID is required` | Falta `instance_id`. |
| `Instance ID Invalidated` | La instancia no existe para ese token. |
| `This instance ID has not been activated yet` | La instancia aún no se vinculó (escanea el QR). |
| `This WhatsApp account relogin required` | La sesión de WhatsApp se cerró; vuelve a vincular el número. |
| `Phone number is required` | Falta `phone` o no es numérico. |

## Webhooks

#### `GET set_webhook`
Registra una URL que recibirá eventos de la instancia mediante peticiones `POST`.

| Parámetro | Requerido | Descripción |
|---|---|---|
| `webhook_url` | Sí | URL pública HTTPS que recibirá los eventos. |
| `enable` | Sí | `true` para activar, `false` para desactivar. |
| `instance_id` | Sí | Instancia. |
| `access_token` | Sí | Token. |
| `allowed_events` | No | Filtra qué eventos se reenvían. |

```bash
curl "https://watokens.com/api/set_webhook?webhook_url=https://tu-servidor.com/webhook&enable=true&instance_id=INSTANCE_ID&access_token=TOKEN"
```

Cada evento se envía como JSON con la forma `{ "instance_id": "...", "data": { ... } }`. Eventos emitidos por el servicio:

- `received_message`: mensaje entrante simplificado (incluye el texto del mensaje, la clave del mensaje, el nombre del remitente y el contacto de origen).
- `messages.upsert`: mensajes nuevos.
- `messages.update`: cambios de estado de mensajes.
- `contacts.upsert` y `contacts.update`: contactos nuevos o actualizados.
- `groups.update`: cambios en grupos.

## Formato de mensajes

| Estilo | Sintaxis | Ejemplo |
|---|---|---|
| Negrita | `*texto*` | `*Pedido confirmado*` |
| Cursiva | `_texto_` | `_Gracias por tu compra_` |
| Tachado | `~texto~` | `~$20~ $15` |

Los saltos de línea se envían como `\n` (URL-encoded `%0A` en la query string).

## Límites

- Tamaño máximo por archivo enviado por la API: **2 MB**.
- Almacenamiento por cuenta según el plan: 100 MB (Starter, Pyme, Business) o 500 MB (Factory).
- Números de WhatsApp conectados según el plan: 1, 30, 150 o 300.
- Mensajes: ilimitados en todos los planes, sin cupo mensual. El único límite es el ritmo seguro que exige WhatsApp (Meta); el servidor aplica pausas aleatorias y un límite por hora para proteger el número.

## Glosario

- **Token (`access_token`):** llave de acceso de tu cuenta para usar la API.
- **Instancia (`instance_id`):** identificador alfanumérico único de una conexión de WhatsApp.
- **QR:** código que se escanea desde WhatsApp → Dispositivos vinculados para conectar el número.
- **Código de emparejamiento:** alternativa de 8 caracteres al QR.
- **Webhook:** URL de tu sistema que recibe eventos (por ejemplo, mensajes entrantes).
- **JID:** identificador interno de WhatsApp (`numero@s.whatsapp.net` para contactos, `id@g.us` para grupos).
- **Chatbot de IA:** respuestas automáticas generadas por inteligencia artificial.

## Arquitectura (resumen)

- Panel web y API REST en PHP (CodeIgniter 4).
- Servicio de mensajería en Node.js (Express + Socket.IO) basado en el protocolo multidispositivo de WhatsApp Web (Baileys), con colas en Redis y base de datos MySQL.
- Integración opcional con WhatsApp Cloud API (Meta) para plantillas.
- Estado del servicio: https://estadodelservidor.com/s/watokens/

## Contacto y enlaces

- Sitio web: https://watokens.com/
- Planes y precios: https://watokens.com/pricing
- Preguntas frecuentes: https://watokens.com/faqs
- Blog: https://watokens.com/blogs
- Registro (prueba gratis 7 días): https://watokens.com/signup
- Acceso: https://watokens.com/login
- Documentación API (Postman): https://documenter.getpostman.com/view/12557860/2sAXjKaY2Q
- Estado de la API: https://estadodelservidor.com/s/watokens/
- Ventas y contacto: hola@watokens.com
- Soporte técnico: ayuda@watokens.com
- WhatsApp (ventas y programa de partners): https://api.whatsapp.com/send?phone=593989869767
- Política de privacidad: https://watokens.com/privacy_policy
- Términos y condiciones: https://watokens.com/terms_of_service
- Índice para IA: https://watokens.com/llms.txt