Construir
ES
Click-to-chat de WhatsApp

API de enlaces de WhatsApp: wa.me y api.whatsapp.com explicados

Un enlace de WhatsApp es una URL, no una API. Aquí tiene los formatos exactos, el parámetro text, un generador gratuito y dónde se detiene el enlace.

Construir ahora
Cómo funciona

API de enlaces de WhatsApp: cómo funcionan realmente los enlaces wa.me y api.whatsapp.com

Ambos abren un chat y luego una persona toma el relevo.

  1. 1Alguien abre la URL
  2. 2WhatsApp abre el chat
  3. 3Una persona pulsa enviar
Definición

¿Qué es una API de enlaces de WhatsApp?

No existe una API de enlaces de WhatsApp. https://wa.me/<número> y https://api.whatsapp.com/send?phone=<número> son URLs click-to-chat. Las API empiezan donde se detiene el enlace.

Un enlace de WhatsApp
Configuración
Ninguna
Al hacer clic
Abre un chat y prellena el texto
Quién actúa
Una persona pulsa enviar
Una API de WhatsApp
Configuración
Conexión de la cuenta y una clave API
Al llamarla
Envía, recibe y lista mensajes
Quién actúa
Su software, en nombre de la cuenta conectada
Formato

¿Cuál es el formato exacto del enlace wa.me?

El formato documentado es https://wa.me/<número>, con el número de teléfono completo en formato internacional.

Anatomía de la URL
https://wa.me/1XXXXXXXXXX
Host. Siempre el mismo.
Número. Primero el código de país, solo dígitos.
Usarhttps://wa.me/1XXXXXXXXXX
No usarhttps://wa.me/+001-(XXX)XXXXXXX
Eliminar antes de construir+0 inicialEspaciosGuionesParéntesis

Fuente: Servicio de ayuda de WhatsApp, «Cómo usar la función de clic para chatear»

Comparativa

¿Qué diferencia hay entre wa.me y api.whatsapp.com/send?

Ambos abren la misma conversación. Solo cambia la posición del número.

wa.meDocumentado
https://wa.me/1XXXXXXXXXX?text=Hi

Número en la ruta. Documentado por WhatsApp.

api.whatsapp.com/sendAún muy usado
https://api.whatsapp.com/send?phone=1XXXXXXXXXX&text=Hi

Número en el parámetro phone. No figura en la página de ayuda actual que encontramos.

Un vacío de documentación, no una retirada. Cree los nuevos enlaces con wa.me.

El parámetro text

¿Cómo se añade un mensaje prellenado a un enlace de WhatsApp?

Añada ?text= y el mensaje codificado para URL: https://wa.me/<número>?text=<textocodificado>. El texto sigue siendo editable.

Caracteres que codificar
Espacio%20
Salto de línea%0A
&%26
#%23
+%2B

Emojis y todo lo demás: encodeURIComponent().

¿Sin número? https://wa.me/?text=... abre el selector de contactos.

