Project

amdapi

0.0
No release in over a year
API wrapper for amdapi api
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
>= 0

Runtime

 Project Readme

Amdapi

Installation

Add this line to your application's Gemfile:

gem 'amdapi'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install amdapi

Usage

require 'amdapi'

## initialize the Amdapi client
client = Amdapi::Client.new(client_id: ENV["client_id"], client_secret: ENV["client_secret"])

## GET one call
client.find(call_uuid)

## GET a batch of calls
client.all(params: search_params_hash) # based on the filters you have provided
client.all # will get the first page of the calls linked to your entreprise

## Analyze a call (create the call info in our DB + analyse asyncronously the audio)
client.analyze(params: call_params_hash, file: audio_file)

## Delete a specific audio (this includes delete the call in our Database + the audio)
client.delete(call_uuid)

Search params

key description format
client_id look for calls that only belong to a specific client integer
agent_id look for calls that only belong to a specific agent integer
customer_id look for calls that only belong to a specific customer integer
start_date ook for all calls that have been made from start_date until the current date unless end_date is provided DD/MM/YYYY
end_date look for all the calls that have been made from start_date until end_date DD/MM/YYYY
{
	"agent_id": 42,
	"client_id": 420,
	"customer_id": 152,
	"start_date": "24/01/2021",
	"end_date": "04/05/2021"
}

Call params

key description format
call_id The ID of the call from your DB string
client_id The ID of your client. The one that operates the contact center integer
agent_id The ID of the agent that operates the call. Value from your DB integer
customer_id The ID of the customer that makes/receives the call. Value from your DB integer
origin Was the call Inbound -or- Outbound? string
language ISO code of the language used in the call. Values currently available: en - en-in - fr string
summary Generates an automatic summary of the conversation if the value is true boolean
filename The name of the call recording file string
{
	"call_id": 273,
	"client_id": 412,
	"agent_id": 42,
	"customer_id": 140,
	"origin": "Inbound",
	"language": "en-in",
	"summary": true,
	"filename": "name_of_the_audio_file"
}

File

The file can be sent the following way. Needs to be a .wav format

    file = File.read('[path to the audio file]')

License

The gem is available as open source under the terms of the MIT License.