Beeline cloudpbx portal api wrapper

Install

Install using pip...

pip install beeline-portal

Usage

from beeline_portal import BeelinePBX

client = BeelinePBX('<access_token>')

get abonents

abonents = client.get_abonents() # return map[Abonent]

find abonent

abonent = client.find_abonent('<pattern>') # raise BeelinePBXException or return Abonent

get abonent agent status

result = client.get_abonent_agent_status('<pattern>') # raise BeelinePBXException or return {'status': status}

set abonent agent status

_ = client.set_abonent_agent_status('<pattern>', 'status') # raise BeelinePBXException or return {}

get abonent recording status

result = client.get_abonent_recording_status('<pattern>') # raise BeelinePBXException or return {'status': status}

enable abonent recording

_ = client.enable_abonent_recording('<pattern>') # raise BeelinePBXException or return {}

stop abonent recording

_ = client.stop_abonent_recording('<pattern>') # raise BeelinePBXException or return {}

call from abonent

result = client.call_from_abonent('<pattern>', 'phone number') # raise BeelinePBXException or return {'response': response}

v2 call from abonent

result = client.call_from_abonent_v2('<pattern>', 'phone number') # raise BeelinePBXException or return {'response': response}

transfer call from abonent

result = client.transfer_call_from_abonent('<pattern>','call_id', 'phone number') # raise BeelinePBXException or return {}

transfer call from abonent

result = client.transfer_call_with_consult('<pattern>','call_id', 'call_id_consult') # raise BeelinePBXException or return {}

add extension number

result = client.transfer_call_with_consult('<pattern>','phone number', 'schedule') # raise BeelinePBXException or return {}

delete extension number

result = client.delete_extension_number('<pattern>') # raise BeelinePBXException or return {}

get cfb

cfb_response = client.get_cfb('<pattern>') # raise BeelinePBXException or return CfbResponse

enable cfb

from beeline_protal.models import Cfb

cfb = Cfb('+7397999992', '+7397999993')
cfb_response = client.get_cfb('<pattern>', cfb) # raise BeelinePBXException or return CfbResponse

stop cfb

result = client.stop_cfb('<pattern>') # raise BeelinePBXException or return {}

get cfs rule list

result = client.get_cfs_rules('<pattern>') # raise BeelinePBXException or return CfsStatusResponse

add cfs rule

from beeline_portal.models import CfsRule

cfs_rule = CfsRule('my rule', '+7937999992', 'WORKING_TIME', ['+7937999993'])
result = client.add_cfs_rule('<pattern>', cfs_rule) # raise BeelinePBXException or return {'number': response}

enable cfs

result = client.enable_cfs('<pattern>') # raise BeelinePBXException or return {}

update cfs rule

from beeline_portal.models import CfsRule

cfs_rule = CfsRule('my rule', '+7937999992', 'WORKING_TIME', ['+7937999993'])
result = client.update_cfs_rule('<pattern>','cfs_id', cfs_rule) # raise BeelinePBXException or return {}

stop cfs

result = client.stop_cfs('<pattern>') # raise BeelinePBXException or return {}

delete cfs rule

result = client.delete_cfs_rule('<pattern>', '<cfs_id>') # raise BeelinePBXException or return {}

get bwl list

result = client.get_bwl_list('<pattern>') # raise BeelinePBXException or return BwlStatusResponse

add bwl rule

from beeline_portal.models import BwlRule

bwl_rule = BwlRule('BWL_RULE', 'WORKING_TIME', ['+7939797772'])
result = client.add_bwl_rule('<pattern>', 'WHITE_LIST', bwl_rule)  # raise BeelinePBXException or return {'number': response}

update bwl rule

from beeline_portal.models import BwlRule

bwl_rule = BwlRule('BWL_RULE', 'WORKING_TIME', ['+7939797772'])
result = client.update_bwl_rule('<pattern>', '<bwl_id>', bwl_rule)  # raise BeelinePBXException or return {}

enable bwl

result = client.enable_bwl('<pattern>', '<rule_type>') # raise BeelinePBXException or return {}

stop bwl

result = client.stop_bwl('<pattern>') # raise BeelinePBXException or return {}

delete bwl rule

result = client.delete_bwl_rule('<pattern>', '<bwl_id>') # raise BeelinePBXException or return {}

get call records

call_records = client.get_records() #raise BeelinePBXException or return map[CallRecord]

delete call record

result = client.delete_record('<record_id>') #raise BeelinePBXException or return {}

get call record

call_record = client.get_record('<record_id>') #raise BeelinePBXException or return CallRecord

get call record by extratracking id

call_record = client.get_record_by_extratracking_id('<extratracking_id>', '<user_id>') #raise BeelinePBXException or return CallRecord

download call record

bytes_record_data = client.download_record('<record_id>') #raise BeelinePBXException or return record data in bytes

download call record by extracking id

bytes_record_data = client.download_record_by_extracking_id('<extratracking_id>', '<user_id>') #raise BeelinePBXException or return record data in bytes

get call record link

record_link = client.get_record_link('<record_id>') #raise BeelinePBXException or return string

get call record link by extracking id

record_link = client.get_record_link_by_extracking_id('<extratracking_id>', '<user_id>') #raise BeelinePBXException or return string

get incoming numbers

incoming_numbers = client.get_incoming_numbers() #raise BeelinePBXException or return map[Number]

find incoming number

inc_number = client.find_incoming_number('<pattern>') #raise BeelinePBXException or return Number

