معرفی شرکت ها
callhub-python-wrapper-1.2.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Python API Wrapper for the CallHub API
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | callhub-python-wrapper-1.2.3 |
| نام | callhub-python-wrapper |
| نسخه کتابخانه | 1.2.3 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | James Brunet |
| ایمیل نویسنده | james@brunet.dev |
| آدرس صفحه اصلی | https://github.com/jamesbrunet/callhub-python-wrapper |
| آدرس اینترنتی | https://pypi.org/project/callhub-python-wrapper/ |
| مجوز | The MIT License (MIT) |
# CallHub Python Wrapper
[](https://travis-ci.org/jamesbrunet/callhub-python-wrapper) [](https://coveralls.io/github/jamesbrunet/callhub-python-wrapper?branch=master) 
CallHub API Client Wrapper for Python
Creates a clean(er) python interface to several important functions of the CallHub API.
### Installation
`pip install callhub-python-wrapper`
*Requires Python 3.5 or higher*
### Features
* Built-in (optional) ratelimiting that respects CallHub's varying rate limits for different functions
* Better error handling for uploading contacts with fields that don't exist in CallHub
* Abstracted away some tedious parts of using CallHub's API. When uploading contacts, CallHub wants you to map CSV columns to the ids of each field in CallHub, which is difficult and easy to mess up. This wrapper handles all of that by matching on field names.
* Automatically handles paging when doing bulk fetching
* Uses async requests to improve speed for repetitive calls (implemented in get_contacts)
### Implemented in latest release
* Bulk create contacts
* Get agent leaderboard
* Get all fields and IDs (including custom fields)
* Bulk get contacts and fields
* Create single contact
* Get all phone numbers on DNC list
* Get all DNC lists
* Add/remove numbers to/from DNC list(s)
* Create and delete DNC lists
* Get campaigns
* Create phonebook
* Create/get/delete webhook
### Currently on roadmap
* Create/get teams
* Add/delete agent to/from team
* Create/delete agent
* Export campaigns
# Usage
##### Initialization
from callhub import CallHub
# Note the required argument for API domain: Depending on your CallHub account, you
# may have a different API domain below (EG. "https://api-na1.callhub.io")
callhub = CallHub("https://api.callhub.io", api_key="123456789ABCDEF")
##### Contacts and Phonebooks
phonebook_id = callhub.create_phonebook("My new phonebook",
description="Used to test the bulk_create method")
contacts = [{'first name': 'Sumiya', 'phone number':'5555555555', 'mobile number': '5555555555'},
{'first name': 'Joe', 'phone number':'5555555555', 'mobile number':'5555555555'}]
country_iso = "CA"
# Create multiple contacts
callhub.bulk_create(phonebook_id, contacts, country_iso)
# Create single contact
callhub.create_contact(contacts[0])
# Get all contacts (up to a user-specified limit)
callhub.get_contacts(limit=1000000)
# Get all contacts with no limit (this might take a while, see performance notes)
callhub.get_contacts()
##### DNC Lists
# Get names and ids of all do-not-contact lists
callhub.get_dnc_lists()
# Get all phone numbers marked do-not-contact and the do-not
# contact list(s) that they are associated with
callhub.get_dnc_phones()
# Create a DNC list
list_id = callhub.create_dnc_list("My DNC List Name")
# Delete a DNC list
callhub.remove_dnc_list(list_id)
# Add phone number 555-555-5555 to DNC list id 123456789
results, errors = callhub.add_dnc(["15555555555"], "123456789")
# Add multiple phone numbers to DNC list id 12345689
results, errors = callhub.add_dnc(["15555555555","15554443333"], "123456789")
# Remove number(s) from all DNC lists
errors = callhub.remove_dnc(["15554443333"])
# Remove number(s) from specific DNC list id
errors = callhub.remove_dnc(["15555555555"], "123456789")
# Performance Notes
##### Bulk creating contacts works differently from most other functions
This takes advantage of CallHub's built in bulk_create API endpoint, so expect equivalent speeds to uploading a spreadsheet of contacts as a normal admin user. Note that bulk_create can only be called once every 70 seconds to comply with a special CallHub ratelimit on this endpoint.
##### It's faster to call add_dnc/remove_dnc with ten numbers than to call add_dnc/remove_dnc with one number ten times
If you use this library to make looping calls on most functions (e.g. add_dnc), you can expect a performance of about 0.5-1 requests/second. This is because all functions wait until they receives a response from the server before exiting.
However, you can get much faster performance if you call these functions with a list of contacts (as opposed to ten times with one contact each time). This is because every function that does many similar repetitive API calls leverages async requests for repetitive calls (makes a large batch of requests and then waits for that pool of requests to finish.) Because of this, we can achieve real-world speeds of adding 5-10 numbers to a DNC list per second for large batches of numbers (CallHub's API limit is 20/s).
##### Fetching contacts with get_contacts can take a while
CallHub only gives us 10 contacts per api request when using get_contacts, so expect this library to fetch contacts at about 100 contacts/s. That's about 17 minutes to fetch 100K contacts!
نیازمندی
| مقدار | نام |
|---|---|
| ==2.2.1 | ratelimit |
| ==1.0.0 | requests-futures |
| ==2.23.0 | requests |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.5 | Python |
نحوه نصب
نصب پکیج whl callhub-python-wrapper-1.2.3:
pip install callhub-python-wrapper-1.2.3.whl
نصب پکیج tar.gz callhub-python-wrapper-1.2.3:
pip install callhub-python-wrapper-1.2.3.tar.gz