Obtener los límites y el uso del plan Social

Indica qué permite tu plan Social y cuánto has utilizado. Consúltalo antes de emitir un enlace de conexión para poder avisar al cliente de que no tiene capacidad disponible, en lugar de mostrar un SY95042 causado por una operación de escritura fallida.

usage.connections es exactamente usage.connectionsActive + usage.connectionsReleased.

Una plaza liberada sigue reservada hasta que finaliza el período

Desconectar un canal lo deja inactivo de inmediato, pero no devuelve la plaza a la capacidad disponible. Dentro de un período de facturación, el límite cuenta las conexiones distintas que has utilizado, sigan conectadas o no, por lo que la plaza sigue consumida hasta que se renueva la suscripción. Hay 3 consecuencias que conviene tener en cuenta al programar:

• La capacidad disponible es maxConnections - usage.connections, nunca maxConnections - usage.connectionsActive. Usar el número de conexiones activas hará que le indiques al cliente que tiene una capacidad de la que no dispone, y el siguiente enlace de conexión devolverá SY95042.
• Volver a vincular la misma cuenta a la misma marca es gratis. Si un cliente vuelve a conectar una página que había desconectado de esa marca durante el período, se reutiliza la plaza que ya tiene reservada: connectionsActive aumenta, connectionsReleased disminuye y connections no cambia. Vincular esa misma página a una marca diferente ocupa otra plaza, y la original sigue reservada hasta la renovación.
• connectionsReleased es tu previsión para la renovación. Es exactamente el número de plazas que vuelven a estar disponibles al comenzar el siguiente ciclo, que es lo que debes mostrar a un cliente que esté decidiendo entre esperar a la renovación o comprar un paquete hoy.

Esto sigue el mismo patrón que el resto del modelo de facturación: la capacidad que compras está disponible de inmediato, y la capacidad a la que renuncias se retira al final del ciclo. Consulta Planes y complementos.

Caso de uso: una comprobación previa en tu flujo de incorporación. Antes de ofrecer al cliente el botón "conectar una cuenta", compara usage.connections —el número de conexiones facturables, no connectionsActive— con maxConnections. Si no hay capacidad disponible, muéstrale la opción de adquirir un complemento o pasar a un plan superior, en lugar de dejar que POST /social/brands/{brandId}/connections/link falle. No hay una comprobación equivalente para las marcas: al crear una con POST /social/brands, nunca se agota la capacidad.

Caso de uso: calcular el tamaño del próximo complemento. Los paquetes de conexiones se venden en grupos de 5, por lo que maxConnections - usage.connections te indica directamente cuántas redes puedes conectar todavía, y ceil((needed - headroom) / 5) indica cuántos paquetes debes comprar.

Notas.

• Las marcas son ilimitadas y su uso no se contabiliza. brands devuelve null para las cuentas de listingsAPI. El código cliente que lo trataba como un límite entero debe admitir null y no debería mostrar "0 marcas restantes".
• Las conexiones forman una reserva compartida por toda la cuenta, no una asignación por marca. Una marca puede tener tantas conexiones como quieras, hasta las 5 redes que admite, siempre que quede capacidad en la reserva. Consulta Planes y complementos.
• Este endpoint abarca únicamente la suscripción de Social. Los límites de ubicaciones corresponden a la suscripción de Listings y se aplican por separado en POST /locations, que devuelve SY10155 cuando la cuenta no tiene ningún plan de Listings.
• Las cuentas de autoservicio tienen un límite de 250 conexiones, independientemente de cuántos paquetes se compren. Para superar ese límite, la cuenta debe pasar a Enterprise.
• Tener capacidad disponible no garantiza que Instagram se conecte. Instagram solo permite una cuenta Business o Creator vinculada a una página de Facebook; las cuentas personales se rechazan en la pantalla de consentimiento de Meta, no por este límite. Si un cliente tiene capacidad disponible aquí y el enlace de conexión sigue fallando para Instagram, lo que necesita es convertir la cuenta, no más capacidad.
• Las cifras se actualizan en tiempo real, pero una liberación no es un reembolso. Desconectar mediante disconnect o archivar una marca se refleja aquí en la siguiente consulta, como una disminución de usage.connectionsActive y un aumento equivalente de usage.connectionsReleased. usage.connections no cambia, porque la plaza sigue reservada hasta que finaliza el período. Ambas formas de liberación se comportan de manera idéntica.