Saturn Studio – Credencial/Webhook WhatsApp Business

Esta guía explica cómo configurar y obtener las credenciales necesarias de WhatsApp Business API en la plataforma de Meta for Developers para integrarlas en Saturn Studio, así como la suscripción correcta a su Webhook.

1. Configuración y Obtención de Credenciales

Para vincular tu cuenta de WhatsApp Business con Saturn Studio necesitas dos datos principales:

  • WhatsApp Business Account ID
  • WhatsApp Business Access Token (el cual autocompletará el número de teléfono vinculado una vez verificado).

Requisitos Previos en Meta

  1. Contar con una cuenta de Facebook.
  2. Estar registrado como desarrollador en Meta for Developers.
  3. Disponer de un Portafolio de Negocios (Meta Business Account) activo.

Paso a Paso para Crear la App en Meta

  • Creación de la App:

    • Ve a Mis Apps > Crear App.
    • Ingresa el nombre de la aplicación y tu correo electrónico de contacto.
    • En Casos de Uso, selecciona la opción Conectarse con los clientes a través de WhatsApp (esto habilitará los permisos y accesos de la API).
    • Vincula la app a tu Portafolio de Negocios (Business Account).
    • Revisa el resumen y haz clic en Crear.

  • Obtención de Token e IDs:

    • Entra a la App creada y dirígete a Casos de Uso > Conectarse con los clientes a través de WhatsApp > Personalizar.
    • En el menú lateral, selecciona Configuración de la API.
    • Si no lo has hecho, vincula o registra tu número de teléfono de prueba/producción.
    • Copia el WhatsApp Business Account ID generado en la pantalla.
    • Genera el Token de acceso (Access Token) y cópialo.

Paso a Paso en Saturn Studio

  1. Abre Saturn Studio e ingresa al módulo de credenciales de WhatsApp Business.
  2. Pega el WhatsApp Business Account ID y el WhatsApp Business Access Token en sus respectivos campos.
  3. Haz clic en el botón de verificación / check al lado del campo WhatsApp Business Access Token.
  4. Si la autenticación es correcta, la plataforma validará el token y el campo Phone Number se completará automáticamente con el número registrado en Meta.
  5. Importante: No guardes la credencial sin antes verificar el Access Token haciendo clic en el botón de check, o de lo contrario la credencial no se guardará correctamente.
  6. Guarda la credencial.

2. Suscripción al Webhook de WhatsApp Business

Una vez guardada la credencial, debes configurar la recepción de eventos en tiempo real (mensajes entrantes y estados).

Paso a Paso para la Suscripción al Webhook

  • Obtener la URL de Webhook en Saturn Studio:

    • En Saturn Studio, abre el comando o nodo Subscribe to Webhook.
    • Selecciona la credencial de WhatsApp Business previamente configurada.
    • Copia la Webhook URL que se genera automáticamente.

  • Configurar el Webhook en Meta:

    • Vuelve al panel de Meta for Developers, dentro de Casos de uso > WhatsApp > Configuración (o Webhooks).
    • Cambia el selector de producto a WhatsApp (o WhatsApp Business Account).
    • En el campo URL de devolución de llamada, pega la Webhook URL copiada de Saturn Studio.
    • En Token de verificación, ingresa el token correspondiente a tu configuración de Saturn.

  • Verificación Simultánea:

    • En Saturn Studio, haz clic en el botón Start Subscription to WhatsApp Webhook para poner el servidor a la escucha.
    • De forma inmediata, vuelve al panel de Meta y haz clic en Verificar y guardar.

Si el proceso fue exitoso, Saturn Studio mostrará el mensaje Subscription success! y Meta marcará la URL con un check verde.

Importante: Tras completar la verificación en Meta, ve a la lista de campos de suscripción (Subscription fields) y haz clic en Suscribirse en la fila correspondiente a messages para comenzar a recibir los mensajes entrantes en tus flujos.