build-link.js
const number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}` +
  `?text=${encodeURIComponent(text)}`;
https://wa.me/1XXXXXXXXXX?text=Hi!%20I%20have%20a%20question.
Herramienta gratuita

Genere su enlace de WhatsApp

Escriba un número y un mensaje, y copie lo que necesite.

Solo dígitos, primero el código de país.
Opcional y editable.

Se ejecuta en su navegador. Ningún número se envía a un servidor.

Enlace wa.me
https://wa.me/15550123456?text=Hola%2C%20tengo%20una%20pregunta%20sobre%20su%20producto.
Equivalente api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Hola%2C%20tengo%20una%20pregunta%20sobre%20su%20producto.
Parámetro text, codificado
Hola%2C%20tengo%20una%20pregunta%20sobre%20su%20producto.
Fragmento HTML
<a href="https://wa.me/15550123456?text=Hola%2C%20tengo%20una%20pregunta%20sobre%20su%20producto." target="_blank" rel="noopener" aria-label="Chat on WhatsApp with 15550123456">Chat on WhatsApp</a>
Botón «Chat on WhatsApp»
<a href="https://wa.me/15550123456?text=Hola%2C%20tengo%20una%20pregunta%20sobre%20su%20producto." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chat on WhatsApp</a>

Un enlace abre un chat. No envía nada y su producto nunca ve la respuesta.

Construya lo que un enlace no puede hacer
Respuesta corta

¿Un enlace de WhatsApp envía el mensaje?

No. No se entrega nada hasta que la persona que tiene el teléfono pulsa enviar.

Chat abierto
Texto prellenado
Entregado solo tras pulsar enviar
Dónde se detiene el enlace

¿Qué no puede hacer un enlace de WhatsApp?

Un enlace click-to-chat no tiene estado: su app nunca sabe qué pasó después.

Lo que hace el enlace
  • Clic en el enlace
  • Se abre el chat
  • Mensaje prellenado
  • Envío manual
Aquí se detiene el enlace
Lo que requiere una API
  • Respuesta recibida
  • Historial de la conversación
  • Evento de webhook
  • Atribución por usuario
Sin estado de entrega ni de lectura
Sin archivos adjuntos
Sin activación desde el servidor
Fallo silencioso con un número sin WhatsApp
Comportamiento distinto según el dispositivo
Sin grupos, consulte los límites de la API de grupos de WhatsApp
Cree una integración real de WhatsApp
Más allá del enlace

¿Cómo se recibe la respuesta en su app?

Necesita una API que mantenga una sesión de WhatsApp. Existen dos vías.

Meta Cloud APIEmpresa verificada
  • Requiere una cuenta de WhatsApp Business verificada
  • Facturación por mensaje desde el 1 de julio de 2025, consulte los precios de la API de WhatsApp Business
  • Respuestas en la ventana de 24 horas: 1000 gratuitas por número al mes desde el 1 de octubre de 2026
Cuenta conectada, UnipileSin verificación Business
  • Cada usuario final conecta su propia cuenta de WhatsApp
  • Su app actúa en nombre del usuario autenticado
  • Lee y envía desde la inbox real, respuestas incluidas
  • La misma API que para LinkedIn, Telegram, Gmail y más
Con Unipile
  1. 1Conecte la cuenta con código QR o código de vinculación
  2. 2Envíe desde su app
  3. 3Reciba las respuestas por webhook: message_received

Consulte la API de WhatsApp de Unipile y cómo enviar mensajes de WhatsApp por API. Referencia: developer.unipile.com/v1.0/docs/whatsapp.

Constrúyalo con Unipile
Decisión

Enlace, Cloud API o cuenta conectada: ¿cuál necesita?

Elija según quién escribe primero.

Un enlace

Una persona inicia el chat desde su página.

Autenticación
Ninguna
Coste
Gratuito
Respuestas
No visibles para su app
Use el generador de arriba
Meta Cloud API

Una empresa verificada envía plantillas.

Autenticación
Cuenta de Meta Business verificada
Coste
Por mensaje, desde el 1 de julio de 2025
Respuestas
Sí, por webhook
Guía de integración de WhatsApp Cloud API
Cuenta conectada

Su producto trabaja en la propia inbox de cada usuario.

Autenticación
Código QR o código de vinculación
Coste
Plan de Unipile, sin facturación por mensaje
Respuestas
Sí, por webhook
Guía completa de la API de WhatsApp
Empiece a construir
Implementación

¿Cómo se integra un enlace de WhatsApp en un producto?

Constrúyalo por usuario en sus plantillas. Nunca fije un único número en el código de un producto multi-tenant.

Plantilla del enlace
https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}
Número. Desde el registro del usuario.
Texto. Codificado para URL al renderizar.
Botón oficial

La insignia verde «Chat on WhatsApp» de WhatsApp, tal cual.

Código QR

Cualquier generador de QR convierte un enlace wa.me en un código imprimible.

Dónde se abre
Móvil
La app de WhatsApp
Escritorio, con app
La app de escritorio
Escritorio, sin app
WhatsApp Web
Solución de problemas

¿Por qué no funciona mi enlace de WhatsApp?

Casi siempre: el formato del número o un texto sin codificar.

1 El número no está en formato internacional simple
https://wa.me/+001-(XXX)XXXXXXX
https://wa.me/1XXXXXXXXXX

Solución: solo dígitos, primero el código de país.

2 El parámetro text no se codificó para URL
?text=Hola & bienvenido
?text=Hola%20%26%20bienvenido

Solución: encodeURIComponent() o urllib.parse.quote().

3 Sin cuenta de WhatsApp activa

El chat falla en silencio.

4 Abierto en un navegador integrado

Use el navegador del sistema.

5 Una vista previa reescribió la URL

Se perdió la query string. Pruebe la URL sin procesar.

Construya sobre cuentas conectadas

API de enlaces de WhatsApp - FAQ

Respuestas rápidas para desarrolladores.

No. wa.me y api.whatsapp.com/send son URLs click-to-chat: abren un chat de WhatsApp, sin autenticación ni código. Las API de WhatsApp empiezan donde se detiene el enlace.

https://wa.me/<número>, donde <número> es el número completo en formato internacional, sin ceros iniciales, paréntesis, espacios ni guiones. Por ejemplo: https://wa.me/1XXXXXXXXXX.

Ambos abren la misma conversación. wa.me/<número> es la forma corta documentada en el Servicio de ayuda de WhatsApp, con el número en la ruta. api.whatsapp.com/send?phone=<número> es la forma larga, con el número como parámetro de consulta.

No. El enlace abre la conversación y puede prellenar el campo de texto. No se entrega nada hasta que la persona que tiene el teléfono pulsa enviar.

Sí. Añada ?text= y un mensaje codificado para URL, por ejemplo https://wa.me/1XXXXXXXXXX?text=Hola%2C%20tengo%20una%20pregunta. El texto sigue siendo editable antes del envío. Pruebe el generador de arriba.

Normalmente el número no está en formato internacional simple o el texto no se codificó para URL. Compruebe también que el número usa WhatsApp y evite los navegadores integrados en apps.

No. Un enlace wa.me o api.whatsapp.com/send no requiere cuenta Business ni acceso a la API. La Cloud API es un producto aparte, con verificación. Consulte la guía completa de la API de WhatsApp.

No con un enlace: no tiene estado. Use la Cloud API de Meta con una cuenta Business verificada, o Unipile, donde cada usuario final conecta su propia cuenta con código QR o código de vinculación y su app actúa en nombre del usuario autenticado. Consulte cómo enviar mensajes de WhatsApp por API.

¿Enlace o API? Nuestro equipo le ayuda a decidir.

Hable con un experto