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

# WhatsApp

> Conecta un número de WhatsApp Business a Jelou y atiende las conversaciones desde un proyecto de Brain o desde la bandeja de entrada.

<iframe width="100%" style={{ aspectRatio: "16/9" }} src="https://www.youtube.com/embed/QtBZwL5O_BE" title="Configuración avanzada del canal de WhatsApp" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## Introducción

El canal de WhatsApp conecta un número de WhatsApp Business con Jelou para que las conversaciones lleguen a la plataforma. El canal puede quedar conectado de dos formas:

* A un **proyecto** de Brain, donde responde un workflow.
* A la **bandeja de entrada**, donde responden los operadores.

## Requisitos previos

Antes de conectar el canal de WhatsApp, asegúrate de tener:

* Una cuenta activa en Jelou.
* Un **portafolio comercial** en Meta activo y de preferencia verificado.
* Un número de teléfono disponible, **sin cuenta de WhatsApp** asociada.

<Note>
  Las cuentas **self-service** conectan su número iniciando sesión directamente con Facebook. No se requiere configuración técnica adicional ni intervención del equipo de Jelou.
</Note>

## ¿Desde dónde puedes conectar WhatsApp?

<Tabs>
  <Tab title="Desde Brain Studio">
    Mientras trabajas en un proyecto en Brain Studio, puedes conectar un canal desde dos lugares:

    * **Botón Publicar**: haz clic en **Publicar** y luego en **Conecta tu canal** en la parte inferior del panel.

          <Frame>
            <img src="https://mintcdn.com/jelouai/MHu65ZRR95A8Yhww/assets/images/channels/whatsapp-publish-es.png?fit=max&auto=format&n=MHu65ZRR95A8Yhww&q=85&s=89273d0785d289b74249846db3778044" alt="Publicar y Conecta tu canal en Brain Studio" width="2704" height="1294" data-path="assets/images/channels/whatsapp-publish-es.png" />
          </Frame>

    * **Administrar canales**: haz clic en la opción **Administrar canales** en el menú de la esquina superior derecha del canvas.

          <Frame>
            <img src="https://mintcdn.com/jelouai/MHu65ZRR95A8Yhww/assets/images/channels/whatsapp-admin-channels-es.png?fit=max&auto=format&n=MHu65ZRR95A8Yhww&q=85&s=5049e501af2b97d631c3bb7564d599b6" alt="Menú Administrar canales en Brain Studio" width="2704" height="1288" data-path="assets/images/channels/whatsapp-admin-channels-es.png" />
          </Frame>

    Cuando conectas desde el canvas, el proyecto ya viene definido: el formulario no pide seleccionarlo y el nombre del canal viene precargado con el nombre del proyecto.
  </Tab>

  <Tab title="Desde la sección de Canales">
    Desde tu dashboard en Jelou, ve al menú izquierdo y haz clic en **Canales**.

    <Frame>
      <img src="https://mintcdn.com/jelouai/c1cdOl7WyaQMyFvZ/images/image-1.png?fit=max&auto=format&n=c1cdOl7WyaQMyFvZ&q=85&s=d0cbc21dbc52959a0a554f573df6cfa1" alt="Menú de Canales en el dashboard de Jelou" width="3821" height="1798" data-path="images/image-1.png" />
    </Frame>

    En la cabecera hay un botón directo de **WhatsApp**, junto a Web y Facebook.

    <Frame>
      <img src="https://mintcdn.com/jelouai/5LS55VJu1WEztyrW/images/image-22.png?fit=max&auto=format&n=5LS55VJu1WEztyrW&q=85&s=c2f51023175fd17e48342c6c351e29b0" alt="Sección de Canales en el dashboard de Jelou" width="2880" height="1510" data-path="images/image-22.png" />
    </Frame>
  </Tab>
</Tabs>

En ambos casos se abre la ventana **Activar canal de WhatsApp**.

## Paso 1: datos básicos

| Campo                | Obligatorio                              | Descripción                                                                                                                                                                                                      |
| -------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nombre del canal** | Sí                                       | Nombre con el que identificarás el canal. Mínimo 4 caracteres y máximo 50, con contador. Solo admite letras sin tilde, números, espacios, `ñ`/`Ñ` y guion bajo: cualquier otro carácter se descarta al escribir. |
| **Proyecto**         | Sí, si el canal se conecta a un proyecto | Proyecto de Brain que atenderá el canal. La lista es buscable. Es la opción por omisión.                                                                                                                         |

Si prefieres que respondan los operadores, abre la sección **Avanzado** y activa **Canal conectado a la bandeja de entrada**. Al activarlo desaparece el campo **Proyecto**.

<Frame>
  <img src="https://mintcdn.com/jelouai/9g2jx7GLip1hmFho/assets/images/channels/activar-canal-whatsapp-es.png?fit=max&auto=format&n=9g2jx7GLip1hmFho&q=85&s=651976404cf38e01543088d9ebe299ad" alt="Ventana Activar canal de WhatsApp" width="748" height="656" data-path="assets/images/channels/activar-canal-whatsapp-es.png" />
