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

# Inicio rápido

> De cero a tu primer envío de WhatsApp: elige conexión oficial o no oficial y sigue los pasos.

<Tip>
  Esta guía lo lleva desde **la cuenta hasta el primer envío**. Elija su modo a continuación: **oficial** para producción o **no oficial** para probar rápidamente.
</Tip>

## En breve

* **Oficial:** inicio de sesión Meta en el panel, tarjeta en WhatsApp Manager, primero envíe con una **plantilla aprobada**
* **No oficial:** crea la instancia, **escanea el código en tu teléfono**, envía **texto libre**
* Ambos usan la **misma API**; solo cambia la forma de conectar el número.

¿No estás seguro de cuál elegir? Ver [Modos de conexión](/es/whatsapp-api/como-funciona/modos-de-conexao).

## Antes de empezar

* Una **Clave API** (`sk_live_...` o `sk_test_...` para sandbox)
* Permisos de instancia y envío en la clave. Ver [Ámbitos](/es/whatsapp-api/como-funciona/escopos-api-key)
* En ejemplos, reemplace `sk_live_xxxxx` con su clave y `https://api.notifique.dev` con su URL base si es necesario

<Note>
  ¿Recién está empezando? Utilice `sk_test_...` y compruebe los resultados en la [bandeja de entrada de Sandbox](/es/guides/sandbox/index).
</Note>

***

<Tabs>
  <Tab title="Conexión oficial">
    ### 1. Conecta el número

    Tres caminos, elige el que mejor se adapte a tu integración:

    #### 1A, a través del panel

    1. WhatsApp → Nueva instancia → **Oficial**
    2. Inicie sesión con su cuenta Meta y vincule el número
    3. Cuando el estado es **activo**, anote el **ID de instancia**

    #### 1B, vía API con enlace para el cliente

    Para **incorporación remota** (sin navegador en su servidor): cree un borrador y envíe el enlace; el cliente completa el inicio de sesión Meta en la página.

    Respuesta esperada: **200** con una instancia **PENDIENTE** y el enlace:

    Envíe `shareableLink.hostedUrl` al cliente. Cuando termine, la instancia pasa a **activa**.

    <Warning>
      Cualquiera que tenga el enlace puede conectar o desconectar la instancia. Después de su uso, rote el secreto con `POST /v1/whatsapp/instances/:instanceId/connect-page/rotate-secret`.
    </Warning>

    #### 1C, vía API con credenciales Meta

    Con **Embedded Signup** ya hecho en el navegador, cree una instancia oficial ya **activa** usando los tres campos Meta:

    Respuesta esperada: **200** con una instancia **activa**:

    <Info>
      Resumen: **panel** para la ruta más sencilla; **`generateShareableLink: true`** cuando otra persona necesita completar el inicio de sesión Meta; **`metaEmbeddedCode` + `metaPhoneNumberId` + `metaWabaId`** cuando ya tienes datos de registro integrado.
    </Info>

    ### 2. Agrega una tarjeta en el Administrador de WhatsApp

    Meta factura **conversaciones** en tu cuenta. Sin una tarjeta registrada, los envíos de producción no funcionarán.

    1. Abra [Administrador de WhatsApp](https://business.facebook.com/wa/manage/)
    2. Vaya a **Configuración de pago**
    3. Añada una tarjeta válida
    4. En el panel de Notifique, confirme que el pago esté activo

    ### 3. Sincronizar plantillas

    En el panel, use **Sincronizar plantillas con Meta** (o cree una nueva). Necesita una plantilla **aprobada** para el primer contacto.

    Detalles: [Plantillas oficiales Meta](/es/whatsapp-api/como-funciona/templates-oficiais-meta).

    ### 4. Envía tu primera plantilla

    Fuera de un chat reciente, el oficial requiere una **plantilla aprobada**:

    Respuesta esperada: **202** con el mensaje en cola:

    ### 5. Chat después de que respondan

    Cuando el cliente **responda**, tiene unas **24 horas** para enviar texto o medios libres:

    Respuesta esperada: **202**:

    Fuera de esa ventana, use una **plantilla** nuevamente.
  </Tab>

  <Tab title="Conexión no oficial">
    <Warning>
      Use no oficial para **pruebas y MVPs**. Para clientes reales en producción, prefiera **oficial**.
    </Warning>

    ### 1. Crear instancia y emparejar

    Tres caminos, elige el que mejor se adapte a tu integración:

    #### 1A, a través del panel

    1. WhatsApp → Nueva instancia (el valor predeterminado es **no oficial**)
    2. Abra el **código en su teléfono** que se muestra en el panel
    3. Escaneélo en la aplicación WhatsApp en el número que enviará mensajes
    4. Cuando el estado es **activo**, anote el **ID de instancia**

    #### 1B, vía API con QR en tu UI

    Crea la conexión y devuelve el código para que lo renderices:

    Respuesta esperada: **200** con el código en `connection.base64`:

    Use `connection.base64` para mostrar el **código** (imagen) y escanéelo en WhatsApp en el número emisor.

    #### 1C, vía API con enlace para que el cliente escanee

    Pase `generateShareableLink: true` para obtener también un enlace, útil cuando quien escanea no está en su pantalla:

    Respuesta esperada: **200** con QR **y** enlace compartible:

    Envíe `shareableLink.hostedUrl` para que el cliente lo abra y escanee. Cuando esté conectado, el estado pasa a **activo**.

    <Warning>
      Cualquiera que tenga el enlace puede conectar o desconectar la instancia. Después de su uso, rote el secreto con `POST /v1/whatsapp/instances/:instanceId/connect-page/rotate-secret`.
    </Warning>

    <Info>
      Resumen: **panel** para la ruta más sencilla; **API con QR** para incrustar el código en tu UI; **`generateShareableLink: true`** cuando alguien más necesita escanear.
    </Info>

    <Warning>
      **¿Nueva SIM o número?** Lea [Números y SIM nuevos](/es/whatsapp-api/como-funciona/politica-anti-banimento#nuevos-numeros-y-sim) antes de su primer envío de producción.
    </Warning>

    ### 2. Actualiza el código (si caduca)

    El código caduca rápidamente. Solicite uno nuevo **sin crear una nueva instancia**:

    Respuesta esperada: **200** con un código nuevo:

    También puede obtener un nuevo código vía [webhook](/es/whatsapp-api/como-funciona/eventos-do-webhooks) (`instance.qrcode`).

    ### 3. Envía un mensaje de texto

    Con una instancia **activa**, envía a números en formato internacional (`5511999999999`):

    Respuesta esperada: **202** con el mensaje en cola:
  </Tab>
</Tabs>

***

## Después del primer envío

* Siga **entrega y lectura** vía [webhooks](/es/whatsapp-api/como-funciona/eventos-do-webhooks)
* ¿Varios números? Consulte [Sending Pools](/es/whatsapp-api/como-funciona/sending-pools)
* Campos y rutas completos: **Referencia API** en la pestaña WhatsApp

## Próximos pasos

* [Introducción](/es/whatsapp-api/como-funciona/introducao): descripción general del canal
* [Modos de conexión](/es/whatsapp-api/como-funciona/modos-de-conexao): comparación completa
* [Plantillas oficiales Meta](/es/whatsapp-api/como-funciona/templates-oficiais-meta)
* [Política anti-banimento](/es/whatsapp-api/como-funciona/politica-anti-banimento)