DOCUMENTACIÓN OFICIAL SOBRE INFRAESTRUCTURA DE WHATSAPP API

¿Te fue útil?

INTRODUCCIÓN GENERAL AL SISTEMA #

La infraestructura de mensajería de Panthercolor PLATFORM opera utilizando las conexiones oficiales de la Cloud API de Meta. A diferencia de las aplicaciones móviles convencionales (WhatsApp Messenger o WhatsApp Business en teléfonos), la API empresarial está diseñada para brindar estabilidad, multi-posición para equipos de ventas masivos y automatización avanzada con Inteligencia Artificial.

Debido a que este entorno corre sobre servidores en la nube administrados directamente por Meta, existen reglas, niveles y limitaciones técnicas globales que regulan su comportamiento. Este documento detalla con transparencia absoluta el funcionamiento del sistema para resolver las dudas operativas más comunes de nuestros clientes.

CAPÍTULO 1: LÍMITES DE MENSAJERÍA Y COMPORTAMIENTO DE CARGA ORGÁNICA #

1.1 ¿Qué es el «Límite de mensajería» en la API?

Cuando un número de teléfono se vincula por primera vez a la API de WhatsApp dentro de Panthercolor PLATFORM, el panel de configuración mostrará una métrica denominada «Límite actual de mensajería». Este indicador suele iniciar con un valor base de 250.

Existe una confusión generalizada al interpretar esta cifra. El límite de 250 NO representa una restricción para recibir mensajes de clientes potenciales.

  • Capacidad de Recepción Orgánica: Es 100% ilimitada desde el segundo cero. Si un negocio tiene una campaña publicitaria activa, un sitio web muy movido o una comunidad grande, y entran 500, 1,000 o 10,000 mensajes de usuarios en un solo día, la plataforma los procesará y mostrará todos en el chat unificado sin ningún tipo de retraso o bloqueo.
  • Conversaciones Iniciadas por la Empresa: El límite aplica de forma exclusiva a las conversaciones iniciadas proactivamente por el negocio dentro de un periodo de 24 horas. Esto se refiere al envío de plantillas de marketing, notificaciones masivas o mensajes masivos dirigidos a personas que no han escrito previamente al número en las últimas 24 horas.

1.2 Mecanismo Automático de Escalamiento de Niveles

Meta monitorea constantemente el comportamiento y la calidad del número para incrementar los límites de envío de manera automatizada. El sistema cuenta con niveles estandarizados definidos en la interfaz:

Nivel de MensajeríaTipo de EstadoCriterio de Activación por Meta
Nivel 250Base Inicial (Tu empresa)Asignado automáticamente a números nuevos o recientemente registrados.
Nivel 2,000Escala Inicial Avanzada (Panthercolor)Requiere iniciar conversaciones con al menos 1,000 clientes únicos en un periodo de 7 días seguidos.
Nivel 10,000Escala CorporativaEl volumen de envíos masivos se duplica si la calificación de calidad se mantiene óptima.
Nivel 100,000Alto Volumen ComercialHabilitado para flujos masivos continuos de notificaciones a nivel regional.
IlimitadoNivel Máximo GlobalRemoción total de restricciones diarias para envíos proactivos por parte de la empresa.

1.3 Cómo forzar la subida de nivel de forma segura

Para acelerar la transición del Nivel 250 al Nivel 2,000, la empresa debe mantener una interacción constante. Meta exige cumplir con dos disparadores principales para subir el umbral:

  1. Iniciar un flujo de conversación único con un volumen de 1,000 contactos en una ventana móvil de 7 días.
  2. Mantener el indicador de «Calificación de calidad» en estado Verde (Alta) o Media. Si los usuarios finales bloquean o reportan el número como spam, la calificación baja, congelando el límite o reduciéndolo inmediatamente.

CAPÍTULO 2: LLAMADAS EN WHATSAPP API Y RESTRICCIONES DE ENTORNO #

2.1 Explicación Técnica: ¿Por qué aparece el estado «No cumple las condiciones»?

Tanto en cuentas nuevas en desarrollo como en la cuenta matriz de la agencia, la pestaña de «Llamadas de WhatsApp» refleja la etiqueta «No cumple las condiciones». Este estado desconcierta a los usuarios que asumen que la API debería replicar todas las funciones del teléfono móvil.

La limitación obedece a la naturaleza del protocolo Cloud API:

  • Diseño Basado en Datos: La API fue construida como un canal asíncrono de transferencia de datos estructurados (mensajes de texto, componentes multimedia, interacciones con Webhooks y flujos de Chatbots).
  • Ausencia de Protocolo VoIP Nativo Libre: Los servidores centrales de Meta que procesan las conexiones API no tienen habilitada de manera abierta la conmutación de Voz sobre IP (VoIP) para llamadas entrantes o salientes de forma estándar en toda la infraestructura de subcuentas.
  • Políticas de Meta: Meta restringe el acceso a las funciones de llamadas en la API para prevenir que bots automatizados realicen spam de voz masivo, resguardando la experiencia de usuario dentro de la aplicación móvil.

2.2 Requisitos Especiales para Habilitación de Funciones Beta

Meta libera la opción de llamadas únicamente bajo condiciones estrictas de madurez de cuenta:

  • Verificación Comercial: El Administrador Comercial de Meta (Meta Business Suite) debe estar completamente verificado mediante el envío de documentos legales de constitución (RUC, LLC, facturas de servicios públicos).
  • Historial de Cumplimiento: El número debe registrar meses de uso continuo con una calificación de calidad Verde impecable y un volumen masivo de interacciones orgánicas previas.
  • Despliegue Regional: La función debe estar activa en el clúster de servidores asignado al código de país del número (ej. +593 para Ecuador).

CAPÍTULO 3: SOLUCIONES OPERATIVAS EN Panthercolor PLATFORM #

Para que las limitaciones de Meta no afecten el día a día comercial de las empresas, Panthercolor PLATFORM provee soluciones alternativas transparentes para los equipos de ventas:

3.1 Sustitución de Llamadas vía Sistema Telefónico Nativo

Dado que no se puede presionar el botón de llamada de WhatsApp dentro de la API, el flujo de trabajo correcto para los vendedores (Hunters) es el siguiente:

  1. Configuración del Módulo de Telefonía: En la sección Sistema telefónico, la subcuenta adquiere o vincula un número de telefonía virtual asignado a su operación.
  2. Llamada con un Clic (Click-to-Call): Cuando un vendedor está gestionando un lead en el chat unificado y detecta la necesidad de llamarlo por voz, utiliza el botón de llamada telefónica del panel. El sistema procesa la llamada saliente a través de las redes celulares convencionales de manera inmediata, quedando grabada la interacción en el historial del cliente.

3.2 Gestión del Historial Comercial Centralizado (Ficha 360°)

Aunque la mensajería y la telefonía corran por canales técnicos distintos detrás de escena, la ventaja competitiva de la plataforma es la centralización. La ficha única del cliente almacena:

  • La conversación completa de WhatsApp (mensajes entrantes ilimitados).
  • Las interacciones en redes sociales conectadas (Instagram, Facebook Messenger).
  • El registro, duración y grabaciones de las llamadas telefónicas tradicionales realizadas por el equipo de ventas.