¿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”.

el token generado en entorno de desarrollo tiene una validez de solo 1 hora.

---

[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”.

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

FAQ – Configuración de WhatsApp en Skyone Studio

¿Necesito una cuenta específica para hacer la configuración?

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

¿Cómo puedo crear la cuenta de desarrollador en Meta for Developers?

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 ↗ 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.

¿Puedo hacer la configuración en modo de prueba?

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

¿Dónde encuentro el ID del número de WhatsApp?

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.

¿Es obligatorio finalizar la configuración en Meta Developers?

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