# Responder mensajes de WhatsApp

> Conecta un número de WhatsApp Business y deja que tu asistente responda, dentro de las 24 horas que permite Meta.

Source: https://welcomeai.dev/es/docs/whatsapp-business
Category: Integraciones
Updated: 2026-09-17

---
## Qué hace

Conecta un número de WhatsApp Business. Alguien escribe a tu empresa por WhatsApp, tu asistente
responde desde la base de conocimiento que elijas, y toda la conversación aparece en la bandeja de
**Social media, WhatsApp**, con lo que esa persona te haya contado guardado como contacto.

Es una superficie aparte del widget de tu web, con sus propios ajustes. Es deliberado: un mensaje de
WhatsApp se lee en el móvil, entre otras cosas, y quien lo lee espera dos frases. Ajustar un mismo
asistente hasta que sirva para una página web y para una notificación del móvil empeora las dos.

## Quién firma la respuesta

Tu empresa. Cada mensaje sale de **tu propio número**, con el nombre que Meta aprobó para él. Nada de
este producto pone ese nombre, nada de lo que configures aquí lo cambia, y la palabra WelcomeAI no
aparece en ninguna parte de la conversación. Tu cliente ve el mismo remitente que vería si le hubiera
contestado una persona de tu equipo.

Ese nombre es el **nombre verificado** de tu cuenta de WhatsApp Business. Lo revisa Meta, tiene que
parecerse a tu negocio, y se cambia en Meta y no aquí. Si quieres que el asistente se presente con un
nombre propio -- "Mía, de Acme" -- escríbelo en sus instrucciones: es algo que el asistente dice, no el
nombre de la cuenta.

## La regla que lo condiciona todo

**Meta abre una ventana de 24 horas cada vez que alguien te escribe.** Dentro de ella tu asistente
responde con libertad, y cualquiera de tu equipo también. Cuando se cierra, WhatsApp deja de aceptar
cualquier cosa escrita a mano: del asistente **y** de una persona. Lo único que cruza una ventana
cerrada es una plantilla aprobada de antemano, y esta integración todavía no las envía.

Así que una ventana cerrada aquí es más dura que en Instagram, donde alguien de tu equipo aún puede
responder durante siete días. Cada conversación de la bandeja lleva una cuenta atrás, y cuando llega a
cero el cuadro de respuesta se sustituye por una línea que te dice que contestes desde el WhatsApp de
la propia empresa.

## El número que ya tienes

WhatsApp es el único canal que te entrega un dato de contacto con la primera palabra. Meta identifica a
la persona por su número de teléfono, así que:

- al asistente se le dice que ya tiene su número y **no lo pide**, que es lo que evita que le pregunte
  el teléfono a alguien que está escribiendo desde su teléfono;
- el número se guarda en el contacto la primera vez que se guarda cualquier otra cosa, de modo que una
  conversación que termina tras una respuesta deja igualmente a alguien a quien llamar.

Si la persona escribe otro número, eso es una corrección y gana.

Un matiz que conviene saber: en unos pocos países el identificador que usa WhatsApp no coincide con el
número que marcarías -- el `9` de los móviles en Argentina y el `1` en México son los casos
documentados. Guardamos lo que envía Meta y lo mostramos como teléfono, que es correcto casi siempre y
conviene comprobar cuando importa.

## Qué necesitas antes de empezar

- Un número en la **plataforma de WhatsApp Business**. No puede ser un número con sesión abierta en las
  apps de WhatsApp o WhatsApp Business, salvo que lo migres.
- Una cuenta de WhatsApp Business en Meta, con ese número añadido y su nombre aprobado.
- Una base de conocimiento con tu contenido. Eliges cuál al conectar.
- El plan Pro o superior.

## Conectarlo

Hoy esto es un formulario corto y no un botón, y la razón es de Meta: el flujo de un clic (Embedded
Signup) necesita que Meta revise nuestra app, y esa revisión está en marcha. Mientras tanto, una
empresa con acceso a su propia app de Meta puede conectarlo ya.

1. Abre **Social media, WhatsApp**.
2. Elige la base de conocimiento que responde ahí.
3. Pega el **token**. Está en tu app de Meta, en WhatsApp, API Setup. El token de usuario de sistema no
   caduca; el temporal de esa pantalla dura 24 horas y solo sirve para una prueba.
4. Pega el **id del número de teléfono**. Está en la misma pantalla, debajo del número.

   Este es el campo que hay que acertar. El id de la cuenta de WhatsApp Business está justo encima, los
   dos son cadenas largas de dígitos, y solo el id del número recibe mensajes. Leemos el número en Meta
   antes de guardar nada, así que un id equivocado se rechaza aquí en vez de dejarte una conexión que
   parece perfecta y no responde nunca.
5. Si el número está en **tu propia** app de Meta, pega también el secreto de esa app. Esa app firma
   cada entrega, y sin su secreto no podemos distinguir un mensaje real del de cualquier otro.
6. Apunta Meta al webhook. La dirección aparece en los ajustes en cuanto el número está conectado; en
   Meta se pone en el campo **messages**.

## Qué configurar

