Integración de Hubsoft con ProvedorZAP

Acerca de ProvedorZAP

ProvedorZAP es una API de WhatsApp creada para proveedores de internet. El proveedor conecta su propio número en el área del cliente y administra conexiones y claves de API desde un panel. La plataforma gestiona el noveno dígito de los números brasileños y envía mensajes con intervalos y pausas automáticas para proteger el número contra bloqueos.

Qué hace la integración

• Envía notificaciones, avisos de vencimiento y facturas al WhatsApp del suscriptor desde Hubsoft.
• Envía los avisos según las reglas de SMS de la forma de cobro: después de generar la factura, antes del vencimiento, después del vencimiento o después del pago.
• Usa los diseños de SMS para mensajes de atención, órdenes de servicio, cumpleaños y otros tipos.
• Permite envíos personalizados desde el menú del cliente o a un grupo de clientes filtrado en el informe Servicios del Cliente.
• Valida el JSON del mensaje: en el diseño de SMS, en las reglas de la forma de cobro y en los envíos personalizados, Hubsoft avisa que el mensaje debe estar en JSON y ofrece la opción Validar JSON, que señala errores y da formato al texto.

Lo que necesitas

• Una cuenta en ProvedorZAP con WhatsApp conectado.
• La URL de producción y la clave de autenticación de la API (x-api-key) de ProvedorZAP.

Cómo activar

1. En Hubsoft, accede a Configuración > Integraciones > SMS/Mensajero y haz clic en Agregar.
2. Elige el gateway Provedor Zap e ingresa la descripción, la URL y la clave de la API. Guarda.
3. Prueba la integración en Acciones.
4. Crea los mensajes en JSON en los diseños de SMS y en las reglas de la pestaña SMS de la forma de cobro, usando Validar JSON antes de guardar.
5. Crea la rutina Enviar SMS en Configuración > General > Rutinas.

El paso a paso con las pantallas está en la página de ProvedorZap en la wiki de Hubsoft.

Limitaciones

• El mensaje debe estar en JSON. Si el formato es incorrecto, Hubsoft muestra una alerta y el diseño también se valida al guardarlo.

Preguntas frecuentes

¿Por qué el mensaje debe estar en JSON?

Porque este gateway envía la solicitud en JSON a ProvedorZAP. La opción Validar JSON muestra si el texto es correcto y da formato al mensaje para facilitar su edición.

¿Puedo enviar un mensaje a un grupo de clientes?

Sí. Filtra a los clientes en el informe Servicios del Cliente, selecciona quiénes lo recibirán y usa la acción de SMS personalizado con la integración de ProvedorZAP.

Un cliente no recibió el aviso. ¿Qué debo revisar?

Si la factura cumple la regla, si está en la forma de cobro con las reglas y si el servicio y el contacto del cliente permiten este tipo de aviso.

Revisado el 10/10/2026.