Blog UzzAIPrimeros Pasos
Cómo Conectar tu WhatsApp Business a UzzApp
Guía completa paso a paso para conectar tu número de WhatsApp Business a UzzApp usando la API Oficial de Meta.
05/03/2026•8 min•Por Equipe Uzz.Ai
Role para descobrir a jornada completa
SUMÁRIO13 seções
Para comenzar a usar UzzApp, necesitas conectar tu número de WhatsApp Business a la plataforma usando la API Oficial de Meta (WhatsApp Business API). Este proceso implica configurar una aplicación en Meta Developers, obtener las credenciales necesarias y registrarlas en UzzApp.
Requisitos previos
Antes de comenzar, asegúrate de tener: (1) Una cuenta verificada en Meta Business Suite. (2) Un número de teléfono exclusivo para WhatsApp Business — no puede ser un número ya en uso en WhatsApp personal. (3) Acceso al panel de Meta Developers (developers.facebook.com). (4) Tus credenciales de acceso a UzzApp.
Sigue los pasos a continuación en el orden correcto. El proceso toma en promedio de 20 a 40 minutos la primera vez.
Paso 1 — Crear la App en Meta Developers
- 1Accede a developers.facebook.com e inicia sesión con tu cuenta de Meta Business.
- 2Haz clic en "Mis Apps" → "Crear App".
- 3Selecciona el tipo "Business" y dale un nombre a la app (ej.: "UzzApp MiNegocio").
- 4Después de crear, ve a "Agregar Producto" y agrega el producto "WhatsApp".
- 5Selecciona o crea una cuenta de WhatsApp Business asociada a tu Meta Business.
Paso 2 — Obtener las Credenciales
- 1En el panel de la app, ve a WhatsApp → Configuración de la API.
- 2Copia el "Token de Acceso Temporal" (comienza con EAA...) — deberás generar un Token Permanente después.
- 3Anota el "ID del Número de Teléfono".
- 4Anota el "ID de la Cuenta de WhatsApp Business" (WABA ID).
- 5En Configuración de la App → Básico, copia el "App Secret".
Token Permanente vs. Temporal
El token temporal vence en 24 horas y es solo para pruebas. Para producción, debes generar un Token Permanente a través de un Usuario del Sistema en Meta Business Suite. Ve a: Meta Business Suite → Configuraciones → Usuarios del Sistema → Generar Token.
Paso 3 — Configurar las Credenciales en UzzApp
- 1Accede a tu panel de UzzApp y ve a Configuraciones → Credenciales (Vault).
- 2Ingresa el Token de Acceso (META_ACCESS_TOKEN).
- 3Ingresa el ID del Número de Teléfono (META_PHONE_NUMBER_ID).
- 4Ingresa el App Secret (META_APP_SECRET).
- 5Define un Token de Verificación personalizado (META_VERIFY_TOKEN) — puede ser cualquier texto seguro, ej.: "mi-empresa-2026".
- 6Guarda las credenciales. Se cifran automáticamente con AES-256.
Paso 4 — Configurar el Webhook en Meta
- 1De regreso en Meta Developers, ve a WhatsApp → Configuración.
- 2En la sección "Webhooks", haz clic en "Configurar Webhooks".
- 3En el campo URL de Callback, ingresa: https://chat.uzzai.com.br/api/webhook/TU_CLIENT_ID
- 4En el campo Token de Verificación, ingresa exactamente el mismo texto que definiste en el paso anterior (META_VERIFY_TOKEN).
- 5Haz clic en "Verificar y Guardar". Meta realizará una solicitud a UzzApp para confirmar.
- 6Después de verificar, activa las suscripciones: messages y message_status_updates.
Cómo encontrar tu Client ID
Tu Client ID es el identificador único de tu empresa en UzzApp. Lo encuentras en: Configuraciones → Mi Cuenta → Client ID. Tiene el formato de un UUID (ej.: 550e8400-e29b-41d4-a716-446655440000).
Paso 5 — Probar la Conexión
- 1Envía un mensaje de texto al número de WhatsApp configurado.
- 2Accede al Panel UzzApp → Conversaciones y verifica si apareció el mensaje.
- 3Si apareció, la conexión está funcionando correctamente.
- 4Si no apareció, verifica si el webhook está activo y si el token de acceso es válido.
¿Conexión lista? Próximo paso
Ahora configura tu asistente de IA y realiza la configuración inicial de la plataforma.
Configuración Inicial →