Group Audit

This script will generate a JSON output containing detail, and summaries, of elements of the group which are typically chargeable to a customer.

Currently, the script produces information around:

• User Count and Limits

• Group DNs

• Group Services

• User Services

• User Service Packs

• Trunking Call Capacity

The script makes use of the following methods:

api.services.get_group_services()
api.services.get_group_services_assigned()
api.dns.get_group_dns()
api.groups.get_group()
api.trunk_groups.get_group_trunk_groups_call_capacity()

Parameters

• service_provider_id: Service Provider where the group is hosted.

• group_id: Group where the User is located.

Return

• dict: Returns dictionary containing all group information. Including Users, Group DNs, Group Services, User Services, User Service Packs, Trunking Capacity.

How To Use:

This method requires keyword arguments i.e. group_id="group_id"

assistant = Scripter(my_api)

print(assistant.group_audit(
    service_provider_id="ServiceProviderID", 
    group_id="GroupID"
    )
)

Example returned data (formatted):

{
    "group_detail": {
        "defaultDomain": "bworks.provider.com",
        "userLimit": 50,
        "userCount": 4,
        "groupName": "Example Group 1",
        "callingLineIdName": "Example Group 1",
        "callingLineIdPhoneNumber": "[phone]",
        "callingLineIdDisplayPhoneNumber": "01632123456",
        "timeZone": "Europe/London",
        "timeZoneDisplayName": "(GMT) Greenwich Mean Time",
        "serviceProviderId": "Ent1",
        "groupId": "GrpA"
    },
    "licence_breakdown": {
        "user_services": [
            {
                "serviceName": "Authentication",
                "usage": 1,
                "users": [
                    "User1"
                ]
            },
            {
                "serviceName": "Call Forwarding Always",
                "usage": 2,
                "users": [
                    "User1",
                    "User2"
                ]
            },
            {
                "serviceName": "Call Forwarding Busy",
                "usage": 2,
                "users": [
                    "User1",
                    "User3"
                ]
            }
        ],
        "group_services": [
            {
                "serviceName": "Auto Attendant",
                "usage": 1
            },
            {
                "serviceName": "Hunt Group",
                "usage": 5
            },
            {
                "serviceName": "Music On Hold",
                "usage": 1
            },
            {
                "serviceName": "Trunk Group",
                "usage": 2
            }
        ],
        "service_pack_services": [
            {
                "servicePackName": "Standard",
                "usage": 3,
                "description": "Standard Pack",
                "users": [
                    "User1",
                    "User2",
                    "User3"
                ]
            },
            {
                "servicePackName": "Premium",
                "usage": 1,
                "description": "Premium Pack",
                "users": [
                    "User4"
                ]
            }
        ]
    },
    "group_DNs": {
        "assigned": {
            "activated": [
		"[phone]"
            ],
            "deactivated": [
                "[phone]"
            ],
            "total_assigned_DNs": 2
        },
        "unassigned": {
            "activated": [
                "[phone]"
            ],
            "deactivated": [
                "[phone]"
            ],
            "total_unassigned_DNs": 2
        },
        "total_DNs": 4
    },
    "group_trunking": {
        "maxActiveCalls": 10,
        "maxAvailableActiveCalls": 10,
        "burstingMaxActiveCalls": 1,
        "burstingMaxAvailableActiveCalls": 1,
        "maxAvailableNumberOfBurstingBTLUs": 0,
        "numberOfBurstingBTLUs": 0
    }
}