# Acceso al Servicio de API WhatsApp

Para utilizar el servicio de API de WhatsApp, los usuarios deben seguir los siguientes pasos:

## Comprar Suscripción

El acceso al servicio requiere **al menos una suscripción de WhatsApp activa**.

Los usuarios pueden adquirir **múltiples suscripciones** si necesitan utilizar varios números de WhatsApp de forma simultánea.

Cada suscripción define los **límites y características de uso**, por ejemplo:

* Duración de la suscripción
* Cantidad de mensajes permitidos
* Número de instancias disponibles
* Otras configuraciones del servicio

\
La suscripción puede adquirirse desde el panel de usuario en el siguiente enlace:

<https://api.migo.pe/whatsapp-subscriptions>

## Crear Instancia API WhatsApp

Una vez adquirida la suscripción, el usuario podrá **crear una nueva instancia de API de WhatsApp** desde el panel:

<https://api.migo.pe/whatsapp-subscriptions>

Cada **instancia**:

* Está asociada a una suscripción específica
* Representa una **conexión individual** al servicio de WhatsApp
* Permite vincular un número de WhatsApp para el envío de mensajes mediante la API

## Vincular Número de WhatsApp

Después de crear la instancia, es necesario **vincular un número de WhatsApp** escaneando un **código QR** generado por el sistema.

Pasos:

1. Ingresar al **detalle de la instancia**.
2. En la sección **Estado de instancia**, hacer clic en **“Generar código QR”**.
3. Escanear el código QR desde la aplicación móvil de WhatsApp.

{% hint style="info" %}
El QR puede ser escaneado desde la aplicación móvil de WhatsApp o WhatsApp Business (WhatsApp > Dispositivos vinculados).
{% endhint %}

{% hint style="warning" %}
El código QR expira luego de 30 minutos. Si expira, puede generar uno nuevo desde el mismo panel.
{% endhint %}

## Obtener Credenciales

Una vez que la instancia esté correctamente vinculada al número de WhatsApp, el usuario podrá acceder a las **credenciales necesarias para utilizar la API**.

Las credenciales incluyen:

**API Key (`apikey`)**\
Clave secreta utilizada para autenticar cada solicitud a la API.

**Nombre de instancia API (`instanceName`)**\
Identificador único de la instancia de WhatsApp que se utilizará para enviar mensajes.

Estas credenciales deben incluirse en cada solicitud para **autenticar y dirigir correctamente las operaciones hacia la instancia correspondiente**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.migo.pe/api-whatsapp/cuenta/acceso-al-servicio-de-api-whatsapp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.