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

# Conectar WhatsApp

> Conecta tu WhatsApp Business desde la interfaz de Shimli — sin trámites técnicos.

WhatsApp es el canal principal para la mayoría de los clientes de Shimli. La conexión se hace directamente desde Shimli: todo el proceso ocurre dentro de la plataforma, sin que tengas que entrar a consolas externas.

<Callout type="info">
  Shimli es partner oficial de Meta, así que el proceso de conexión es el oficial y seguro.
</Callout>

## Paso a paso

<Steps>
  <Step title="1. Ve a Channels">
    Desde el sidebar, haz clic en **Channels**. Busca el canal de **WhatsApp** (aparece como desconectado al principio).
  </Step>

  <Step title="2. Haz clic en el canal de WhatsApp">
    Al hacer clic, verás la información del canal y un botón que dice **Connect with Meta** o **Connect WhatsApp Business**.
  </Step>

  <Step title="3. Inicia sesión en Facebook">
    Haz clic en **Connect with Meta**. Se abre una ventana de login de Facebook. Ingresa tu usuario y contraseña.

    <Callout type="info">
      Esto es totalmente seguro. Shimli es partner de Meta, así que el proceso es el oficial. Facebook te pregunta qué permisos vas a dar y tú los autorizas.
    </Callout>
  </Step>

  <Step title="4. Autoriza los permisos">
    Facebook te muestra los permisos que Shimli necesita para gestionar tus mensajes. Revisa y haz clic en **Continuar**.
  </Step>

  <Step title="5. Selecciona el portafolio">
    Elige el **portafolio (Business Portfolio)** al que se conectará WhatsApp.

    <Callout type="warning">
      El portafolio debe estar **verificado**. Un portafolio verificado da mayor confianza y desbloquea más capacidades.
    </Callout>
  </Step>

  <Step title="6. Selecciona o crea la cuenta de WhatsApp">
    Si ya tienes una cuenta de WhatsApp Business, selecciónala. Si no, crea una nueva desde aquí mismo.
  </Step>

  <Step title="7. Selecciona la página de Facebook y la cuenta de ads">
    Elige la página de Facebook que se asociará y la cuenta de anuncios. Esto ayuda a tener mejor performance y métricas.
  </Step>

  <Step title="8. Configura el nombre y descripción">
    Ponle un nombre y una descripción a tu cuenta de WhatsApp Business.

    <Callout type="warning">
      El nombre debe ser el de tu empresa. Es una cuenta de WhatsApp empresarial, así que el nombre importa para la verificación.
    </Callout>
  </Step>

  <Step title="9. Selecciona el número de teléfono">
    Tienes dos opciones:

    * **Número nuevo en la nube**: todo se gestiona desde Shimli, no necesitas teléfono. No puedes usar este número en la app de WhatsApp.
    * **Número que ya tienes en la app de WhatsApp**: puedes migrarlo, pero primero debes eliminar la cuenta de WhatsApp en tu teléfono.
  </Step>

  <Step title="10. Agrega el método de pago">
    Se te pide una tarjeta para los cobros de envío de plantillas y mensajes. Agrega tu tarjeta y listo.
  </Step>
</Steps>

<Callout type="info">
  Shimli ya completó la migración a la última versión del proceso de conexión. Esto simplifica enormemente el proceso — ya no necesitas trámites manuales para la mayoría de los casos.
</Callout>

## Configurar tu WhatsApp desde Shimli

Una vez conectado, puedes gestionar tu cuenta de WhatsApp **sin salir de Shimli**. En la página del canal de WhatsApp verás varias pestañas:

### Profile

Aquí puedes configurar:

* **WhatsApp username (@handle)** — reserva y gestiona tu nombre de usuario para que los clientes te encuentren sin necesidad de tu número.
* **Foto de perfil** — visible en tu perfil de WhatsApp Business.
* **Display name** — el nombre visible (debe estar aprobado).
* **Verificación de marca** — solicita el check verde directamente desde Shimli.
* **Categorías, about, descripción, dirección, email, website** — toda la información del perfil.

<Callout type="info">
  Si el username está reservado pero no visible aún, significa que WhatsApp aún no ha activado usernames para todos los usuarios. Shimli lo gestiona automáticamente cuando se habilite.
</Callout>

### Icebreakers

Frases de inicio que aparecen cuando un cliente abre la conversación contigo por primera vez.

### Commands

Comandos rápidos que tus clientes pueden usar dentro de la conversación.

### Calling

WhatsApp permite hacer llamadas desde la conversación. Aquí puedes:

* **Activar o desactivar** el calling.
* Elegir si el botón de llamada aparece **por defecto** o no.
* **Restringir países** — define a qué países se permite llamar.
* Configurar la **zona horaria**.

<Callout type="warning">
  Las llamadas de WhatsApp tienen restricciones de países soportados. Verifica que tu país esté en la lista antes de activar esta función.
</Callout>

## Ventana de 24 horas

En WhatsApp Business existe la **ventana de servicio al cliente** de 24 horas:

* Cuando un cliente te escribe, tienes 24 horas para responder con mensajes libres (sin costo de plantilla).
* Fuera de esa ventana, necesitas enviar **plantillas aprobadas**.
* Shimli te avisa si intentas enviar un mensaje libre fuera de ventana.

<Callout type="warning">
  A partir de **octubre 2026**, los mensajes de servicio dentro de la ventana de 24h también serán facturables. Ve a [Cambios de pricing 2026](/whatsapp/pricing-changes) para entender el impacto.
</Callout>

<Accordions>
  <Accordion title="¿Necesito un número de teléfono dedicado?">
    Sí, para WhatsApp Business API necesitas un número dedicado. Puede ser un número nuevo en la nube (gestionado desde Shimli, sin teléfono) o un número que ya tengas, pero en ese caso debes eliminar la cuenta de WhatsApp en tu teléfono primero.
  </Accordion>

  <Accordion title="¿Quién cobra los envíos de WhatsApp?">
    Los cobros por envío de plantillas y mensajes los gestiona Shimli desde tu wallet. Recarga saldo en la plataforma y Shimli se encarga del resto.
  </Accordion>

  <Accordion title="¿Puedo usar el mismo número en la app de WhatsApp?">
    No. Un número conectado a WhatsApp Business no puede usarse simultáneamente en la app de WhatsApp o WhatsApp Business. Si lo tienes en la app, debes eliminar esa cuenta antes de conectarlo.
  </Accordion>

  <Accordion title="¿Qué pasa si mi portafolio no está verificado?">
    Te recomendamos verificar tu portafolio antes de conectar WhatsApp. Un portafolio verificado desbloquea más capacidades y da mayor confianza. Shimli te guía en el proceso.
  </Accordion>
</Accordions>
