Custom role missing telephony.plugin permission — agent cannot use softphone

Administration
1

The softphone requires telephony:plugin:all in the user’s role. Period.

If you created a custom role and forgot this permission, the WebRTC client won’t initialize. The agent sees a grey phone icon with no tooltip. Fix: Admin > Roles > your custom role > add telephony:plugin:all.

GET /api/v2/authorization/roles/{roleId} - check the permissions array.

2

I ran into this when setting up my first integration!

# I tried to check permissions like this
role = auth_api.get_authorization_role(role_id)
if 'telephony:plugin:all' in role.permissions:
    print('Has softphone!')

But it returned an empty list. Sorry for the noob question, but does the API return permissions differently than how they are displayed in the admin UI?