> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maxagente.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conecta tu WhatsApp

> Conecta tu propio número de WhatsApp a Max a través de Meta, paso a paso, y qué hacer si algo sale mal

Para que tu agente atienda por WhatsApp, conectas tu número en Meta y lo
traes a Max como un [canal](https://docs.maxagente.com/guias/canales.md). Lleva unos 10 minutos y se hace
una sola vez.

<video controls preload="metadata" poster="/videos/conectar-whatsapp/compu.jpg">
  <source src="https://mintcdn.com/max-agente/ahy2IBNO76UXFr12/videos/conectar-whatsapp/compu.mp4?fit=max&auto=format&n=ahy2IBNO76UXFr12&q=85&s=1fa40e282d091fe79a9a2e99020452a9" type="video/mp4" />
</video>

> [!TIP]
>
> ¿No tienes un número para usar? En **Nuevo canal → Comprar un número
> nuevo**, Max te asigna uno listo para WhatsApp. Más detalle en
> [Canales](https://docs.maxagente.com/guias/canales.md#sumar-un-canal).

## Antes de empezar

Revisa estas cuatro cosas. La mayoría de los problemas de conexión vienen de
alguna de ellas.

> [accordion] Una cuenta de Facebook con acceso de administrador
>
> La conexión se autoriza con tu cuenta personal de Facebook. Si tu empresa
> ya tiene un portfolio en Meta Business, esa cuenta tiene que ser
> **administradora** del portfolio. Si no tienes portfolio, lo creas
> durante la conexión.

> [accordion] Un número que reciba SMS o llamadas
>
> Meta manda un código a ese número para verificarlo. Puede ser un celular o
> un fijo (el fijo recibe el código por llamada). Ten el teléfono a mano.

> [accordion] Que el número no esté en uso en WhatsApp
>
> Si el número está registrado en la app de **WhatsApp** o **WhatsApp
> Business** de un teléfono, o en otra plataforma, Meta no lo deja conectar.
> En [Si algo sale mal](#en-meta), **El número ya está en WhatsApp** te
> dice qué hacer en cada caso.

> [accordion] La verificación en dos pasos desactivada, si migras el número
>
> Solo si el número ya funciona con la API de WhatsApp en otra plataforma.
> Desactívala ahí antes de empezar, o ten el
> [PIN](https://docs.maxagente.com/guias/whatsapp/verificacion-en-dos-pasos.md) a mano.

## Paso a paso

**1. Abre Conectar mi número**

En **Canales**, toca **Nuevo canal → Conectar mi número**. También llegas
desde el Inbox, en el paso **Conecta un canal**.

**2. Toca Continuar con Meta**

Max te muestra lo que tienes que tener a mano. Toca **Continuar con
Meta**: se abre Meta en la misma pestaña. Si no tienes la sesión de
Facebook abierta, primero te pide iniciar sesión.

**3. En Meta, toca Continuar**

La primera pantalla explica qué compartes con Zernio, el servicio que usa
Max para conectarse con WhatsApp.

**4. Pon tu número**

Elige el país de tu número (puedes escribirlo en el buscador) y escribe el
número sin el código de país, que ya lo pone Meta, y sin los prefijos
que se marcan solo dentro del país:

* **Argentina**: sin el 0 ni el 15. Para el 0351 15 123-4567 escribes
  351 123 4567.
* **México**: los 10 dígitos, sin el 1 de antes. Por ejemplo,
  55 1234 5678.
* **Otros países**: sin el 0 inicial del código de área, si lo tiene.

Elige cómo recibir el código: **Mensaje de texto** o **Llamada
telefónica**, y toca **Siguiente**.

**5. Escribe el código**

Llega en uno o dos minutos. Escríbelo y toca **Siguiente**.

> [!WARNING]
>
> No pidas el código varias veces seguidas: Meta bloquea el número por
> horas. Si no llega, mira [Si algo sale mal](#en-meta).

**6. Elige tu portfolio y crea la cuenta de WhatsApp**

En **Porfolio empresarial** elige el de tu empresa (o crea uno). En
**Cuenta de WhatsApp**, elige **Crear cuenta de WhatsApp**. Si ya tienes
una cuenta de WhatsApp Business en ese portfolio, puedes elegirla.
Toca **Siguiente**.

**7. Completa la información de la empresa**

Elige la **categoría** de tu negocio (es obligatoria) y toca
**Siguiente**. Meta tarda alrededor de un minuto en crear la cuenta.

**8. Pon el nombre que van a ver tus clientes**

Es el **nombre visible** de tu número en WhatsApp. Tiene que ser el de tu
negocio: mira [reglas del nombre visible](#el-nombre-visible).

**9. Revisa los permisos y toca Confirmar**

No desmarques ningún permiso: Max los necesita para recibir y responder
mensajes.

**10. Toca Finalizar**

Meta termina de conectar y te muestra **Añadir método de pago**. Puedes
hacerlo ahora o después: mira [Método de pago](#método-de-pago).

**11. De vuelta en Max**

Max muestra **Conectando WhatsApp** mientras Meta confirma. Puede tardar
un par de minutos: deja la pantalla abierta.

* Si tu cuenta de Meta tiene **varios números**, Max te pide **Elige el
  número de WhatsApp**: toca **Conectar** en el que acabas de conectar.
* Si el número tiene **verificación en dos pasos**, Max te pide el PIN
  de 6 dígitos. Mira [PIN de verificación en dos
  pasos](https://docs.maxagente.com/guias/whatsapp/verificacion-en-dos-pasos.md).

Cuando termina, ves **WhatsApp conectado** y el canal en la lista.

**12. Elige qué agente atiende**

Abre el canal y, en **Agente asignado**, elige tu agente. Tiene que tener
una versión [publicada](https://docs.maxagente.com/guias/publicar-versiones.md).

**13. Pruébalo**

Escríbele al número desde **otro** teléfono. La respuesta del agente
aparece en tu WhatsApp y en el [Inbox](https://docs.maxagente.com/guias/inbox.md).

## Después de conectar

### Método de pago

Meta cobra los mensajes de WhatsApp a la cuenta de WhatsApp Business, no a tu
plan de Max. Sin método de pago:

* El agente **responde** a quien le escribe, dentro de las 24 horas.
* El canal **no puede iniciar conversaciones**: ni plantillas ni
  seguimientos. En el detalle del canal ves **No puede iniciar
  conversaciones** con el enlace **Abrir la facturación de WhatsApp**.

<video controls preload="metadata" poster="/videos/metodo-de-pago/compu.jpg">
  <source src="https://mintcdn.com/max-agente/r9-5y9cx2QD9vUhz/videos/metodo-de-pago/compu.mp4?fit=max&auto=format&n=r9-5y9cx2QD9vUhz&q=85&s=e1e389d27296867aaee26d7daa0cb620" type="video/mp4" />
</video>

Desde el detalle del canal, toca **Abrir la facturación de WhatsApp**. Si tienes
varios negocios en Meta, elige el tuyo. En **Cuentas de mensajes**, con tu
cuenta abierta, toca **Configuración de pagos** y agrega la tarjeta. Más
detalle sobre los costos en [Canales](https://docs.maxagente.com/guias/canales.md#plantillas-de-mensaje).

### El nombre visible

Tiene que ser el nombre de tu negocio. Meta lo rechaza si:

* no se relaciona con tu marca (si no es obvio, usa «Producto by Empresa»),
* está todo en mayúsculas, o tiene emojis, signos o forma de dirección web,
* es solo una palabra genérica o un lugar, o agrega cosas como «Cuenta
  oficial».

Meta revisa el nombre en 1 a 3 días hábiles. Mientras tanto, tus clientes ven
tu número sin nombre, y el límite de conversaciones nuevas por día es más
bajo. Si lo rechaza, Max te muestra el motivo y puedes pedir otro desde
**Editar perfil**.

### La verificación de la empresa

Puedes conectar sin verificar tu empresa en Meta, pero con límites: por
ejemplo, Meta permite **dos números** por empresa hasta verificarla. Se
inicia desde **Iniciar la verificación de empresa**, en el detalle del canal.

## Si algo sale mal

Meta muestra sus pantallas en el idioma de tu Facebook: los mensajes pueden
verse en español o en inglés.

### En Meta

> [accordion] El código no llega
>
> * Espera un par de minutos: a veces tarda.
> * Si es un fijo o un número virtual, elige **Llamada telefónica**: el SMS
>   no llega a esos números. Desactiva el desvío de llamadas y cualquier
>   contestador automático, y atiende la llamada.
> * Revisa que el número reciba SMS del exterior.
>
> No toques **Volver a enviar** muchas veces: cada pedido suma, y Meta
> bloquea el número por horas.

> [accordion] «Has solicitado el código demasiadas veces»
>
> Meta frenó los códigos para ese número (en inglés, *You have requested
> your code too many times*). No hay forma de destrabarlo antes: espera al
> menos 12 horas, y hasta 72 si se repitió, y vuelve a intentar **una sola
> vez**. Mientras tanto, no pidas más códigos. Si escribiste mal el código
> varias veces, el bloqueo es parecido (*You have guessed too many times*):
> espera unas 12 horas.

> [accordion] El número ya está en WhatsApp
>
> Meta te avisa que el número está registrado en una cuenta de WhatsApp
> (*This number is registered to an existing WhatsApp account*). Depende de
> dónde esté:
>
> * **En la app de WhatsApp Business**: puedes conectarlo sin dejar de
>   usar la app. Meta te guía para seguir desde el teléfono; después Max te
>   pide [terminar en la app](#al-volver-a-max).
>
> * **En la app de WhatsApp común**: tienes que eliminar esa cuenta en el
>   teléfono (**Ajustes → Cuenta → Eliminar mi cuenta**), esperar unos
>   minutos y volver a empezar. Se pierden los chats de esa cuenta.
>
> * **En otra plataforma o proveedor de WhatsApp**: desactiva ahí la
>   [verificación en dos pasos](https://docs.maxagente.com/guias/whatsapp/verificacion-en-dos-pasos.md)
>   o pídesela a ese proveedor, y vuelve a empezar.
>
> > [!WARNING]
> >
> > Un número que pasa a la API de WhatsApp ya no se puede usar en la app
> > común de WhatsApp.

> [accordion] Meta no se abre, se queda en blanco o no avanza
>
> * Usa Chrome o Edge en una computadora.
> * Desactiva el bloqueador de ventanas emergentes y los bloqueadores de
>   anuncios para Facebook.
> * Haz todo en el mismo navegador y no cierres la pestaña de Max.
> * Si ves *Something has gone wrong* o *You're going too fast*, espera unos
>   minutos y vuelve a empezar desde **Conectar mi número**.

> [accordion] No aparece mi portfolio o no me deja crear la cuenta
>
> * Tu cuenta de Facebook tiene que ser **administradora** del portfolio
>   (*User does not have permission to create WhatsApp Business Accounts*).
>   Pide ese rol a quien lo administra en Meta Business, o elige un
>   portfolio donde lo seas.
> * Cada persona puede crear hasta dos portfolios. Si llegaste al tope,
>   usa uno que ya tengas.
> * Si Meta dice que solo puedes crear un número limitado de cuentas de
>   WhatsApp hasta verificar la empresa, elige una cuenta de WhatsApp que ya
>   exista en el portfolio, o
>   [verifica la empresa](https://business.facebook.com/settings/security).

> [accordion] Meta dice que mi cuenta de Facebook es muy nueva o está restringida
>
> * *Your Facebook account is too new*: espera unas horas y vuelve a
>   intentar.
> * Si te pide activar la verificación en dos pasos de Facebook, actívala
>   en **Centro de cuentas → Contraseña y seguridad**.
> * Si tu cuenta tiene restricciones de Meta, conecta con otra cuenta de
>   Facebook que administre el mismo portfolio.

> [accordion] Meta rechaza el nombre visible
>
> Revisa las [reglas del nombre visible](#el-nombre-visible). El rechazo no
> frena la conexión: el canal se conecta igual y pides otro
> nombre después, desde **Editar perfil** en el detalle del canal.

> [accordion] Cerré Meta o toqué Cancelar
>
> Max muestra **No pudimos conectar WhatsApp** con **Cancelaste o se denegó
> el acceso desde Meta.** No se pierde nada: toca **Volver a canales** y,
> en el canal **Esperando conexión**, toca **Reintentar**. Si ya recibiste
> un código, puedes volver a pedirlo, una sola vez.
>
> En la pantalla de permisos, no desmarques ninguno: sin ellos, la conexión
> también termina cancelada.

### Al volver a Max

> [accordion] «Meta todavía está confirmando el canal»
>
> Es normal. Deja la pantalla abierta: Max sigue consultando a Meta. Si
> pasan unos 3 minutos, aparece **La conexión está tardando demasiado.
> Vuelve a intentarlo.** Toca **Volver a canales** y, en el canal, toca
> **Reintentar**.

> [accordion] «Ese número ya está conectado a otro canal»
>
> Un número solo puede estar en un canal a la vez. Búscalo en
> [Canales](https://docs.maxagente.com/guias/canales.md): si ya está ahí, no hace falta conectarlo de
> nuevo. Si lo quieres en este canal, desconéctalo o elimínalo del otro y
> vuelve a intentar.

> [accordion] Me pide elegir el número de WhatsApp
>
> Pasa cuando tu cuenta de Meta tiene varios números. En **Elige el número
> de WhatsApp**, toca **Conectar** en el número que acabas de conectar.
>
> <video controls preload="metadata" poster="/videos/elegir-numero/compu.jpg">
>   <source src="https://mintcdn.com/max-agente/r9-5y9cx2QD9vUhz/videos/elegir-numero/compu.mp4?fit=max&auto=format&n=r9-5y9cx2QD9vUhz&q=85&s=2a413883532136a3027dd84e5fdad6c3" type="video/mp4" />
> </video>
>
> Si ves **Meta no devolvió números disponibles para esta cuenta**, la
> conexión en Meta no terminó: vuelve a empezar y llega hasta **Finalizar**.

> [accordion] «Falta el PIN de verificación en dos pasos»
>
> El número ya tenía un PIN de 6 dígitos. Escríbelo y toca **Registrar**.
> Si no lo recuerdas, cámbialo en WhatsApp Manager desde el enlace **¿No lo
> recuerdas?**. Todo el detalle, incluidos **Demasiados intentos de PIN** y
> **Registro bloqueado por Meta por 72 horas**, en [PIN de verificación en
> dos pasos](https://docs.maxagente.com/guias/whatsapp/verificacion-en-dos-pasos.md).
>
> Con **Hacerlo después** vuelves a Canales, pero el número no envía ni
> recibe mensajes hasta registrarlo desde el detalle del canal.

> [accordion] «Falta terminar la conexión en la app de WhatsApp Business»
>
> El número también se usa en la app de WhatsApp Business, así que el
> registro se termina en el teléfono: abre WhatsApp Business, busca el
> mensaje de Facebook Business y toca **Conectar a la plataforma de
> empresas**.
>
> Para usar el número en la app y en Max a la vez, la app tiene que estar
> actualizada y tienes que abrirla al menos una vez cada 14 días.

> [accordion] «Tope de números registrados en Meta»
>
> Meta permite dos números por empresa hasta que pasa la verificación. Tienes
> dos caminos: [verificar la empresa](https://business.facebook.com/settings/security),
> que sube el tope a veinte, o liberar otro número de la misma empresa. Después
> toca **Reintentar**.

> [accordion] «El número está en uso en otra cuenta de WhatsApp»
>
> El número está registrado en otra cuenta de WhatsApp Business. Libéralo
> de esa cuenta (o pídeselo a quien la administra) y toca **Reintentar**.

> [accordion] «No pudimos iniciar la conexión» o «No pudimos completar la conexión»
>
> Espera un momento y vuelve a intentar desde el canal con **Reintentar**.
> Si se repite, escríbenos con la hora y el mensaje que viste.

### Con el canal ya conectado

> [accordion] «No puede iniciar conversaciones»
>
> Casi siempre falta el [método de pago](#método-de-pago) en Meta: toca
> **Abrir la facturación de WhatsApp** en el detalle del canal. Puede
> aparecer también mientras Meta revisa el nombre visible o si la empresa
> no está verificada; el detalle del canal dice cuál es la causa. Las
> respuestas dentro de las 24 horas siguen funcionando.

> [accordion] El agente no responde
>
> * Revisa que el canal tenga un **Agente asignado** y que ese agente tenga
>   una versión [publicada](https://docs.maxagente.com/guias/publicar-versiones.md).
> * Prueba desde un teléfono que no sea el del número conectado.
> * Toca **Probar conexión** en el detalle del canal.
> * Si el canal dice **Sin registrar en la API de WhatsApp**, termina el
>   registro desde ahí.

> [accordion] «Sin conexión con Meta», «Restringido por Meta» u otro aviso
>
> El estado del canal muestra lo que informa Meta. **Sin conexión con Meta**
> se resuelve conectando el canal de nuevo. **Marcado**, **Limitado**,
> **Restringido** o **Bloqueado por Meta** vienen de la calidad o de las
> políticas de WhatsApp: revisa el aviso en WhatsApp Manager. Más detalle en
> [El estado de tu número](https://docs.maxagente.com/guias/canales.md#el-estado-de-tu-número).

## Sigue con

> [card] [Canales](https://docs.maxagente.com/guias/canales.md)
>
> El estado de tu número, plantillas y cómo desconectarlo.

> [card] [Inbox](https://docs.maxagente.com/guias/inbox.md)
>
> Dónde llegan las conversaciones de WhatsApp.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.