This is going to be an ongoing project to explore each api function and how to use it over a period of time. First I will start with the basics. Lets create an API User

How to – Use Vicidial API’s

Added: 12-29-20

Creating an API User

Login to the Administration Page, click Users > Add A New User

Hit Submit

Scroll down to the bottom of that user and change the API settings according to your needs

After you hit submit here, you have now created the API user for whichever API process you are going to be using.

Non Agent API Functions & examples

Added: 12-29-20

Function: add_lead

Requirements: user level: 8 / Modify Leads = 1

Required Settings: phone_number, phone_code, list_id, source

Objective: Live Leads

Below is an example of what link to send your lead to

https://yourdomain.com/vicidial/non_agent_api.php?user=apiuserid&pass=apipass&source=SourceName&list_id=33333&function=add_lead&first_name=john&last_name=legend&phone_number=3057777777

This can then be used for a form to supply live leads. Below is an example I have created in WordPress.

Then this code below is on a regular wordpress page

And then the end result looks like this:

This is just a simple form to submit data into vicidial and have them instantly added into the queue to be dialed if you have that list active and agents ready to take the call. If you have any questions about this, hit me up on Skype: live:carpenox_3

Added: 01-08-21

Function: call_dispo_report

_{Requirements: user level = 9 / View Reports = 1}

Required Fields(At least 1): campaigns, ingroups, or dids

Options settings: http://www.vicidial.org/docs/NON-AGENT_API.txt

Objective: Give reports for live transfers to show sales and transfers from a date range

This function is pretty easy to implement and is being used to give access to company that is being paid for live transfers and would like a report with live stats updates instead of having to run a report through vicidial

https://cyburityllc.com/vicidial/non_agent_api.php?source=LiveTransfers&user=apiuserid&pass=apipass&function=call_dispo_report&statuses=SALE-XFER&ingroups=LiveTransfers&query_date=2020-01-01&end_date=2021-01-08&status_breakdown=1&show_percentages=1

Once someone calls this API function, it reports back like this:

This can then be used “as is” or it can be brought into a CRM or live reports screen for the business sending over the live transfers.

Added: 02-04-2021

Function: campaigns_list

_{Requirements: user level = 7}

Required Field: source

Options settings: http://www.vicidial.org/docs/NON-AGENT_API.txt

Objective: To show settings for campaigns

Here is an example structure: https://cyburityllc.com/vicidial/non_agent_api.php?source=test&user=apiuserid&pass=apipass&function=campaigns_list

And below is an example output:

TopCare|Top Care – Main|Y|TopCare|RATIO|9|DOWN TIMEZONE|CALLBK SALE NP NI N DNC DC B A NEW

This will only output the campaigns for the permission levels of the APi user’s, user group.

Hopefully this helps. Required version number for this API: 2.14

Which API function would you like to see how to use? Examples can be provided for both agent and non agent API’s. Comment below for a request.