create subscription

from beeline_portal.models import SubscriptionRequest

sr = SubscriptionRequest('<pattern>', 23,'BASIC_CALL', '<url>')
result = client.create_subscription(sr) #raise BeelinePBXException or return dict

get subscription

subs = client.get_subscription('<subscription_id>') #raise BeelinePBXException or return Subscription

stop subscription

subs = client.stop_subscrption('<subscription_id>') #raise BeelinePBXException or return {}

get icr numbers

icr_numbers = client.get_icr_numbers() #raise BeelinePBXException or return map[Number]

enable icr for numbers

result = client.enable_icr_for_number(['+79238458793']) #raise BeelinePBXException or return map[IcrNumbersResult]

stop icr for numbers

result = client.stop_icr_for_number(['+79238458793']) #raise BeelinePBXException or return map[IcrNumbersResult]

get icr route rules

icr_route_rules = client.get_icr_route_rules() #raise BeelinePBXException or return map[IcrRouteRule]

delete icr route rules

from beeline_portal.models import IcrRouteRule

rule = IcrRouteRule('+7923424535', '201')
icr_route_rules = client.delete_list_of_icr_rules([rule]) #raise BeelinePBXException or return map[IcrRouteResult]

add icr route rules

from beeline_portal.models import IcrRouteRule

rule = IcrRouteRule('+7923424535', '201')
icr_route_rules = client.add_list_of_icr_rules([rule]) #raise BeelinePBXException or return map[IcrRouteResult]

update icr route rules

from beeline_portal.models import IcrRouteRule

rule = IcrRouteRule('+7923424535', '201')
icr_route_rules = client.update_list_of_icr_rules([rule]) #raise BeelinePBXException or return map[IcrRouteResult]

get voice campaigns

campaigns = client.get_voice_campaigns() #raise BeelinePBXException or return map[VoiceCampaign]

upload voice file to campaign

result = client.upload_file_to_voice_campaign('<path to file>') # raise BeelinePBXException or return {"id": "<id>"}

add question voice campaign

from beeline_portal.models import VoiceCampaignQuestion, Answer, DateAndTime
answers = [Answer('Q1', 'gadget')]
schedule = VoiceCampaignSchedule('Q1', 'H1', 'H4', 'BUSINESS_DAY')
from_ = DateAndTime(parse_datetime('2021-11-11'), '00:00')
to_ = DateAndTime(parse_datetime('2021-11-21'), '00:00')
campaign = VoiceCampaignQuestion(
    'q_campaign',
    answers,
    "<file>",
    ['+793799992'],
    '+7123212432',
    schedule,
    from_,
    to_,
)
result = client.add_question_type_voice_campaign(campaign) # raise BeelinePBXException or return string number

add message voice campaign

from beeline_portal.models import VoiceCampaignMessage
campaign = VoiceCampaignMessage.from_beeline_struct({
    "name": "Message campaign",
    "audioFile": "file_id",
    "phones": ["200"],
    "phoneNumber": "+79379999992",
    "schedule": {
        "tryQuantity": "Q1",
        "fromHour":"H1",
        "toHour":"H4",
        "schedule":"BUSINESS_DAY"
    },
    "from": {
        "date": "2021-01-01",
        "time":"00:00:23"
    },
    "to": {
        "date": "2021-01-01",
        "time":"00:00:23"
    }
})
result = client.add_message_type_voice_campaign(campaign) # raise BeelinePBXException or return string number

update voice campaign

from beeline_portal.models import VoiceCampaign
vc = VoiceCampaign.from_beeline_struct(
{
    "name": "MyVoiceCampaign",
    "status": "SUSPENDED",
    "recordId": "hhyth1231432",
    "type": "QUESTION",
    "answers": [{"choice": "B1", "answer": "test"}],
    "audioFile": "<link>",
    "phones": ["93799992"],
    "phoneNumber": "+799999999",
    "schedule": {
        "tryQuantity": "Q1",
        "fromHour": "H0",
        "toHour": "H4",
        "schedule": "ALL_WEEK",
    },
    "from": {"date": "2021-01-01", "time": "00:00:00"},
    "to": {"date": "2021-12-01", "time": "23:59:59"},
    "abonent": {
        "userId": "[email protected]",
        "phone": "9379992",
        "firstName": "Ivan",
        "lastName": "Moody",
    },
})
result = client.update_voice_campaign('<campaign_id>', vc)

delete voice campaign

result = client.delete_voice_campaign('<campaign_id>') # raise BeelinePBXException or return {}

stop voice campaign

result = client.stop_voice_campaign('<campaign_id>') # raise BeelinePBXException or return {}

start voice campaign

result = client.start_voice_campaign('<campaign_id>') # raise BeelinePBXException or return {}

get voice campaign info

vc_info_report = client.get_voice_campaign_info('<campaign_id>') # raise BeelinePBXException or return VoiceCampaignInfoReport

get statistic

from datetime import datetime, timedelta
date_to = datetime.now()
date_from = date_to - timedelta(days=2)

statistic = client.get_statistic('<user_id>', date_from, date_to, 0, 10) # raise BeelinePBXException or return map[StatRecord]

get v2 statistic

from datetime import datetime, timedelta
date_to = datetime.now()
date_from = date_to - timedelta(days=2)

statistic = client.get_statistic_v2('<user_id>', date_from, date_to, 0, 10) # raise BeelinePBXException or return map[StatRecordV2]