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.