# ¿Cómo configurar WhatsApp en Skyone Studio?

Esta documentación fue creada para ayudarte a configurar **WhatsApp Business** en **Skyone Studio**, asegurando que sigas todas las etapas necesarias para una integración correcta.

### Términos importantes (Glosario)

* **Meta for Developers:** Herramienta oficial de Meta (Facebook) para la creación y configuración de aplicaciones e integraciones, incluyendo WhatsApp Business.
* **Token de Acceso:** Código utilizado para autenticar la comunicación entre **Skyone Studio** y **WhatsApp Business**.
* **Webhook:** URL utilizada para recibir eventos y mensajes de WhatsApp Business.

### Requisitos previos

Para configurar WhatsApp Business, necesitarás trabajar simultáneamente en dos productos: **Skyone Studio** y **Meta for Developers**.

Es necesario contar con:

* Una cuenta de desarrollador en **Meta for Developers**.
* Acceso a **Skyone Studio**.
* Un espacio compatible con el paquete **AI 01 o superior**, que permita la creación de agentes de IA.

La configuración se realiza en varias etapas:

1. Creación de la aplicación en **Meta for Developers**.
2. Generación del **Token de acceso temporal**.
3. Configuración de datos en **Skyone Studio**.
4. Definición de Token de acceso permanente y finalización de la integración en **Meta Developers**.

Cada paso es esencial para que la integración funcione correctamente y sin interrupciones.

***

### Pasos de configuración

#### \[Paso 01] Crear aplicación en Meta for Developers

1. Asegúrate de tener una cuenta de desarrollador activa en **Meta for Developers**.
2. Accede a **Meta for Developers** y haz clic en **“Crear aplicación”**.
3. En **Detalles de la aplicación**, ingresa un nombre y un correo de contacto. Luego, haz clic en **“Avanzar”**.
   * El nombre definido se mostrará en la sección **Mis Apps** y quedará asociado al **ID de la aplicación** (editable posteriormente).
   * Usa un correo válido, ya que Meta lo utilizará para notificaciones sobre políticas, restricciones o recuperación de la aplicación.
4. En **Casos de Uso**, selecciona **“Otro”** y haz clic en **“Avanzar”**.
5. En **Tipo de Empresa**, selecciona **“Empresa”** y haz clic en **“Avanzar”**.
6. Selecciona el portafolio empresarial deseado y haz clic en **“Crear aplicación”**.

El portafolio agrupa los activos de la cuenta de negocio (aplicaciones, páginas, números de WhatsApp). Es importante elegir el correcto para vincular los recursos adecuados.

***

#### \[Paso 02] Generar el Token de acceso temporal

1. En el menú lateral, selecciona **WhatsApp → Configurar**.
2. Haz clic en **“Configuración de la API”** → **“Continuar”**.
3. Selecciona **“Generar token de acceso”**.
4. Elige la cuenta de WhatsApp para pruebas que Meta proporciona.
   * También puedes usar el número de tu empresa, siempre que:
     * No esté vinculado a otro WhatsApp existente.
     * Sea un número nuevo y exclusivo para la integración.
     * Esté configurado como **WhatsApp Business**.
5. Haz clic en **“Continuar”** y luego en **“Guardar”**.

{% hint style="info" %}
el token generado en entorno de desarrollo tiene una validez de solo **1 hora**.
{% endhint %}

***

#### \[Paso 03] Usar los datos de WhatsApp en Skyone Studio

1. Accede a **Skyone Studio**.
2. En el menú **Integraciones**, haz clic en **“Publicar”** (ubicado en la parte derecha).
3. Selecciona la opción **“WhatsApp”**.
4. Antes de avanzar, copia los códigos obtenidos en **Meta Developers** (ID, número de teléfono, token, etc.).
5. Completa los campos en **Skyone Studio**:
   * **Flujo del Agente:** Selecciona un flujo ya creado.
   * **Nombre:** Define un nombre para la publicación.
   * **ID del número:** Lo encuentras en la URL de la API. Ejemplo:
     * URL: `https://graph.facebook.com/v22.0/123456789/messages`
     * ID = `123456789`
   * **Número:** El número configurado (ejemplo: número de prueba).
   * **Token:** Ingresa el token generado.
   * **API Secret:**
     1. En el menú lateral de **Meta Developers**, accede a **“Configuraciones → Básico”**.
     2. Haz clic en **“Mostrar”** en la opción **Clave Secreta de la Aplicación**.
6. Haz clic en **“Guardar publicación”**.
   * **Skyone Studio** mostrará los detalles de la conexión establecida.

***

#### \[Paso 04] Finalizar configuración en Meta Developers

1. En el menú lateral de **Meta Developers**, selecciona **WhatsApp → Configuración**.
2. Completa los siguientes campos con los datos de **Skyone Studio**:
   * **URL de callback:** pega el valor del campo *Webhook*.
   * **Token de verificación:** pega el valor del campo correspondiente.
3. En **Campos del webhook**, confirma que la opción **Messages** esté marcada como **“Firmado”**.
4. Haz clic en **“Verificar y guardar”**.

&#x20;¡Listo! La configuración de **WhatsApp Business en Skyone Studio** está completa y lista para usar.

### FAQ – Configuración de WhatsApp en Skyone Studio

<details>

<summary>¿Necesito una cuenta específica para hacer la configuración?</summary>

Sí. Es necesario tener una cuenta de desarrollador en **Meta for Developers** y acceso a **Skyone Studio**.

</details>

<details>

<summary>¿Cómo puedo crear la cuenta de desarrollador en Meta for Developers?</summary>

Puedes encontrar la guía paso a paso y la documentación oficial para crear una cuenta de desarrollador en Meta en la siguiente página:\
**Registro -** [**Meta for Developers ↗**](https://developers.facebook.com/docs/development/register/?translation\&locale=es_LA)\
Esa página contiene el proceso oficial de registro, incluyendo los pasos para iniciar la inscripción, aceptar los términos, verificar tu cuenta y seleccionar tu ocupación.

</details>

<details>

<summary>¿Puedo hacer la configuración en modo de prueba?</summary>

Sí. El **Modo de Desarrollo** está indicado para validación y pruebas, pero el token generado tendrá una validez de solo 1 hora.

</details>

<details>

<summary>¿Dónde encuentro el ID del número de WhatsApp?</summary>

El ID puede identificarse en el **Paso 2**, en la URL de la API presentada.\
Ejemplo: `https://graph.facebook.com/v2.0/123456789/messages` → El ID es **123456789**.

</details>

<details>

<summary>¿Es obligatorio finalizar la configuración en Meta Developers?</summary>

Sí. Este paso es necesario para vincular la aplicación al número de WhatsApp y validar el webhook.

</details>