</Frame>

<Tip>
  Usa un nombre descriptivo como "WhatsApp Soporte" o "WhatsApp Ventas México" para diferenciarlo de otros canales.
</Tip>

El botón **Siguiente** permanece deshabilitado hasta que el nombre tenga más de 3 caracteres y exista una conexión válida: proyecto seleccionado o bandeja de entrada activada.

## Paso 2: proveedor de WhatsApp

Aquí eliges cómo se conectará el número. Las opciones disponibles dependen del tipo de cuenta:

| Tipo de cuenta   | Proveedores disponibles                                         |
| ---------------- | --------------------------------------------------------------- |
| **Self-service** | WhatsApp Cloud (este paso se omite y se aplica automáticamente) |
| **Enterprise**   | WhatsApp Cloud, BSP                                             |

## Paso 3: configuración según el proveedor

### WhatsApp Cloud — Registro insertado

El botón **Iniciar sesión en Facebook** abre el registro insertado de Meta. Al completarlo, Jelou obtiene automáticamente el token de acceso, el ID de cuenta, el ID del teléfono y el número que se mostrará; no tienes que escribir nada.

<Steps>
  <Step title="Inicia sesión con Facebook">
    Haz clic en **Iniciar sesión en Facebook**. Se abrirá una ventana emergente con el flujo de autenticación de Meta.

    <Frame>
      <img src="https://mintcdn.com/jelouai/5LS55VJu1WEztyrW/images/image-34.png?fit=max&auto=format&n=5LS55VJu1WEztyrW&q=85&s=038b33877f94faa61895aa5513635f94" alt="Ventana de inicio de sesión de Facebook" width="449" height="537" data-path="images/image-34.png" />
    </Frame>

    Inicia sesión con la cuenta de Facebook que tiene acceso al **Business Manager** de tu empresa.
  </Step>

  <Step title="Selecciona tu portafolio comercial">
    Elige la cuenta de **Facebook Business** que será la propietaria del número de WhatsApp.

    <Warning>
      Si conectas en nombre de un cliente, usa la cuenta Business del cliente, no la de tu agencia.
    </Warning>
  </Step>

  <Step title="Crea o selecciona tu WhatsApp Business Account (WABA)">
    Tendrás la opción de crear una nueva WABA o seleccionar una existente. Si no hay ninguna WABA asociada al negocio elegido, se creará una automáticamente.

    <Frame>
      <img src="https://mintcdn.com/jelouai/c1cdOl7WyaQMyFvZ/images/image-13.png?fit=max&auto=format&n=c1cdOl7WyaQMyFvZ&q=85&s=0047f1df64728dc90d9e44d8cdfd1576" alt="Selección de WABA" width="448" height="535" data-path="images/image-13.png" />
    </Frame>

    * Escribe el **nombre de exhibición** de tu negocio en WhatsApp (sigue las directrices de Meta para evitar rechazos).
    * Selecciona la **categoría** que mejor describe tu empresa.

    <Frame>
      <img src="https://mintcdn.com/jelouai/c1cdOl7WyaQMyFvZ/images/image-15.png?fit=max&auto=format&n=c1cdOl7WyaQMyFvZ&q=85&s=b341f16362e39909fcd8372d190f8e71" alt="Nombre de exhibición y categoría" width="453" height="536" data-path="images/image-15.png" />
    </Frame>
  </Step>

  <Step title="Agrega o elige un número de teléfono">
    Conecta el número de teléfono que usarás en WhatsApp:

    * Si es un **número nuevo**: ingrésalo e introduce el código de verificación que recibirás por SMS o llamada.
    * Si ya tienes un **número de WhatsApp Business en uso**: selecciónalo de la lista de números disponibles.

    <Frame>
      <img src="https://mintcdn.com/jelouai/c1cdOl7WyaQMyFvZ/images/image-16.png?fit=max&auto=format&n=c1cdOl7WyaQMyFvZ&q=85&s=6feeb448052da86cf667c7d86ead1584" alt="Verificación del número de teléfono" width="453" height="536" data-path="images/image-16.png" />
    </Frame>
  </Step>

  <Step title="Acepta los permisos y finaliza">
    Acepta los permisos solicitados por Jelou para gestionar mensajes en tu nombre.

    <Frame>
      <img src="https://mintcdn.com/jelouai/5LS55VJu1WEztyrW/images/image-18.png?fit=max&auto=format&n=5LS55VJu1WEztyrW&q=85&s=f19b6a6ee5e7a5cc450da7f64ef0030b" alt="Pantalla de aceptación de permisos" width="463" height="640" data-path="images/image-18.png" />
    </Frame>

    Si ves la pantalla de confirmación, haz clic en **Finalizar**. Esto cerrará la ventana de Facebook y regresarás al asistente en Jelou.

    <Frame>
      <img src="https://mintcdn.com/jelouai/5LS55VJu1WEztyrW/images/image-19.png?fit=max&auto=format&n=5LS55VJu1WEztyrW&q=85&s=379f9d4a9e55cd9f9321219d032917eb" alt="Confirmación de configuración exitosa" width="448" height="536" data-path="images/image-19.png" />
    </Frame>
  </Step>

  <Step title="Acepta los términos y activa el canal">
    De vuelta en Jelou, acepta los términos y condiciones. Tu número queda registrado y listo para recibir y enviar conversaciones.

    <Frame>
      <img src="https://mintcdn.com/jelouai/5LS55VJu1WEztyrW/images/image-26.png?fit=max&auto=format&n=5LS55VJu1WEztyrW&q=85&s=096aff55383d6015df5d7cc4078b1f51" alt="Términos y condiciones de activación" width="2880" height="810" data-path="images/image-26.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  Si Meta devuelve un PIN de verificación en dos pasos, aparece en pantalla con un botón para copiarlo. Guárdalo: Meta lo pide en validaciones posteriores del número.
