LinkedIn
Instagram
Telegrama
Gmail
Outlook
Calendario de Google
Únase a la comunidad Slack Índice
El Enlace
Construir un enlace
Más allá del enlace
Enlaces de WhatsApp Click-to-Chat
API de Enlace de WhatsApp: Cómo wa.me y api.whatsapp.com Los enlaces realmente funcionan
Un enlace de WhatsApp es una URL, no una API. Esta guía te da exactamente wa.me y api.whatsapp.com/send formatos, el text parámetro, un generador gratuito y el punto donde el enlace se detiene y debe comenzar una integración real.
Prueba gratuita de 7 días, sin necesidad de tarjeta de crédito
Solo una URL
Sin autenticación, sin código
¡Hola! Tengo una pregunta sobre su producto.
Abre el chat. Un humano todavía tiene que presionar enviar.
Definición
¿Qué es una API de enlaces de WhatsApp?
No hay ninguna API de enlaces de WhatsApp.
https://wa.me/<number> y https://api.whatsapp.com/send?phone=<number> son URL de clic para chatear: al hacer clic en una se abre una conversación en WhatsApp. Requieren sin autenticación, sin cuenta de desarrollador y sin código. Las API de WhatsApp son una capa separada y comienzan exactamente donde termina el enlace.Criterio
Un enlace de WhatsApp
Una API de WhatsApp
Formato
EnlaceUna URL que puedes pegar en cualquier lugar
APIUn punto final HTTP autenticado
Configurar
EnlaceNinguno. Funciona al instante
APIVinculación de cuentas, una clave API, una biblioteca cliente
Qué sucede al hacer clic / llamar
EnlaceAbre un chat y puede rellenar previamente un campo de texto
APIEnvía, recibe y lista mensajes mediante programación
Quién actúa
EnlaceUn humano presiona enviar
APISu software actúa en nombre de la cuenta vinculada
Formato
¿Cuál es el formato exacto del enlace de wa.me?
El formato documentado es
https://wa.me/<number>, dónde <number> es un número de teléfono completo en formato internacional. El Centro de ayuda de WhatsApp indica que debes omitir cualquier cero, paréntesis o guion.Uso: https://wa.me/1XXXXXXXXXX
No uses: https://wa.me/+001-(XXX)XXXXXXX Qué conservar
Código de país más número de abonado, solo dígitos. Sin prefijo
+. Qué quitar
Ceros iniciales, espacios, guiones, paréntesis. Ninguno de ellos pertenece a la ruta.
Comparación
¿Cuál es la diferencia entre wa.me y api.whatsapp.com/send?
Ambos abren la misma conversación.
wa.me/ está la forma corta documentada en el Centro de Ayuda de WhatsApp, con el número en la ruta. api.whatsapp.com/send?phone= es el formato largo, que todavía se usa ampliamente, el cual lleva el número como parámetro de consulta.Anatomía de una URL, segmento por segmento
https://wa.me/1XXXXXXXXXXHola
https://api.whatsapp.com/enviar?phone=1XXXXXXXXXXHola
Anfitrión
Ruta fija
El número
El mensaje
Criterio
wa.me
api.whatsapp.com/send
Donde vive el número
wa.meEn la ruta de la URL
api.whatsapp.comEn el
teléfono parámetro de consultaDocumentado en el Centro de ayuda de WhatsApp
wa.meSí, este formato exacto
api.whatsapp.comNo pudimos encontrarlo en la página de ayuda actual
Comportamiento observado
wa.meAbre el chat
api.whatsapp.comAbre el mismo chat
Una laguna en la documentación, no una obsolescencia. No pudimos encontrar una página actual y oficial de WhatsApp o Meta que documente
api.whatsapp.com/send. Eso no significa que haya dejado de funcionar: ambos formatos redirigen a la misma conversación hoy en día. Significa que el propio Centro de Ayuda de WhatsApp solo cubre wa.me. Construye nuevos enlaces en el formato documentado.El parámetro de texto
¿Cómo se añade un mensaje prellenado a un enlace de WhatsApp?
Adjuntar
?text= seguido del mensaje codificado en URL: https://wa.me/<number>?text=<urlencodedtext>. El texto aparece en el campo de entrada del chat, precargado y editable.https://wa.me/1XXXXXXXXXX?text=Estoyinteresadoentucochequeestásvendiendo// sin número: abre un selector de contactos en su lugarhttps://wa.me/?text=I'minquiringabouttheapartmentlisting Sin un número, WhatsApp abre la lista de contactos del remitente en lugar de un chat específico. El
La codificación, los determinados mapeos text sigue autocompletándose una vez que se selecciona un contacto. Personaje
Espacio
Nueva línea
&
#
Codificado como
%20
%0A
%26
%23
También vale la pena saber:
Construye el enlace en el código + codifica a %2B. Para todo lo demás, emojis incluidos, no construyas la tabla tú mismo: llama encodeURIComponent() en JavaScript o urllib.parse.quote() en Python. // JavaScriptconst number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}?text=${encodeURIComponent(text)}`;# Pythonfrom urllib.parse import quote
number, text = "1XXXXXXXXXX", "¡Hola! Tengo una pregunta."
link = f"https://wa.me/{number}?text={quote(text)}"Herramienta gratuita
Genera tu enlace de WhatsApp
Ingrese un número y un mensaje. Obtenga el wa.me el enlace api.whatsapp.com equivalente, el texto codificado, un fragmento HTML y el botón oficial, todo a la vez.
Funciona completamente en tu navegador. Ningún número es enviado jamás a ningún servidor.
Número internacional completo. Sin +, sin 0, sin espacios ni guiones.
Opcional. Se inserta en el campo de entrada del chat, aún editable por el remitente.
enlace de wa.me
https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product.
equivalente a api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Hi!%20I%20have%20a%20question%20about%20your%20product.
parámetro de texto, codificado
¡Hola! Tengo una pregunta sobre vuestro producto.
fragmento HTML, listo para pegar
<a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener" aria-label="Chatear en WhatsApp">Chatear en WhatsApp</a>
Botón oficial "Chatear en WhatsApp"
Chatear en WhatsApp <a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chatear en WhatsApp</a>
Este enlace abre un chat. No envía el mensaje y su producto no verá la respuesta.
¿Un enlace de WhatsApp envía el mensaje?
No. Un enlace de clic para chatear abre la conversación y prellenar el campo de texto. No se entrega nada hasta que la persona que tiene el teléfono presiona enviar.
La parte honesta
¿Qué no puede hacer un enlace de WhatsApp?
Un enlace de clic para chatear no tiene estado. Su producto nunca se entera de si se hizo clic en el enlace, si se envió el mensaje o si el destinatario respondió.
Donde el enlace se detiene
Enlace clicueado
El chat se abre
Mensaje prellenado
Envío manual
Enlaceparadasaquí
Respuesta recibida
Historial de la conversación
Evento de webhook
Atribución por usuario
Sin confirmación de entrega ni de lectura
Ninguna respuesta dirigida a su aplicación
Sin historial de conversación
Sin archivos adjuntos
Sin activador en el servidor. Se necesita a un humano y un clic
Sin atribución por usuario en un producto multiusuario
Fallo silencioso si el número no tiene una cuenta de WhatsApp activa
Comportamiento diferente en ordenador, WhatsApp Web y móvil
Sin creación ni gestión de grupos. Un enlace solo abre un chat individual, ver el API de grupos de WhatsApp límites para cualquier cosa relacionada con grupos
Un enlace no puede registrar clics, respuestas o historial. Una API sí puede. Construir una integración real de WhatsApp
Pega el enlace
¿Cómo se recibe la respuesta de vuelta en tu aplicación?
Necesitas una API que mantenga una sesión de WhatsApp. Existen dos rutas: API en la nube de Meta, que requiere una cuenta comercial verificada, o un API de cuenta conectada como Unipile, donde el usuario final vincula su propia cuenta de WhatsApp en nombre del usuario autenticado, mediante código QR o código de emparejamiento.
API de Meta CloudEmpresa verificada
Requiere una cuenta de WhatsApp Business verificada
Facturado por mensaje desde el 1 de julio de 2025, consulte el Precios de la API de WhatsApp Business desglose
La ventana de servicio al cliente de 24 horas todavía existe, determina lo que es gratis, no lo que se cobra
Diseñado para notificaciones con plantillas a escala
Cuenta conectada, UnipileSin verificación
Cada usuario final vincula su propia cuenta de WhatsApp, en nombre del usuario autenticado
Por código QR o código de emparejamiento, sin verificación de Meta Business
Lee y envía desde el buzón vinculado actual, respuestas incluidas
Mismo patrón de conexión, envío, listado y escucha que LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP
// 1. Vincular la cuenta, en nombre del usuario autenticado
const { qrCodeString } = await cuenta.cliente.conectarWhatsapp();// 2. Enviar un mensaje una vez vinculado
POST /api/v1/chats/{chat_id}/messages{ "texto": "¡Hola! Su pedido ha sido enviado." }// 3. Recibir respuestas a través de un webhook, sin sondeo{ "evento": "mensaje_recibido", "chat_id": "chat_182...", "mensaje": "¿Sigue disponible esto?"}Para ver la guía de envío completa, los payloads y el manejo de webhooks, consulte cómo enviar mensajes de WhatsApp a través de la API. Referencia del endpoint: developer.unipile.com/docs/whatsapp.
Decisión
Enlace, Cloud API o cuenta conectada: ¿cuál necesitas?
Utiliza un enlace cuando un humano inicie la conversación desde una página que tú controlas. Utiliza la API de Cloud cuando un negocio verificado envíe notificaciones con plantilla a gran escala. Utiliza una API de cuenta conectada cuando tu producto deba leer y enviar desde la propia bandeja de entrada de WhatsApp del usuario.
Criterio
Enlace
API de Meta Cloud
Cuenta conectada
Quién inicia
Enlaceun humano, desde una página que controlas
API en la nubeSu empresa envía primero, con plantilla
Cuenta conectadaCualquiera de los dos lados, desde la bandeja de entrada vinculada
Autenticación obligatoria
EnlaceNinguno
API en la nubeCuenta de Meta Business verificada
Cuenta conectadaCódigo QR o código de emparejamiento, sin verificación comercial
Coste
EnlaceGratis
API en la nubePor mensaje, desde el 1 de julio de 2025
Cuenta conectadaPrecios del plan de Unipile, no se cobra por mensaje
Recibe respuestas
EnlaceNo
API en la nubeSí, a través de webhook
Cuenta conectadaSí, a través de webhook
Historial de la conversación
EnlaceNo
API en la nubeSí
Cuenta conectadaSí
Productos multiinquilino
EnlaceSaltos de página, un número fijo
API en la nubeNecesita enrutamiento personalizado por número de negocio
Cuenta conectadaNativo, una cuenta vinculada por usuario final
Tiempo de preparación
EnlaceActas
API en la nubeDe días a semanas, Verificación de empresas
Cuenta conectadaMinutos a horas
Solo necesito un enlace
Utilice la generador superior. Sin cuenta, sin configuración.
Envío de notificaciones basadas en plantillas
Ver el Integración de la API de WhatsApp Cloud guía.
Leyendo y enviando por usuario
Empieza con la Guía completa de la API de WhatsApp.
La mayoría de los productos superan el límite en una semana. Empieza por donde realmente vas a acabar. Empezar a construir
Implementación
¿Cómo se integra un enlace de WhatsApp en un producto?
Genera el enlace del lado del servidor, para cada usuario, y nunca incluyas un número de teléfono de forma fija en un producto multitenant. El enlace es solo un enlace de anclaje, por lo que debe estar en la capa de plantillas, no en la capa de la API.
<a href="https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}"
objetivo="_blank" relacionado="noopener"
etiqueta aria="Chatear por WhatsApp"Chatear en WhatsAppa>Botón oficial
WhatsApp publica un distintivo "Chatear en WhatsApp" ya hecho, de color verde y blanco, en unos pocos tamaños fijos, diseñado para ser utilizado sin modificaciones.
Chatear en WhatsApp Código QR
Cualquier generador de códigos QR que acepte una URL convierte un
wa.me convertirlo en un código escaneable para su impresión, para el embalaje o para la señalización presencial. Móvil Abre directamente la aplicación de WhatsApp, con el chat y el texto ya rellenado.
Ordenador de sobremesa, aplicación instalada Abre la aplicación de WhatsApp para ordenador en lugar del navegador.
Ordenador de sobremesa, sin aplicación Abre WhatsApp Web en el navegador y solicita un inicio de sesión con código QR si la sesión no está activa todavía.
Por qué se rompen los enlaces en productos multiinquilino: Un único número fijado de forma rígida no permite diferenciar a tus clientes. Genera el enlace a partir del registro específico del usuario o del espacio de trabajo en cada ocasión, de modo que incluya el número que ese usuario tenga realmente, y no un número pegado una sola vez en una plantilla.
Solución de problemas
¿Por qué no funciona mi enlace de WhatsApp?
Las dos causas más comunes son un número de teléfono que no está en formato internacional plano y un
text parámetro que no estaba codificado en formato URL.CausaEl número de teléfono no está en formato internacional estándar
ArreglaIntroduce el número internacional completo, solo dígitos: sin
+, sin espacio inicial 0, sin espacios, guiones o corchetes.CausaEl parámetro de texto no estaba codificado para URL
ArreglaPasa el mensaje por
encodeURIComponent() en JavaScript o urllib.parse.quote() en Python antes de añadirlo.CausaEl número no tiene una cuenta de WhatsApp activa
ArreglaEl enlace sigue abriéndose, pero el chat falla sin mostrar ningún mensaje de error. Comprueba primero que el número esté realmente registrado en WhatsApp.
CausaSe abre en el navegador integrado de una aplicación de terceros
ArreglaLos navegadores integrados en aplicaciones de redes sociales o plataformas de anuncios a veces bloquean o gestionan mal la redirección. Abra el enlace en el navegador del sistema en su lugar.
CausaUn rastreador de vista previa de enlaces ha reescrito la URL
ArreglaAlgunas plataformas envuelven los enlaces salientes en su propia redirección, lo que puede hacer que se elimine la cadena de consulta. Prueba el enlace sin formato
wa.me URL directamente.API de enlaces de WhatsApp - Preguntas frecuentes
Todo lo que los desarrolladores preguntan sobre wa.me, api.whatsapp.com, el parámetro text y dónde se detiene el enlace.
No existe una única API de enlaces de WhatsApp. wa.me y api.whatsapp.com/send son URLs de clic para chatear: abrir una inicia una conversación en WhatsApp, sin necesidad de autenticación, cuenta de desarrollador ni código. Las propias API de WhatsApp son una capa separada que comienza exactamente donde termina el enlace, una vez que una persona tiene que responder.
El formato documentado es https://wa.me/<number>, dónde <number> es el número de teléfono completo en formato internacional. El Centro de Ayuda de WhatsApp indica omitir cualquier cero al principio, paréntesis, espacios o guiones, por ejemplo https://wa.me/1XXXXXXXXXX.
Ambos abren la misma conversación. wa.me/ está la forma corta documentada en el Centro de ayuda de WhatsApp, con el número en la ruta de la URL. api.whatsapp.com/send?phone= es la forma larga, que todavía se usa ampliamente, que lleva el número como un parámetro de consulta en su lugar.
No. Un enlace de clic para chatear abre la conversación y puede rellenar previamente el campo de texto, pero no se envía nada hasta que la persona que tiene el teléfono presiona enviar.
Sí. Adjuntar ?text= seguido de un mensaje codificado en URL, por ejemplo https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. El texto aparece en el campo de entrada del chat, precargado y aún editable antes de enviarlo. Pruébalo en el generador superior.
Las dos causas más comunes son un número de teléfono que no está en formato internacional plano y un text parámetro que no estaba codificado para URL. Comprueba también que el número tenga una cuenta de WhatsApp activa y que el enlace no se haya abierto dentro del navegador integrado de una aplicación de terceros.
No. A wa.me o api.whatsapp.com/send el enlace no requiere ninguna cuenta de Empresa, ni verificación, ni acceso a la API. La plataforma de WhatsApp Business, o Cloud API, es un producto verificado independiente para empresas que necesitan enviar notificaciones con plantillas a gran escala o recibir respuestas mediante programación. Véase el Guía completa de la API de WhatsApp.
Un enlace por sí solo no puede enviar respuestas a tu aplicación, ya que carece de estado. Para leer y enviar mensajes desde una bandeja de entrada real, necesitas una API que mantenga una sesión de WhatsApp: ya sea la API en la nube de Meta con una cuenta Business verificada, o una API de cuentas conectadas como Unipile, en la que cada usuario final vincula su propia cuenta de WhatsApp en nombre del usuario autenticado, mediante un código QR o un código de emparejamiento. Consulta cómo enviar mensajes de WhatsApp a través de la API.
¿Todavía no estás seguro de si necesitas un enlace o una API? Nuestro equipo puede ayudarte a decirte.
ES 
EN 
FR 
DE 
IT 
BR 
NL 
PL 
TR