**Qué responde.** La base de conocimiento, el modelo y sus propias instrucciones. Se copian de la base
de conocimiento al conectar, así que empieza respondiendo exactamente como responde tu web, y cada
diferencia posterior es una que elegiste tú. Mejorar el prompt del widget no lo mejora aquí.

**Cómo se lee un mensaje.** El texto plano viene activado: WhatsApp tiene su propia sintaxis de
formato, que no es la que escribe el modelo, así que los símbolos se quitan en vez de mostrarse. Los
enlaces sobreviven y se pueden tocar, y el primero de un mensaje puede mostrar una vista previa, que es
lo único en lo que WhatsApp es más amable que un mensaje directo. Meta rechaza cualquier cosa de más de
4.096 caracteres; aquí el valor por defecto es menor, porque un muro de texto en un móvil no lo lee
nadie.

**El aviso de bot.** La política de Meta para experiencias automatizadas obliga a decir que se está
hablando con un bot. Enviamos tu frase una vez por conversación, antes de la primera respuesta.

**Pedir sus datos.** Elige el formulario, y la pantalla imprime las preguntas que hará de verdad, con
las obligatorias marcadas. El teléfono aparece como ya conocido.

**Quién se entera.** Elige un canal de Slack y se le avisa en cuanto alguien está esperando a una
persona, con lo que dijo, su número y cuándo se cierra la ventana. Se ofrecen todos los canales
públicos; a uno privado hay que invitar a la app. La lista se lee al cargar la página, así que pulsa
**Actualizar** al lado del campo si acabas de crear un canal o de invitar a la app a uno.

## Tomar el relevo de una conversación

Abre la conversación y desactiva el asistente para esa persona. Sus mensajes siguen llegando, el
asistente se calla y escribes tú. Vuelve a activarlo cuando termines. Hay dos interruptores y
significan cosas distintas: el de la conversación es para un cliente, el de Ajustes apaga el número
entero mientras reescribes algo.

## Lo que todavía no hace

- **Plantillas.** Llegar a alguien pasadas las 24 horas exige una plantilla aprobada por Meta de
  antemano, y cada una cuesta dinero por mensaje. No está hecho.
- **Botones y listas.** WhatsApp los muestra; esto envía texto.
- **Fotos, audios y documentos.** Llegan y quedan registrados en la conversación, y el asistente no los
  responde. Un mensaje sin palabras se deja en paz en vez de contestarlo con una disculpa por no poder
  verlo.
- **Más de un número por espacio de trabajo.** La pantalla muestra uno.

## Cambiar una credencial más adelante

La pantalla de ajustes tiene una tarjeta **Credenciales**. Pega ahí un token nuevo cuando caduque el
anterior, o corrige un id, y guarda: las conversaciones y los contactos no se tocan. Un campo vacío
significa "conserva lo que hay guardado", porque nunca devolvemos un token al navegador.

Al lado está **Probar conexión**, y es lo primero que hay que pulsar cuando algo va raro. Le hace dos
preguntas a Meta y te dice cuál ha fallado:

1. *¿El token está vivo, y es este el número que recibe los mensajes?*
2. *¿Meta nos va a entregar algo?*

La segunda es la que falla en silencio, y su fallo se ve exactamente igual que el éxito en todas las
demás pantallas.

## Cuando algo falla

**No llega nada.** Pulsa **Probar conexión** primero. Si dice que el token funciona pero que Meta no
nos enviará nada, la app no está suscrita a tu cuenta de WhatsApp Business: vuelve a guardar las
credenciales, que la suscribe, y comprueba que el id de la cuenta es correcto. Si la prueba sale
verde, comprueba que el webhook del campo `messages` en Meta apunta a la dirección de esa pantalla.

**No llega nada, y el id es la causa habitual.** Es el id del número, no el de la cuenta que aparece
encima en API Setup. Los dos son cadenas largas de dígitos y solo uno recibe mensajes.

**El asistente responde en la bandeja pero la persona no lo recibe.** Mira el error: si es `131030`, el
destinatario no está en la lista de autorizados de un número de **prueba**. Los números de prueba
gratuitos solo pueden escribir a números que hayas registrado y verificado. Un número real no tiene esa
lista.

**Un número de prueba y un móvil argentino no se llevan bien.** Meta nos dice que quien escribe es
`+54 9 11 ...` y solo acepta enviar a `+54 11 15 ...`: el mismo teléfono en dos convenciones
argentinas, y su lista de autorizados guarda la segunda. Nosotros enviamos al identificador que Meta
nos dio, que es el contrato documentado y lo que necesita un número real, así que el círculo no se
puede cerrar con un número de prueba. Haz la prueba con un destinatario de otro país, o con tu número
real.

**Llegan mensajes y no se responde nada.** Mira la pestaña de Ajustes: puede que el asistente esté
apagado para el número, o que alguien haya tomado el relevo de esa conversación. Las dos cosas se ven.

**Una respuesta falla con "more than 24 hours".** La ventana se cerró entre que llegó el mensaje y se
envió la respuesta. Ese es el reloj de Meta y no el nuestro, y la respuesta tiene que salir del
WhatsApp de la propia empresa.