</Note>

En cuentas **self-service** este método es el único disponible y el flujo es más corto: el botón principal del asistente pasa a ser **Iniciar sesión en Facebook** y, en cuanto Meta devuelve los datos, el canal se crea y se conecta sin pasos adicionales. Si el registro se cancela o falla, el formulario se limpia para que puedas reintentarlo.

<Warning>
  Si la sincronización de contactos e historial de la app de WhatsApp Business falla, verás un aviso: el canal queda creado, pero los contactos y el historial podrían no estar disponibles.
</Warning>

### WhatsApp Cloud — Manual

Todos los campos son obligatorios. Los datos provienen de tu cuenta de Meta y la validación la hace Meta, no Jelou, así que revísalos antes de continuar.

| Campo               | Descripción                                                                                                    |
| ------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Teléfono**        | Número que atenderá el canal, con código de país.                                                              |
| **ID de cuenta**    | ID de la cuenta de WhatsApp Business (WABA). El enlace *"¿Cómo lo obtengo?"* lleva a la documentación de Meta. |
| **Token de acceso** | Token de acceso de la app de Meta. Se escribe oculto y también tiene enlace a la documentación de Meta.        |
| **ID del teléfono** | ID del número de teléfono en Meta.                                                                             |

## Paso 4: validar la conexión del canal

Abre el canal desde la tabla de **Canales** para ver su configuración. Los datos de conexión se muestran en modo lectura:

| Elemento               | Para qué sirve                                                                              |
| ---------------------- | ------------------------------------------------------------------------------------------- |
| **Tipo de producción** | Proveedor con el que quedó conectado el canal.                                              |
| **Teléfono del canal** | Número asociado, cuando ya está disponible.                                                 |
| **Credenciales**       | Los datos del proveedor. Los valores sensibles, como tokens y llaves, se muestran ocultos.  |
| **WhatsApp Tester**    | Código QR para abrir el chat y probar el canal.                                             |
| **Testers**            | Solo en canales de sandbox: lista de teléfonos autorizados a probar el ambiente de pruebas. |

Desde esta misma pantalla puedes editar el nombre del canal y eliminarlo.

## Verificación de la cuenta WhatsApp Business

<Info>
  Verificar tu cuenta de WhatsApp Business te permite superar el límite de **250 conversaciones al mes** y alcanzar **1,000 o más**. Sin verificación, tu número operará con capacidad reducida.
</Info>

Para verificar tu cuenta necesitas un **Facebook Business Manager verificado**. Esto también muestra el nombre oficial de tu empresa a los clientes. Consulta los [lineamientos de Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits#quality) para más detalles.

## Próximos pasos

Una vez que el canal esté activo podrás:

1. Configurar tus **plantillas de mensajes** (HSM) aprobadas por WhatsApp
2. Probar el envío y recepción de mensajes
3. Conectar el canal a un flujo automatizado en Brain Studio
4. Escalar conversaciones a agentes humanos en Connect
5. Lanzar **campañas** a través de plantillas aprobadas

## Mejores prácticas

* **Responde rápido**: WhatsApp monitorea los tiempos de respuesta y puede limitar tu cuenta si son lentos.
* **Respeta la ventana de 24 horas**: Pasadas 24 horas sin respuesta del usuario, necesitas una plantilla aprobada para retomar la conversación.
* **Mantén la calidad**: Evita mensajes masivos no solicitados; las quejas de usuarios pueden restringir tu número.
* **Usa plantillas adecuadas**: Selecciona la plantilla correcta según el contexto de cada conversación.

## Notas

* El nombre del canal se puede seguir editando después; el número y las credenciales no se cambian desde aquí.
* La validación del número en **WhatsApp Cloud** es un proceso propio de Meta: si los datos son incorrectos, el error aparece del lado de Meta y hay que reiniciar el proceso allá.
* Un mismo proyecto puede tener varios canales de WhatsApp, pero un número no puede repetirse entre canales.
* Para usar el mismo número en Jelou y en la app de WhatsApp Business, revisa [Coexistencia](/connect/configuraciones/coexistencia). Esa configuración solo lista canales de WhatsApp en producción, activos y que no sean de sandbox.