# SDK de TypeScript para WhatsApp: ¿cuántas líneas hacen falta?

> npm install, una clave API y una llamada tipada: envía WhatsApp desde Node.js o Next.js, con multimedia y webhooks incluidos, sin cuenta business de Meta.

Source: https://unlimitedmessaging.app/es/articles/typescript-sdk

SDK de TypeScript / Node.js

# Envía WhatsApp en TypeScript,  
_en unas líneas._

El SDK de TypeScript de Unlimited Messaging te da un cliente totalmente tipado para enviar mensajes de WhatsApp desde Node.js, Next.js o cualquier runtime serverless. Instala el paquete npm, añade tu clave API, y envía - desde tu cuenta normal de WhatsApp, sin la API oficial de Meta.

[Obtener mi clave API](https://app.unlimitedmessaging.app)[Ver precios](https://unlimitedmessaging.app/es/pricing)

El contexto

## ¿Qué es el SDK de TypeScript para WhatsApp de Unlimited Messaging?

El SDK de TypeScript es un paquete [npm](https://www.npmjs.com) totalmente tipado que envuelve nuestra API REST: instalas el cliente, lo autenticas con una clave API, y envías mensajes de WhatsApp desde Node.js, Next.js o una función serverless en unas líneas.

Sin SDK, integrar WhatsApp en Node.js significa escribir llamadas HTTP puras con fetch: construir la URL, serializar el JSON, gestionar las cabeceras de autenticación, parsear la respuesta y adivinar la forma exacta del payload. El SDK de TypeScript hace todo eso por ti: un objeto UnlimitedMessagingApiClient, métodos tipados como client.messages.messageSend(), y el autocompletado de tu editor que te guía en cada campo.

Como todos los tipos de petición y respuesta se generan desde la especificación OpenAPI y se exportan con el paquete, una errata en el nombre de un campo o un destinatario mal formado se detecta en tiempo de compilación - no en producción. Conservas la robustez de una API REST de verdad, pero con la ergonomía de una librería pensada para TypeScript.

Y sobre todo, el SDK se apoya en tu cuenta normal de WhatsApp: sin cuenta Meta Business que verificar, sin plantilla que aprobar, sin facturación por mensaje. Un POST se convierte en una llamada de método, y el envío de WhatsApp desde un backend Node o Next.js cabe en tres líneas - OTP, notificaciones transaccionales, bots.

![La pantalla de un portátil muestra código de colores en una habitación oscura, con el titular «WhatsApp desde TypeScript en unas líneas».](https://unlimitedmessaging.app/_next/image?url=%2Fassets%2Farticles%2Fcovers%2Ftypescript-sdk-es.png&w=3840&q=75)

Definición
SDK de TypeScript (Unlimited Messaging)

Un paquete npm totalmente tipado que envuelve la API REST de Unlimited Messaging para enviar mensajes de WhatsApp, gestionar multimedia y webhooks desde cualquier proyecto de TypeScript o Node.js.

También llamado SDK Node.js de WhatsApp o cliente WhatsApp de JavaScript - el paquete npm oficial de Unlimited Messaging.

[Fuente: npm - registro de paquetes de JavaScript↗](https://www.npmjs.com)

Comparativa

## API oficial de Meta en Node vs SDK de TypeScript de Unlimited Messaging

El mismo objetivo - enviar un mensaje de WhatsApp desde código TypeScript - pero dos niveles de esfuerzo muy distintos. A la izquierda, la API Cloud oficial de Meta llamada con fetch puro; a la derecha, nuestro SDK npm tipado. Línea por línea, esto es lo que pide cada uno.

__API oficial de Meta en Node vs SDK de TypeScript de Unlimited Messaging__
| API oficial de Meta en Node (fetch puro)WhatsApp Cloud API | SDK de TypeScript de Unlimited Messagingpaquete npm tipado |                                            |
| ---------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------ |
| Instalación                                                | Ningún paquete, fetch escrito a mano                       | npm install @unlimited-messaging/sdk       |
| Tipado                                                     | Ninguno, payloads JSON sin tipar                           | Peticiones y respuestas totalmente tipadas |
| Cuenta business requerida                                  | Cuenta Meta Business verificada                            | Tu cuenta normal de WhatsApp               |
| Plantillas                                                 | Aprobación de Meta obligatoria                             | Sin validación, texto libre                |
| Líneas de código para enviar                               | Una decena (URL, cabeceras, body, fetch)                   | Tres: import, cliente, send()              |
| Multimedia                                                 | Subida y luego referencia por ID de medio                  | Imagen, PDF o vídeo por simple URL         |
| Webhooks                                                   | Endpoint que verificar y alojar                            | Webhooks de estado listos para conectar    |
| Sin límites                                                | Facturación por mensaje                                    | Precio fijo, mensajes ilimitados           |

Nuestro enfoque

## Un SDK de TypeScript hecho a medida para Node.js y el serverless

Mantenemos la potencia de la API REST - multimedia, webhooks, estados de entrega - y la vestimos con un cliente npm tipado que se integra en unas líneas en cualquier proyecto de JavaScript.

### Totalmente tipado, de extremo a extremo

Cada tipo de petición y respuesta se genera desde la especificación OpenAPI y se exporta con el paquete. Tu editor autocompleta los campos, y los errores de payload se atrapan en tiempo de compilación, no en producción.

1. 01  
### Instalado desde npm  
Un npm install @unlimited-messaging/sdk y el cliente está listo. Compatible con Node.js, Next.js y la mayoría de los runtimes serverless.
2. 02  
### Multimedia y webhooks incluidos  
Envía imágenes, PDF y vídeos por URL, y recibe los estados entregado / leído / respuesta mediante webhooks JSON en tiempo real.
3. 03  
### Tu cuenta, sin límites  
El SDK envía desde tu cuenta normal de WhatsApp. Sin API oficial de Meta, sin plantillas, sin coste por mensaje.

Líneas para enviar un WhatsApp

3Líneas para enviar un WhatsApp

Peticiones y respuestas tipadas

100 %Peticiones y respuestas tipadas

Cuentas business de Meta requeridas

0Cuentas business de Meta requeridas

Del npm install al primer envío

5 minDel npm install al primer envío

Cómo funciona

## Enviar un WhatsApp en TypeScript en tres pasos

1. 01  
### Instala el SDK  
npm install @unlimited-messaging/sdk en tu proyecto Node.js o Next.js. El cliente tipado está listo para usar.
2. 02  
### Autentícate  
Genera una clave API desde el panel y pásala al constructor de UnlimitedMessagingApiClient. Una clave por proyecto, revocable en cualquier momento.
3. 03  
### Llama a send()  
client.messages.messageSend({ recipient, text }) envía el mensaje de WhatsApp. Añade una URL de multimedia si lo necesitas, y escucha los webhooks de entrega.

Para recordar

### Un fetch puro te hace programar una integración. El SDK te hace escribir tres líneas.

Si trabajas en TypeScript, no tienes ninguna razón para ensamblar llamadas HTTP a mano para enviar un WhatsApp. Instala el SDK, dale tu clave API, llama a send() - desde un backend Node, una ruta API de Next.js o una función serverless. Conservas el tipado, la multimedia y los webhooks, sin cuenta business de Meta ni plantillas, sin límites.

FAQ

## Preguntas sobre el SDK de TypeScript para WhatsApp

Instala el paquete con npm install @unlimited-messaging/sdk, crea un UnlimitedMessagingApiClient con tu clave API, y luego llama a client.messages.messageSend({ recipient, text }). Tres líneas bastan, desde cualquier proyecto Node.js o Next.js.

Sí. Todos los tipos de petición y respuesta se generan desde la especificación OpenAPI y se exportan con el paquete, así que tu editor autocompleta los campos y los errores se detectan en tiempo de compilación.

No. El SDK envía desde tu cuenta normal de WhatsApp, conectada escaneando un código QR. Sin cuenta Meta Business que verificar, sin plantilla que aprobar, sin API Cloud oficial que configurar.

Sí. Envías imágenes, PDF y vídeos mediante una URL, y recibes webhooks JSON en tiempo real para los estados entregado, leído y respuesta recibida.

Sí. El SDK apunta a Node.js estándar y funciona en las rutas API de Next.js, las edge functions y la mayoría de las plataformas serverless. La compatibilidad con Deno y Bun está en la hoja de ruta.

Sí. La facturación es una suscripción mensual a precio fijo, sin coste por mensaje como impone la API oficial de WhatsApp Business. Envías tantos mensajes de WhatsApp como necesites.

Fuentes

## Fuentes y referencias

Para verificar por ti mismo la información de este artículo:

1. [01npm - registro oficial de paquetes de JavaScript↗npm](https://www.npmjs.com)
2. [02API Fetch global de Node.js↗Node.js](https://nodejs.org/api/globals.html#fetch)
3. [03WhatsApp Cloud API - documentación oficial↗Meta for Developers](https://developers.facebook.com/docs/whatsapp/cloud-api)
4. [04WhatsApp Business - presentación oficial↗WhatsApp](https://www.whatsapp.com/business)

![Ilian, ingeniero de software senior](https://ilianazz.com/images/iliazz.png)

Escrito por

[Ilian](https://unlimitedmessaging.app/es/authors/ilian) · Ingeniero de software senior

Ingeniero de software senior, funda y dirige varias empresas tecnológicas. Diseña productos en torno a las API de mensajería, la automatización y la integración de la IA, y comparte aquí lo que aprende construyendo.

[Ver el perfil de LinkedIn↗](https://www.linkedin.com/in/ilianAzz/)Actualizado el 6 de noviembre de 2026

![](https://unlimitedmessaging.app/assets/logos/whatsapp.svg)![](https://unlimitedmessaging.app/assets/logos/email.svg)![](https://unlimitedmessaging.app/assets/logos/sms.svg)

## Envía tu primer WhatsApp en TypeScript hoy mismo.

Crea tu cuenta, genera tu clave API e instala el SDK: tres líneas te separan de tu primer mensaje de WhatsApp.

[Obtener mi clave API→](https://app.unlimitedmessaging.app)

Artículos similares
* [![](https://unlimitedmessaging.app/_next/image?url=%2Fassets%2Farticles%2Fcovers%2Fpython-sdk-es.png&w=3840&q=75)Envía WhatsApp desde Python con un simple pip installEnvía mensajes de WhatsApp desde Python con pip install unlimited-messaging.](https://unlimitedmessaging.app/es/articles/python-sdk)
* [![](https://unlimitedmessaging.app/_next/image?url=%2Fassets%2Farticles%2Fcovers%2Fwhatsapp-api-es.png&w=3840&q=75)API REST de WhatsApp: tu primer mensaje desde código, paso a pasoMensajería programática de WhatsApp via una API REST simple.](https://unlimitedmessaging.app/es/articles/whatsapp-api)
* [![](https://unlimitedmessaging.app/_next/image?url=%2Fassets%2Farticles%2Fcovers%2Fmcp-es.png&w=3840&q=75)¿Qué es un servidor MCP para WhatsApp? Guía 2026Conecta cualquier asistente de IA compatible con MCP a WhatsApp via OAuth 2.0.](https://unlimitedmessaging.app/es/articles/mcp)
