API Oficial de WhatsApp (WABA)

ChatCielo es Tech Provider certificado por Meta, permitiendo conectar números vía API Oficial sin crear una App propia.

---

Cobros de Meta

Desde el 1 de octubre de 2026 todo mensaje enviado por la API Oficial se cobra, sin excepción por ventana de 24 horas. El modelo anterior por mensaje entregado con exenciones gratuitas queda reemplazado.

Tarifas sujetas a cambios por Meta, última revisión: Oct 2026. Los valores exactos varían por país y categoría según la tabla vigente en tu panel. Consulta siempre developers.facebook.com/docs/whatsapp/pricing y tu panel en Configuraciones → Integraciones Meta → Costos para la tarifa aplicable a tu cuenta. Un valor de ejemplo histórico sujeto a cambios para Brasil fue R$ 0,035 por mensaje de servicio entregado, pero no lo uses como tarifa fija.

Categorías de mensajes

Qué sigue siendo gratis

• Mensajes recibidos: todo lo que el cliente te envía no tiene costo.
• Ventana de 72 h de anuncios: conversaciones iniciadas por Click-to-WhatsApp Ads siguen sin costo (excepto uso de Meta Business Agent, que siempre se cobra).

Ventana de atención

Período de 24 horas que se inicia cuando el usuario envía un mensaje. Se reinicia con cada nuevo mensaje del usuario. Desde Oct 2026 la ventana ya no implica gratuidad para tus respuestas — solo define si puedes enviar texto libre o necesitas plantilla para reabrir la conversación.

Cómo estimar y ahorrar

• Calculadora: simula el impacto mensual/anual en waba.zdg.com.br/#6 informando promedio de mensajes por atención y volumen mensual. También puedes ver Configuraciones → Integraciones Meta → Costos en ChatCielo.
• Modo híbrido como alternativa de ahorro: para operaciones con alto volumen de respuestas de atendente y bot, evalúa Modo Híbrido — rutea mensajes de servicio por conexión no oficial sin cobro por mensaje de Meta, reservando el número oficial para plantillas y campañas. Revisa la guía detallada de cobranza de octubre 2026 antes de decidir.

---

Llamadas de voz (WABA)

Activar recepción

1. Configuración > Integraciones > Meta > WhatsApp
2. Seleccionar canal WABA
3. Activar llamadas WebRTC

Hacer llamada

1. Detalles del contacto > Telefonía > WABA
2. Enviar solicitud de permiso
3. El contacto autoriza en WhatsApp
4. Haz clic en Llamar (permiso válido por 72 h)

Enrutamiento

---

Registro Incorporado (App propia)

En Facebook Developers

1. Configurar dominios de la aplicación
2. Generar token de sistema con permisos:
   • business_management
   • whatsapp_business_messaging
   • whatsapp_business_management
3. Crear configuración de Inicio de sesión (Config ID)

En Superadmin

1. App Waba > Añadir
2. Completa: App ID, Versión de API, Token, Config ID, App Secret
3. Copiar Redirect URI para Facebook Developers

Conexión del cliente

1. Integraciones > Meta > Registro Incorporado
2. Inicia sesión en Facebook
3. Crear número nuevo o usar uno existente (coexistencia)

---

Configuración completa (Cloud API)

Etapa 1: Crear aplicación

1. Facebook Developers > Crear aplicación > Business
2. Añadir producto WhatsApp
3. Configurar información básica (privacidad + términos)
4. Activar aplicación ("En vivo")

Etapa 2: Registrar número

1. WhatsApp > Configuración de la API
2. Añadir número de teléfono
3. Verificar vía SMS o llamada
4. Añadir forma de pago
5. Registrar con PIN de 6 dígitos

Etapa 3: Token permanente

1. Business Manager > Usuarios del sistema
2. Crear usuario del sistema (Admin)
3. Asignar activo: aplicación con permiso "Gestionar aplicación"
4. Generar token con expiración "Nunca"
5. Permisos: whatsapp_business_management + whatsapp_business_messaging

Etapa 4: Conectar en ChatCielo

Para enviar:

1. Canales > Añadir canal > WABA
2. Completa: ID del número, ID de la cuenta, Token permanente

Para recibir (Webhooks):

1. Configuración > Integración Meta
2. Copiar URL del webhook y token de verificación
3. En Facebook: WhatsApp > Configuración de la API > Webhooks
4. Pegar URL y token > Verificar y Guardar
5. Suscribir eventos (especialmente messages)