Integración de Hubsoft con TáTelecom

Acerca de Tá Telecom

Tá Telecom, nombre comercial de ISPS do Brasil S.A., con sede en São Paulo, es un operador de telefonía móvil para todo Brasil. El proveedor de internet vende los planes a su propia base de clientes y puede usar el modelo white label, con chip y perfil eSIM con su marca. La red es de TIM. Para operar, el proveedor debe cumplir con la normativa de telecomunicaciones.

Qué hace la integración

• Sincronización de planes: los planes de Tá Telecom se incorporan a Hubsoft desde la pantalla de integración.
• Activación de la línea: en el servicio del cliente, el agente elige el plan y el código de área, e informa el ICCID y el número, cuando no aparece completado.
• Línea que ya existe en Tá Telecom: el agente informa el contrato vigente y el número se vincula al contrato existente, sin crear un nuevo registro en la plataforma.
• Portabilidad con token: puede solicitarse durante la activación o después, mediante las acciones del número. Tá Telecom envía un código por SMS al celular del suscriptor, y el agente valida ese código en Hubsoft para continuar con la portabilidad. Hubsoft consulta el estado cada hora.
• Cambio de plan, de SIM Card y de titularidad: mediante las acciones del número, sin eliminar la línea ni generar cobros indebidos en la plataforma.
• Bloqueo y desbloqueo: cuando el servicio del cliente se suspende o habilita en Hubsoft, la solicitud pasa a la cola de transmisión de Tá Telecom.
• Cancelación: al eliminar el número o el plan, la cancelación se envía a Tá Telecom.
• Informe de MVNO: muestra los servicios con líneas de Tá Telecom y los errores de transmisión.

Qué necesitas

• Contrato con Tá Telecom y el token de autenticación, proporcionado por el soporte de Tá Telecom.
• Chips identificados mediante el ICCID.
• Los planes de Hubsoft que recibirán líneas deben tener marcada la opción "Servicio permite MVNO".

Cómo activar

1. En Hubsoft, accede a Configuración > Integraciones > MVNO > Agregar y selecciona el gateway Tá Telecom.
2. Ingresa el token. Si Tá Telecom indica otra dirección de API, ingrésala también.
3. Sincroniza los planes en Acciones > Planes.
4. En Configuración > General > Servicios / Planes, marca "Servicio permite MVNO" en los planes que tendrán una línea móvil.
5. En el servicio del cliente, accede a Otras opciones > Datos MVNO > Agregar, elige el plan y el código de área e ingresa el ICCID.

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

Limitaciones

• Algunos proveedores todavía usan Tá Telecom mediante el gateway de TIP, que tiene la misma API. Tá Telecom está migrando a los clientes a su integración propia. Antes de registrarte, confirma con Tá Telecom cómo se creó tu contrato. Para quienes usan el gateway de TIP, hay una página específica en la wiki.
• La portabilidad solo continúa después de validar el código enviado por SMS al suscriptor.

Preguntas frecuentes

Si el servicio del cliente se suspende por falta de pago, ¿también se suspende la línea?

Sí. La suspensión en Hubsoft entra en la cola de bloqueo de Tá Telecom. Al habilitar el servicio, el desbloqueo sigue el mismo proceso.

¿Puedo incorporar a Hubsoft una línea que ya está activa en Tá Telecom?

Sí. En el registro del número, ingresa el contrato vigente. El número se vincula al contrato existente, sin crear un nuevo registro.

¿Por qué la portabilidad solicita un token?

Es una regla de Tá Telecom. Al solicitar la portabilidad, el suscriptor recibe un código por SMS. El agente valida el código en Hubsoft y la solicitud continúa.

Revisado el 10/10/2026.