Methods
Objects
JSON Objects used in both the API and Real-Time.
| Object | Description |
|---|---|
| Address | Postal Address |
| Analytics.Calls.App | Analytics Calls by App |
| Analytics.Calls.Country | Analytics Calls by Country |
| Analytics.Calls.Destination | Analytics Calls by Destination |
| Analytics.Calls.DID | Analytics Calls by DID |
| Analytics.Calls.History | Analytics History |
| Analytics.Calls.History.Call | Analytics Calls History (date) |
| Analytics.Calls.Summary | Analytics (summary) |
| Analytics.Calls.Summary.IN | Analytics Summary Calls IN |
| Analytics.Calls.Summary.OUT | Analytics Summary Calls OUT |
| Analytics.SMS.History | SMS Analytics History |
| Analytics.SMS.History.OUT | SMS Analytics Calls History (date) |
| Analytics.SMS.Summary | SMS Analytics (summary) |
| Analytics.SMS.Summary.OUT | SMS Analytics Summary SMS OUT |
| App | Voice App |
| App.Package | Voice App Package |
| App.Param.Vms | Voicemail |
| App.Param.VmsDetect | Outbound Voicemail Detection |
| App.SearchFilters | Search filters |
| Authentication.ApiKey | Api-Key |
| Authentication.Session | Session Token |
| Calls.Broadcast1.Options | Calls Broadcast (1) Options |
| CALLTRACKING10 | Call Tracking with call forwarding, prompts, and voicemail |
| CALLTRACKING10.GA | CALLTRACKING10 Google Analytics |
| CALLTRACKING10.Medias | CALLTRACKING10 Medias |
| CALLTRACKING10.Options | CALLTRACKING10 Options |
| CDR.In | Inbound Call Detail Record (CDR) |
| CDR.Out | Outbound Call Detail Record (CDR) |
| CDR.SearchFilters | Search filters |
| CLICKTOCALL.Call | Click-to-Call Call |
| CLICKTOCALL.Call.Status | Click-to-Call Call Status |
| CLICKTOCALL.Start.Options | Click-to-Call Start Options |
| CLICKTOCALL10 | Click-to-Call with dynamic A/B parties |
| CLICKTOCALL10.Medias | CLICKTOCALL10 Medias |
| CLICKTOCALL10.Options | CLICKTOCALL10 Options |
| CONFERENCE10 | Conference Voice App |
| CONFERENCE10.CallNumber.Options | Options when calling a number |
| CONFERENCE10.Connected | Connected participant |
| CONFERENCE10.Connected.History | Previously connected participant |
| CONFERENCE10.ConnectionsHistory.Filters | Connections History listing filters. Each property is facultative. Set it to apply a filter. |
| CONFERENCE10.ConnectionsHistory.Results | Connections History listing result object |
| CONFERENCE10.Event | Room Event |
| CONFERENCE10.Events.Filters | Events listing filters. Each property is facultative. Set it to apply a filter. |
| CONFERENCE10.Events.Results | Events listing result object |
| CONFERENCE10.Limits | Limits for CONFERENCE10 |
| CONFERENCE10.Media | Media for CONFERENCE10 |
| CONFERENCE10.Room | Conference Room (version 10) |
| CONFERENCE10.Room.Access | Room Access for CONFERENCE10. |
| CONFERENCE10.Room.Live | Conference Room (live) (version 10) |
| Country | Country object |
| Customer.CLI | Authorized Customer CLI |
| DID | DID (Phone Number) |
| DID.AreaCode | Area code |
| DID.Country | DID Country |
| DID.SearchFilters | DID Search filters |
| DID.Store.Availability | DID Availability |
| DID.Store.BuyStatus | DID Buy Status |
| DID.Store.Contract | DID Reservation Contract |
| DID.Store.Cost | DID Reservation Cost |
| DID.Store.Error | DID Store Error |
| DID.Store.Item | DID Item (phone number) in Store |
| DID.Store.QuotaStatus | DID Store Quota Status |
| DID.Store.Quote | DID Quote |
| DID.Store.Reservation | DID Reservation Status |
| DID.Type | DID type |
| HLR.Response | HRL response |
| Job | Job object |
| Media.EmailTemplate | Email template object |
| Media.Library | Media.Library object |
| Media.Library.Overview | Library overview |
| Media.Library.Overview.Count | Library overview (count) |
| Media.Library.Overview.Ready | Library overview (ready) |
| Media.PhoneID | Phone ID (DTMF sequence + phone number) |
| Media.Quota | Media quota |
| Media.Quota.Count | Media quota (count) |
| Media.Quota.Quota | Media quota (quota) |
| Media.Quota.Status | Media quota (status) |
| Media.Recording | Media Recording |
| Media.Recording.ActionResult | Recording Action Result |
| Media.Recording.ActionResult.Error | Recording Action Result (error) |
| Media.Recording.ListResult | Recording List Result |
| Media.Recording.Options | The Media.Recording.Options object defines the following properties. |
| Media.Recording.Overview | Recording overview |
| Media.Recording.Overview.Status | Recording overview (status) |
| Media.Recording.Overview.Status.Count | Recording overview (count) |
| Media.Recording.Overview.Status.Ready | Recording overview (ready) |
| Media.Recording.ReadStatus | Recording read status |
| Media.Recording.ReadStatus.Status | Recording read status (status) |
| Media.Recording.SearchFilters | Search filters |
| Media.SearchFilters | Search filters |
| Media.TTS.Options | Media Text-to-Speech Options |
| NumberInfos | NumberInfos object |
| Push.Hook.URL | Push Hook (push URL configuration) - deprecated object |
| REALTIME10 | Realtime App. Allows you to control the call in Real-Time. |
| REALTIME10.Call.Options | Realtime Call Options |
| RT.Request | Real-Time Request (Our POST to your server) |
| RT.Response | Real-Time Response (Your response to our requests). You have to send it within 5 seconds. The earliest, the better. |
| Search.Options | Search options |
| Search.Results | Search results |
| Sendr.10.Addressbook | Addressbook |
| Sendr.10.Addressbook.SearchFilters | Search filters |
| Sendr.10.Blacklist | Black list (do not call) |
| Sendr.10.Blacklist.SearchFilters | Search filters |
| Sendr.10.Campaign | Campaign |
| Sendr.10.Campaign.Blacklist | Campaign black list configuration |
| Sendr.10.Campaign.Ivr.Sms.Simple | Simple SMS |
| Sendr.10.Campaign.Ivr.Sms.Survey | Survey SMS |
| Sendr.10.Campaign.Ivr.Voice.Action.Bridge | Bridge action |
| Sendr.10.Campaign.Ivr.Voice.Action.Bridge.Email | Email sub action |
| Sendr.10.Campaign.Ivr.Voice.Action.Broadcast | Broadcast action |
| Sendr.10.Campaign.Ivr.Voice.Action.Callback | Callback action |
| Sendr.10.Campaign.Ivr.Voice.Action.Email | Email action |
| Sendr.10.Campaign.Ivr.Voice.Action.Record | Record action |
| Sendr.10.Campaign.Ivr.Voice.Ivr | Instant voice response Messages are played in the following order: voicemail_detect_media, broadcast, prompt, goodbye. |
| Sendr.10.Campaign.Ivr.Voice.IvrKey | IVR key |
| Sendr.10.Campaign.Ivr.Voice.IvrKeys | IVR keys |
| Sendr.10.Campaign.Ivr.Voice.Simple | Simple voice broadcasting. Messages are played in the following order: voicemail_detect_media, broadcast, prompt, goodbye. |
| Sendr.10.Campaign.Ivr.Voice.Survey | Voice survey |
| Sendr.10.Campaign.Ivr.Voice.Survey.Answer | Survey answer |
| Sendr.10.Campaign.Ivr.Voice.Survey.Question | Survey question |
| Sendr.10.Campaign.Options.AutoStopConditions | Auto-stop conditions |
| Sendr.10.Campaign.Options.AutoStopConditions.PerAnswerCount | Auto-stop conditions: per-answer count |
| Sendr.10.Campaign.Options.AutoStopConditions.PerKey | Auto-stop conditions: per-key count |
| Sendr.10.Campaign.Options.Followup | Followup options |
| Sendr.10.Campaign.Options.Followup.Actions | Followup actions |
| Sendr.10.Campaign.Options.Followup.Actions.Callback | Followup actions (callback) |
| Sendr.10.Campaign.Options.Followup.Actions.Sms | Followup actions (SMS) |
| Sendr.10.Campaign.Options.Followup.Conditions | Followup conditions |
| Sendr.10.Campaign.Options.SendReport | Report sending campaign options |
| Sendr.10.Campaign.Options.Sms | SMS options |
| Sendr.10.Campaign.Options.Voice | Voice options |
| Sendr.10.Campaign.SearchFilters | Search filters |
| Sendr.10.Campaign.Status | Campaign status |
| Sendr.10.Campaign.Status.Sms.SentStatus | SMS Sent Statuses Number of SMS per status. |
| Sendr.10.Campaign.Status.SmsSimple | Simple SMS campaign report status |
| Sendr.10.Campaign.Status.SmsSurvey | Survey SMS campaign report status |
| Sendr.10.Campaign.Status.Voice.CallStatus | Voice campaign call statuses |
| Sendr.10.Campaign.Status.Voice.Keys | Voice campaign status per key pressed |
| Sendr.10.Campaign.Status.Voice.Retries | Voice campaign retries |
| Sendr.10.Campaign.Status.Voice.Retries.Causes | Voice campaign retries causes |
| Sendr.10.Campaign.Status.VoiceIvr | Voice IVR campaign status |
| Sendr.10.Campaign.Status.VoiceSimple | Simple Voice campaign status |
| Sendr.10.Campaign.Status.VoiceSimple.Broadcast | Simple Voice campaign report brodcast status info |
| Sendr.10.Campaign.Status.VoiceSurvey | Voice survey campaign status |
| Sendr.10.Campaign.TestCall | Test call |
| Sendr.10.Report | Sendr campaign report |
| Sendr.10.Report.SearchFilters | Search filters |
| SIP.Subscriber | SIP Subscriber |
| SIP.Subscriber.Options | SIP Subscriber Options |
| SIP.Subscriber.Properties | SIP Subscriber Properties |
| SIP.Subscriber.SearchFilters | SIP Subscriber Search filters |
| SIP.TrunkOrigination | SIP Trunk Origination |
| SIP.TrunkOrigination.Options | SIP Trunk Origination Options |
| SIP.TrunkOrigination.Properties | SIP Trunk Origination Properties |
| SIP.TrunkOrigination.SearchFilters | SIP Trunk Origination Search filters |
| SIP.TrunkTermination | SIP Trunk Termination |
| SIP.TrunkTermination.Options | SIP Trunk Termination Options |
| SIP.TrunkTermination.Properties | SIP Trunk Termination Properties |
| SIP.TrunkTermination.SearchFilters | SIP Trunk Termination Search filters |
| SMS | SMS text message |
| SMS.Options | The SMS.Options object defines the following properties. |
| SMS.Quote | Quote for a SMS |
| SMS.SearchFilters | Search filters |
| SubAccount | Sub Account |
| SubAccount.Account | Sub Account Account |
| SubAccount.Contact | Sub Account Contact |
| SubAccount.CreateOptions | Sub Account Creation Options |
| SubAccount.CreateOptions.Password | Sub Account Creation Options Password |
| SubAccount.CreateParams | Sub Account Params Creation |
| SubAccount.CreateParams.Billing | Sub Account Params Billing Creation |
| SubAccount.CreateProperties | Sub Account Creation Properties |
| SubAccount.Credentials | Sub Account Credentials |
| SubAccount.EditOptions | Sub Account Edition Options |
| SubAccount.EditParams | Sub Account Params Editable |
| SubAccount.EditParams.Billing | Sub Account Params Billing Editable |
| SubAccount.EditProperties | Sub Account Edition Properties |
| SubAccount.Params | Sub Account Params |
| SubAccount.Params.Billing | Sub Account Params Billing |
| SubAccount.Params.Default | Sub Account Params Default |
| SubAccount.Quota | Sub Account Quota |
| SubAccount.SearchFilters | Sub Account Search filters |
| SubAccount.State | Sub Account State |
| SubAccount.TransferOptions | Sub Account Tranfer Options |
| Target | Target (Phone number + timeout) |
| THEDIALR20 | Realtime App. Allows you to control the call in Real-Time. WARNING: DEPRECATED by REALTIME10. |
| Timezone | Timezone object |
| Web.Push | Object pushed to a your callback URL. Deprecated. See webhooks! |
| Webhook | Webhook object |
| Webhook.Event | Webhook event object |
| Webhook.Event.Billing.Credit | Webhook Credit event |
| Webhook.Log.Search.Filters | Webhook log search filters |
| Webhook.Options | Webhook options |
Postal Address
{
"city": "(string)",
"country": "FR",
"state": "(string)",
"street": "(string)",
"zip": "(string)"
}| Property | Type | Description |
|---|---|---|
| city | string |
The address city Format: address_city (City) |
| country | string |
The address country Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| state | string |
The address state Format: address_state (State) |
| street | string |
The address street name and number Format: address_street (Street name and number) |
| zip | string |
The address zip code Format: address_zip (ZIP Code) |
Analytics Calls by App
{
"aloc": 0,
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0,
"hash": "UNIQUEID"
}| Property | Type | Description |
|---|---|---|
| aloc | int | Average length of call |
| count | int | Calls count |
| credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| duration | int | Calls duration (answered) |
| hash | string |
App ID Format: hash (Unique object identifier) |
Analytics Calls by Country
{
"aloc": 0,
"count": 0,
"country_code": "FR",
"credit": "0.0000",
"debit": "0.0000",
"duration": 0
}| Property | Type | Description |
|---|---|---|
| aloc | int | Average length of call |
| count | int | Calls count |
| country_code | string |
Country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| duration | int | Calls duration (answered) |
Analytics Calls by Destination
{
"aloc": 0,
"billing_label": "(string)",
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0
}| Property | Type | Description |
|---|---|---|
| aloc | int | Average length of call |
| billing_label | string | Destination billing label |
| count | int | Calls count |
| credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| duration | int | Calls duration (answered) |
Analytics Calls by DID
{
"aloc": 0,
"billing_label": "(string)",
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0,
"hash": "UNIQUEID",
"intl": "+33612345678"
}| Property | Type | Description |
|---|---|---|
| aloc | int | Average length of call |
| billing_label | string | DID billing label |
| count | int | Calls count |
| credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| duration | int | Calls duration (answered) |
| hash | string |
DID ID Format: hash (Unique object identifier) |
| intl | string |
DID number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
Analytics History
{
"IN": [],
"OUT": []
}| Property | Type | Description |
|---|---|---|
| IN | array |
Inbound calls Array of objects: Analytics.Calls.History.Call |
| OUT | array |
Outbound calls Array of objects: Analytics.Calls.History.Call |
Analytics Calls History (date)
{
"aloc": 0,
"count": 0,
"credit": "0.0000",
"date": "2020-04-24 00:42:42",
"debit": "0.0000",
"duration": 0
}| Property | Type | Description |
|---|---|---|
| aloc | int | Average length of call |
| count | int | Calls count |
| credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| date | string |
Date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| duration | int | Calls duration (answered) |
Analytics (summary)
{
"IN": {},
"OUT": {}
}| Property | Type | Description |
|---|---|---|
| IN | object |
Inbound calls Object: Analytics.Calls.Summary.IN |
| OUT | object |
Outbound calls Object: Analytics.Calls.Summary.OUT |
Analytics Summary Calls IN
{
"aloc": 0,
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0,
"unique_callers": 0
}| Property | Type | Description |
|---|---|---|
| aloc | int | Average length of call |
| count | int | Calls count |
| credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| duration | int | Calls duration (answered) |
| unique_callers | int | Unique callers |
Analytics Summary Calls OUT
{
"aloc": 0,
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0
}| Property | Type | Description |
|---|---|---|
| aloc | int | Average length of call |
| count | int | Calls count |
| credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| duration | int | Calls duration (answered) |
SMS Analytics History
{
"IN": [],
"OUT": []
}| Property | Type | Description |
|---|---|---|
| IN | array | Inbound calls |
| OUT | array |
Outbound calls Array of objects: Analytics.SMS.History.OUT |
SMS Analytics Calls History (date)
{
"count": 0,
"credit": "0.0000",
"date": "2020-04-24 00:42:42",
"debit": "0.0000",
"parts": 0
}| Property | Type | Description |
|---|---|---|
| count | int | SMS count |
| credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| date | string |
Date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| parts | int | SMS parts (billed) |
SMS Analytics (summary)
{
"IN": {},
"OUT": {}
}| Property | Type | Description |
|---|---|---|
| IN | object | Inbound SMS |
| OUT | object |
Outbound SMS Object: Analytics.SMS.Summary.OUT |
SMS Analytics Summary SMS OUT
{
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"parts": 0
}| Property | Type | Description |
|---|---|---|
| count | int | SMS count |
| credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
| parts | int | SMS parts (billed) |
Voice App
{
"date_creation": "2020-04-24 00:42:42",
"date_update": "2020-04-24 00:42:42",
"did": [],
"hash": "UNIQUEID",
"name": "(string)",
"p": {},
"package": {}
}| Property | Type | Description |
|---|---|---|
| date_creation | string |
Date of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_update | string |
Date of last update Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| did | array |
DIDs assigned to the App Array of objects: DID |
| hash | string |
App ID Format: hash (Unique object identifier) |
| name | string | App name |
| p | object |
App parameters Objects: CALLTRACKING10, CLICKTOCALL10, REALTIME10 |
| package | object |
App package Object: App.Package |
Voice App Package
{
"has_did": true,
"name": "CALLTRACKING10",
"type": "THEDIALR"
}| Property | Type | Description |
|---|---|---|
| has_did | bool | Determines if the Voice App can be assigned a DID |
| name | string |
Package name Values: "CALLTRACKING10", "CLICKTOCALL10", "REALTIME10" |
| type | string |
Package type Values: "CALLTRACKING", "CLICKTOCALL", "THEDIALR" |
Voicemail
{
"active": true,
"email_template": "UNIQUEID",
"emails": [],
"file_format": "wav",
"file_name": "(string)",
"intro": 0,
"locale": "(string)",
"record": true,
"timeout": 0,
"timezone": "(string)"
}| Property | Type | Description |
|---|---|---|
| active | bool | If not activated, the call is hang up |
| email_template | string |
Email template Format: hash (Unique object identifier) |
| emails | array | Email recipients |
| file_format | string |
File attachment format Values: "mp3", "sln", "wav" |
| file_name | string |
File attachment name Format: vms_file_name (Voicemail Recording Attachement filename. Use these tags to name the file. Example: "{CALLID}-{MEDIA_HASH}" or "{DATETIME}-{CALLID}") |
| intro | int | Media prompt |
| locale | string |
Locale used for date/time formatting Format: locale (POSIX/IANA locale code. Example: "en_US" or "fr_FR".) |
| record | bool | if FALSE, the call is hang up after playing the prompt |
| timeout | int | Max recording length in seconds. Must be 30 <= x <= 300. |
| timezone | string |
Timezone IANA name Format: timezone_str (IANA timezone name. Example: "Europe/Paris".) |
Outbound Voicemail Detection
{
"active": true,
"dtmf_iterations": 0,
"dtmf_media": 0,
"dtmf_timeout": 0,
"method": "SILENCE",
"silence_iterations": 0,
"silence_media": 0,
"silence_ms": 0,
"silence_timeout": 0
}| Property | Type | Description |
|---|---|---|
| active | bool | Active ? |
| dtmf_iterations | int | When using the DTMF method, how many times do we try to have a DTMF ? (default: 2) |
| dtmf_media | int | When using the DTMF method, Media played before detection (default: 0) |
| dtmf_timeout | int | When using the DTMF method, how long do we wait for a DTMF to be sent ? (default: 2) |
| method | string |
Detection method Values: "DTMF", "SILENCE" |
| silence_iterations | int | When using the SILENCE method, how many times do we try ? (default: 1, min: 1, max: 30) |
| silence_media | int | When using the SILENCE method, Media played before detection (default: 0) |
| silence_ms | int | When using the SILENCE method, how long must be the silence in milliseconds ? (default: 1800, min: 50, max: 10000) |
| silence_timeout | int | When using the SILENCE method, how long do we try to detect silence ? (default: 3, min: 0, max: 120) |
Search filters
{
"name": "(string)"
}| Property | Type | Description |
|---|---|---|
| name | string | App name |
Api-Key
{
"created_at": "2020-04-24 00:42:42",
"last_used_at": "2020-04-24 00:42:42",
"name": "(string)",
"updated_at": "2020-04-24 00:42:42"
}| Property | Type | Description |
|---|---|---|
| created_at | string |
Date of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| last_used_at | string |
Date of last usage Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| name | string | Api-key name |
| updated_at | string |
Date of update Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Session Token
{
"refresh_token": "(string)",
"refreshable_until": "(string)",
"token": "(string)",
"valid_until": "(string)"
}| Property | Type | Description |
|---|---|---|
| refresh_token | string | Token for refreshing the current token |
| refreshable_until | string | Date until this token can be refreshed |
| token | string | Session token |
| valid_until | string | Date until this token is still valid |
Calls Broadcast (1) Options
{
"cdr_field": "(string)",
"cli": "(string)",
"direct_to_voicemail": true,
"loop": 0
}| Property | Type | Description |
|---|---|---|
| cdr_field | string |
Custom field written in the CDR Format: cdr_customer_field (32 alphanumeric characters maximum) |
| cli | string |
Calling Line Identification. Can be "BLOCKED", any DID you have on your account, or any phone number we have authorized on your account. Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
| direct_to_voicemail | bool | Leave voicemail without making the phone ring. Works only on mobile phones. |
| loop | int | Play messages in a loop! min=1 max=10 |
Call Tracking with call forwarding, prompts, and voicemail
{
"ga": {},
"medias": {},
"options": {},
"targets": [],
"vms": {}
}| Property | Type | Description |
|---|---|---|
| ga | object |
Google Analytics Object: CALLTRACKING10.GA |
| medias | object |
Medias Object: CALLTRACKING10.Medias |
| options | object |
Options Object: CALLTRACKING10.Options |
| targets | array |
Targets (Call forwarding) Array of objects: Target |
| vms | object |
Voicemail Object: App.Param.Vms |
CALLTRACKING10 Google Analytics
{
"ua": "(string)"
}| Property | Type | Description |
|---|---|---|
| ua | string | Google Analytics Web Property ID |
CALLTRACKING10 Medias
{
"bridge": 0,
"ringtone": 0,
"welcome": 0,
"whisper": 0
}| Property | Type | Description |
|---|---|---|
| bridge | int | Played to both parties before bridging the call |
| ringtone | int | Played while the target is ringing |
| welcome | int | Played immediately to the caller |
| whisper | int | Played to the target only (callee whispering) |
CALLTRACKING10 Options
{
"record_calls": true
}| Property | Type | Description |
|---|---|---|
| record_calls | bool | Activate call recording |
Inbound Call Detail Record (CDR)
{
"answer": "2020-04-24 00:42:42",
"billing_customer_cost_label": "(string)",
"billing_customer_credit_eur": "0.00",
"billing_customer_debit_eur": "0.00",
"callid": 0,
"cli_country_code": "FR",
"cli_name": "(string)",
"cli_number": "+33612345678",
"cli_number_type": "(string)",
"cli_pres": "allowed_passed_screen",
"customer_field": "(string)",
"did_hash": "UNIQUEID",
"did_intl_number": "+16469820800",
"duration": 0,
"duration_answered": 0,
"duration_billed": 0,
"hangup": "2020-04-24 00:42:42",
"hangupcause": 0,
"hangupsource": "CALLEE",
"package_name": "(string)",
"scenario_hash": "UNIQUEID",
"scenario_name": "(string)",
"start": "2020-04-24 00:42:42"
}| Property | Type | Description |
|---|---|---|
| answer | string |
Call answer date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| billing_customer_cost_label | string | Billing destination name |
| billing_customer_credit_eur | string |
Call credit (cents) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| billing_customer_debit_eur | string |
Call debit (cents) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| callid | int |
Unique call ID Format: callid (64-bit unsigned integer) |
| cli_country_code | string |
CLI country code if available Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| cli_name | string | CLI name if available |
| cli_number | string |
CLI number if available Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| cli_number_type | string | CLI number type if available |
| cli_pres | string |
CLI presentation Values: "allowed_passed_screen", "prohib_passed_screen" |
| customer_field | string |
Custom CDR field Format: cdr_customer_field (32 alphanumeric characters maximum) |
| did_hash | string |
DID unique ID Format: hash (Unique object identifier) |
| did_intl_number | string |
DID number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| duration | int | Call total duration in seconds |
| duration_answered | int | Call answered duration in seconds |
| duration_billed | int | Call billed duration in seconds |
| hangup | string |
Call hangup date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| hangupcause | int | ISDN cause code |
| hangupsource | string |
Hangup source Values: "CALLEE", "CALLER", "GATEWAY" |
| package_name | string | Package name |
| scenario_hash | string |
Voice app ID Format: hash (Unique object identifier) |
| scenario_name | string | Voice app name |
| start | string |
Call start date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Outbound Call Detail Record (CDR)
{
"answer": "2020-04-24 00:42:42",
"billing_customer_cost_label": "(string)",
"billing_customer_credit_eur": "0.00",
"billing_customer_debit_eur": "0.00",
"callid": 0,
"callid_in": 0,
"cli_name": "(string)",
"cli_number": "+447890123456",
"cli_pres": "allowed_passed_screen",
"customer_field": "(string)",
"dialstatus": "BUSY",
"duration": 0,
"duration_answered": 0,
"duration_billed": 0,
"hangup": "2020-04-24 00:42:42",
"hangupcause": 0,
"hangupsource": "GATEWAY",
"number": "+16469820800",
"number_country_code": "FR",
"number_type": "(string)",
"package_name": "(string)",
"scenario_hash": "UNIQUEID",
"scenario_name": "(string)",
"start": "2020-04-24 00:42:42"
}| Property | Type | Description |
|---|---|---|
| answer | string |
Call answer date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| billing_customer_cost_label | string | Billing destination name |
| billing_customer_credit_eur | string |
Call credit (cents) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| billing_customer_debit_eur | string |
Call debit (cents) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| callid | int |
Unique call ID Format: callid (64-bit unsigned integer) |
| callid_in | int |
Inbound call ID if available Format: callid (64-bit unsigned integer) |
| cli_name | string | CLI name if available |
| cli_number | string |
CLI number if available Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| cli_pres | string |
CLI presentation Values: "allowed_passed_screen", "prohib_passed_screen" |
| customer_field | string |
Custom CDR field Format: cdr_customer_field (32 alphanumeric characters maximum) |
| dialstatus | string |
Dial status Values: "ANSWER", "BUSY", "CANCEL", "CHANUNAVAIL", "CONGESTION", "NOANSWER", "NODIAL" |
| duration | int | Call total duration in seconds |
| duration_answered | int | Call answered duration in seconds |
| duration_billed | int | Call billed duration in seconds |
| hangup | string |
Call hangup date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| hangupcause | int | ISDN cause code |
| hangupsource | string |
Hangup source Values: "CALLEE", "CALLER", "GATEWAY" |
| number | string |
Outbound number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| number_country_code | string |
Number country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| number_type | string | Number type |
| package_name | string | Package name |
| scenario_hash | string |
Voice app ID Format: hash (Unique object identifier) |
| scenario_name | string | Voice app name |
| start | string |
Call start date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Search filters
{
"app": "UNIQUEID",
"did": "UNIQUEID",
"from": "2020-04-24 00:42:42",
"hash": "UNIQUEID",
"to": "2020-04-24 00:42:42",
"type": "OUT"
}| Property | Type | Description |
|---|---|---|
| app | string |
Voice App hash Format: hash (Unique object identifier) |
| did | string |
DID hash Format: hash (Unique object identifier) |
| from | string |
Retrieve from this date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| hash | string |
SMS Hash Format: hash (Unique object identifier) |
| to | string |
Retrieve until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| type | string |
CDR type. This property MUST be filled. Values: "IN", "OUT" |
Click-to-Call Call
{
"a_status": {},
"a_targets": [],
"app": {},
"b_status": {},
"b_targets": [],
"cdr_field": "(string)",
"cli": "(string)",
"date_creation": "2020-04-24 00:42:42",
"date_scheduled": "2020-04-24 00:42:42",
"date_started": "2020-04-24 00:42:42",
"date_update": "2020-04-24 00:42:42",
"hash": "(string)"
}| Property | Type | Description |
|---|---|---|
| a_status | object |
Party A call status Object: CLICKTOCALL.Call.Status |
| a_targets | array |
Targets called first ("A") Array of objects: Target |
| app | object |
Voice App Object: App |
| b_status | object |
Party B call status Object: CLICKTOCALL.Call.Status |
| b_targets | array |
Targets called second ("B") Array of objects: Target |
| cdr_field | string |
Custom CDR field Format: cdr_customer_field (32 alphanumeric characters maximum) |
| cli | string |
CLI presented to party A. Party B will see the party A target number that answered the call Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
| date_creation | string |
Date and time of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_scheduled | string |
Date and time scheduled Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_started | string |
Date and time started Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_update | string |
Date and time of last update Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| hash | string | Call identifier |
Click-to-Call Call Status
{
"callid": 0,
"number": "+447890123456",
"status": "ANSWER",
"try": 0
}| Property | Type | Description |
|---|---|---|
| callid | int |
Call Unique ID (CDR) Format: callid (64-bit unsigned integer) |
| number | string |
The number dialing or answered Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| status | string |
Call status Values: "ABORTED", "ANSWER", "DIALING", "HANGUP", "NOANSWER", "VOICEMAIL_DETECTED" |
| try | int | Call try |
Click-to-Call Start Options
{
"cdr_field": "(string)",
"cli": "(string)",
"schedule": "(string)"
}| Property | Type | Description |
|---|---|---|
| cdr_field | string |
Custom CDR field Format: cdr_customer_field (32 alphanumeric characters maximum) |
| cli | string |
CLI used to call A Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
| schedule | string | Schedule the call in the future. Set any date in the past to start the call immediately |
Click-to-Call with dynamic A/B parties
{
"medias": {},
"options": {},
"vms": {}
}| Property | Type | Description |
|---|---|---|
| medias | object |
Medias Object: CLICKTOCALL10.Medias |
| options | object |
Options Object: CLICKTOCALL10.Options |
| vms | object |
Voicemail for A if B does not answer Object: App.Param.Vms |
CLICKTOCALL10 Medias
{
"A_ringtone": 0,
"A_welcome": 0,
"AB_bridge": 0,
"B_whisper": 0
}| Property | Type | Description |
|---|---|---|
| A_ringtone | int | Played to A while calling B |
| A_welcome | int | Played to A immediately |
| AB_bridge | int | Played to both parties before bridging the call |
| B_whisper | int | Played to B only (A still hears the ringtone) |
CLICKTOCALL10 Options
{
"A_attempts": 0,
"A_retrypause": 0,
"A_vms_detect": {},
"B_vms_detect": {},
"record_calls": true
}| Property | Type | Description |
|---|---|---|
| A_attempts | int | Call attempts. Must be between 1 and 5 |
| A_retrypause | int | Pause between attempts. Must be between 30 and 300 |
| A_vms_detect | object |
Outbound voicemail detection on A Object: App.Param.VmsDetect |
| B_vms_detect | object |
Outbound voicemail detection on B Object: App.Param.VmsDetect |
| record_calls | bool | Active call recording |
Conference Voice App
{
"hook": {},
"limits": {},
"media": {},
"open": true,
"recording": "OFF"
}| Property | Type | Description |
|---|---|---|
| hook | object |
Push hook (push) Object: Push.Hook.URL |
| limits | object |
Limits Object: CONFERENCE10.Limits |
| media | object |
Media Object: CONFERENCE10.Media |
| open | bool | Is the room open? When closed, no one can enter the room. |
| recording | string |
Call recording Values: "AUTO", "MANUAL", "OFF" |
Options when calling a number
{
"date_expiration": "(string)",
"label": "(string)",
"level": "ADMIN",
"max_duration": 0
}| Property | Type | Description |
|---|---|---|
| date_expiration | string | Expiration date |
| label | string | Label |
| level | string |
Level Values: "ADMIN", "GUEST" |
| max_duration | int | Maximum duration |
Connected participant
{
"date_connection": "(string)",
"did_hash": "UNIQUEID",
"direction": "IN",
"duration": "(string)",
"hash": "UNIQUEID",
"location_city": "(string)",
"location_country": "FR",
"muted": true,
"paused": true,
"phone_number": "+16469820800",
"room_access_hash": "UNIQUEID",
"room_access_label": "(string)",
"room_access_level": "GUEST",
"room_hash": "UNIQUEID",
"status": "DISCONNECTING"
}| Property | Type | Description |
|---|---|---|
| date_connection | string | Date of connection |
| did_hash | string |
DID ID (if inbound call) Format: hash (Unique object identifier) |
| direction | string |
Call direction Values: "IN", "OUT" |
| duration | string | Duration since connected in seconds |
| hash | string |
Connected ID Format: hash (Unique object identifier) |
| location_city | string | Connected location (city or area). May not be available. |
| location_country | string |
Connected location (country code) Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| muted | bool | Is the connected muted? |
| paused | bool | Is the connected paused? |
| phone_number | string |
Phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| room_access_hash | string |
Room Access ID used to enter the room Format: hash (Unique object identifier) |
| room_access_label | string | Room Access Label |
| room_access_level | string |
Room Access Level Values: "ADMIN", "GUEST" |
| room_hash | string |
Room ID Format: hash (Unique object identifier) |
| status | string |
Status Values: "CONNECTED", "CONNECTING", "DISCONNECTED", "DISCONNECTING" |
Previously connected participant
{
"date_connection": "(string)",
"did_hash": "UNIQUEID",
"direction": "OUT",
"duration": "(string)",
"hash": "UNIQUEID",
"last_status": "CONNECTED",
"location_city": "(string)",
"location_country": "FR",
"muted": true,
"paused": true,
"phone_number": "+16469820800",
"room_access_hash": "UNIQUEID",
"room_access_label": "(string)",
"room_access_level": "GUEST",
"room_hash": "UNIQUEID"
}| Property | Type | Description |
|---|---|---|
| date_connection | string | Date of connection |
| did_hash | string |
DID ID (if inbound call) Format: hash (Unique object identifier) |
| direction | string |
Call direction Values: "IN", "OUT" |
| duration | string | Connected duration in seconds |
| hash | string |
Connected ID Format: hash (Unique object identifier) |
| last_status | string |
Last status before disconnection Values: "CONNECTED", "CONNECTING", "DISCONNECTED", "DISCONNECTING" |
| location_city | string | Connected location (city or area). May not be available. |
| location_country | string |
Connected location (country code) Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| muted | bool | Was the connected muted? |
| paused | bool | Was the connected paused? |
| phone_number | string |
Phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| room_access_hash | string |
Room Access ID used to enter the room Format: hash (Unique object identifier) |
| room_access_label | string | Room Access Label |
| room_access_level | string |
Room Access Level Values: "ADMIN", "GUEST" |
| room_hash | string |
Room ID Format: hash (Unique object identifier) |
Connections History listing filters. Each property is facultative. Set it to apply a filter.
{
"action": "PAUSE",
"connected_hash": "UNIQUEID",
"room_access_hash": "UNIQUEID",
"room_hash": "UNIQUEID"
}| Property | Type | Description |
|---|---|---|
| action | string |
Filter on Event Action Values: "ENTER_ROOM", "HANGUP", "INBOUND_CALL", "LEAVE_ROOM", "MUTE", "OUTBOUND_CALL", "OUTBOUND_CALL_STATUS", "PAUSE", "UNMUTE", "UNPAUSE" |
| connected_hash | string |
Filter on specific Connected ID Format: hash (Unique object identifier) |
| room_access_hash | string |
Filter a Room Access ID Format: hash (Unique object identifier) |
| room_hash | string |
Filter on Room ID Format: hash (Unique object identifier) |
Connections History listing result object
{
"items": [],
"total": 0,
"total_items": 0
}| Property | Type | Description |
|---|---|---|
| items | array |
Results Array of objects: CONFERENCE10.Connected.History |
| total | int | Total available (without filters) |
| total_items | int | Total returned (filtered) |
Room Event
{
"action": "ENTER_ROOM",
"connected_count": 0,
"connected_hash": "(string)",
"data": {},
"date": "2020-04-24 00:42:42",
"from": "PHONE",
"room_access_hash": "(string)",
"room_access_label": "(string)"
}| Property | Type | Description |
|---|---|---|
| action | string |
Action. Values: "ENTER_ROOM", "HANGUP", "INBOUND_CALL", "LEAVE_ROOM", "MUTE", "OUTBOUND_CALL", "OUTBOUND_CALL_STATUS", "PAUSE", "UNMUTE", "UNPAUSE" |
| connected_count | int | Number of connected in the room when the event is generated |
| connected_hash | string | Connected ID (when applies) |
| data | object | Event data. |
| date | string |
Date/time of event Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| from | string |
Where did the event originated from? Values: "PHONE", "WEB" |
| room_access_hash | string | Connected Room Access ID (when applies) |
| room_access_label | string | Connected Room Access Label (when applies) |
Events listing filters. Each property is facultative. Set it to apply a filter.
{
"action": "ENTER_ROOM",
"connected_hash": "UNIQUEID",
"room_access_hash": "UNIQUEID",
"room_hash": "UNIQUEID"
}| Property | Type | Description |
|---|---|---|
| action | string |
Filter on Event Action Values: "ENTER_ROOM", "HANGUP", "INBOUND_CALL", "LEAVE_ROOM", "MUTE", "OUTBOUND_CALL", "OUTBOUND_CALL_STATUS", "PAUSE", "UNMUTE", "UNPAUSE" |
| connected_hash | string |
Filter on specific Connected ID Format: hash (Unique object identifier) |
| room_access_hash | string |
Filter a Room Access ID Format: hash (Unique object identifier) |
| room_hash | string |
Filter on Room ID Format: hash (Unique object identifier) |
Events listing result object
{
"items": [],
"total": 0,
"total_items": 0
}| Property | Type | Description |
|---|---|---|
| items | array |
Results Array of objects: CONFERENCE10.Event |
| total | int | Total available (without filters) |
| total_items | int | Total returned (filtered) |
Limits for CONFERENCE10
{
"date_expiration": "2020-04-24 00:42:42",
"max_connected": 0,
"max_duration": 0
}| Property | Type | Description |
|---|---|---|
| date_expiration | string |
Conference expiration date and time. . Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| max_connected | int | Maximum number of connected (simultaneously). Use 0 to disable. |
| max_duration | int | Maximum conference duration in seconds. When reached, the "$max_duration_reached" media is played and participants are hang up. Use 0 to disable. |
Media for CONFERENCE10
{
"alone": 0,
"bridge": 0,
"max_duration_reached": 0,
"out_confirm": 0,
"out_welcome": 0,
"pin_ask": 0,
"pin_invalid": 0,
"welcome": 0
}| Property | Type | Description |
|---|---|---|
| alone | int | Played to the participant if he's the first one |
| bridge | int | Played right before entering the conference |
| max_duration_reached | int | Played at the end of the conference if the max_duration is reached |
| out_confirm | int | Played to the callee (outbound call) to confirm the call. Useful to detect voicemail. |
| out_welcome | int | Played to the callee (outbound call) after optional '$out_confirm' |
| pin_ask | int | Ask to input the pin code |
| pin_invalid | int | Played when the pin code is not valid |
| welcome | int | Played immediately to the participant (inbound call) |
Conference Room (version 10)
{
"a": [],
"date_creation": "2020-04-24 00:42:42",
"date_update": "2020-04-24 00:42:42",
"did": [],
"hash": "UNIQUEID",
"name": "(string)",
"p": {}
}| Property | Type | Description |
|---|---|---|
| a | array |
Room access Array of objects: CONFERENCE10.Room.Access |
| date_creation | string |
Date of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_update | string |
Date of last update Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| did | array |
DIDs assigned to the Room Array of objects: DID |
| hash | string |
Room ID Format: hash (Unique object identifier) |
| name | string | Room name |
| p | object |
Room parameters Object: CONFERENCE10 |
Room Access for CONFERENCE10.
{
"date_creation": "2020-04-24 00:42:42",
"date_expiration": "2020-04-24 00:42:42",
"date_update": "2020-04-24 00:42:42",
"did_hash": "UNIQUEID",
"hash": "UNIQUEID",
"label": "(string)",
"level": "GUEST",
"max_duration": 0,
"phone_number": "+447890123456",
"pin": "(string)",
"room_hash": "UNIQUEID"
}| Property | Type | Description |
|---|---|---|
| date_creation | string |
Creation date/time. Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_expiration | string |
Expiration date/time for this access. Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_update | string |
Update date/time. Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| did_hash | string |
DID ID. If != 0, the access will only apply to the specific DID. Format: hash (Unique object identifier) |
| hash | string |
ID Format: hash (Unique object identifier) |
| label | string | Label |
| level | string |
Level. ADMIN users can enter a room even when it's full. Values: "ADMIN", "GUEST" |
| max_duration | int | Maximum call duration for this access. |
| phone_number | string |
Phone number used for outbound calls, and matched against the CLI for inbound calls. Use this field to assign an access to a specific phone number. Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| pin | string | PIN code. Digits only. If empty, no PIN will be asked. Maximum length = 8 digits. |
| room_hash | string |
Room ID. Format: hash (Unique object identifier) |
Conference Room (live) (version 10)
{
"connected": [],
"hash": "UNIQUEID",
"name": "(string)",
"open": true,
"recording": true
}| Property | Type | Description |
|---|---|---|
| connected | array |
Array of currently connected participants Array of objects: CONFERENCE10.Connected |
| hash | string |
Room ID Format: hash (Unique object identifier) |
| name | string | Room name |
| open | bool | Is the room open? |
| recording | bool | Is recording on? |
Country object
{
"capital_code": "(string)",
"continent_code": "(string)",
"country_code": "FR",
"country_dialcode": "(string)",
"country_en_label": "(string)",
"country_fr_label": "(string)",
"country_label": "(string)",
"country_languages": "(string)",
"country_latitude": "(string)",
"country_localcode": "(string)",
"country_longitude": "(string)",
"country_neighbours": "FR",
"country_number_length": "(string)",
"country_tld": "(string)",
"currency_code": "(string)"
}| Property | Type | Description |
|---|---|---|
| capital_code | string | Country's Capital 3-letter code |
| continent_code | string | Country's Continent 3-letter code |
| country_code | string |
Country's Code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| country_dialcode | string | Country's E.164 Dialcode |
| country_en_label | string | Country name (uppercase) in English |
| country_fr_label | string | Country name (uppercase) in French |
| country_label | string | Country name (lowercase) in English |
| country_languages | string | Country's Languages |
| country_latitude | string | Country's Latitude |
| country_localcode | string | Country's Local code |
| country_longitude | string | Country's Longitude |
| country_neighbours | string |
Country's Neighbours comma separated Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| country_number_length | string | Country's Phone Numbers Length |
| country_tld | string | Country's Top Level Domain (TLD) |
| currency_code | string | Country's Currency |
Authorized Customer CLI
{
"cli": "(string)",
"comment": "(string)",
"label": "(string)"
}| Property | Type | Description |
|---|---|---|
| cli | string | Phone number/SMS Sender authorized |
| comment | string | Custom comment |
| label | string | Custom label |
DID (Phone Number)
{
"app": "UNIQUEID",
"class": "CLASSIC",
"country_code": "FR",
"hash": "UNIQUEID",
"intl_number": "+16469820800",
"local_number": "(string)",
"local_number_f": "(string)",
"type": "PERSONAL"
}| Property | Type | Description |
|---|---|---|
| app | string |
Voice App ID assigned to the DID, NULL otherwise Format: hash (Unique object identifier) |
| class | string |
DID class Values: "CLASSIC", "GOLD" |
| country_code | string |
DID country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| hash | string |
DID ID Format: hash (Unique object identifier) |
| intl_number | string |
Phone number in international format Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| local_number | string | Phone number in local format |
| local_number_f | string | Phone number in local format, formatted |
| type | string |
DID type Values: "GEOGRAPHIC", "MOBILE", "NON-GEOGRAPHIC", "PERSONAL", "SHAREDREVENUE", "SMS-ONLY", "SPECIAL", "TOLLFREE" |
Area code
{
"available": {},
"country_code": "FR",
"id": 0,
"intl_prefix": "(string)",
"label": "(string)",
"local_prefix": "(string)",
"type": "MOBILE"
}| Property | Type | Description |
|---|---|---|
| available | object |
DID availability in the store for this area code Object: DID.Store.Availability |
| country_code | string |
Country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| id | int | Area code ID |
| intl_prefix | string | Area code international prefix |
| label | string | Area code name (english) |
| local_prefix | string | Area code local prefix |
| type | string |
DID type of this area code Values: "GEOGRAPHIC", "MOBILE", "NON-GEOGRAPHIC", "PERSONAL", "SHAREDREVENUE", "SMS-ONLY", "SPECIAL", "TOLLFREE" |
DID Country
{
"available": {},
"code": "FR",
"label": "(string)"
}| Property | Type | Description |
|---|---|---|
| available | object |
DID availability in the store for this country Object: DID.Store.Availability |
| code | string |
Country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| label | string | Country name (english) |
DID Search filters
{
"class": "GOLD",
"hash": "UNIQUEID",
"type": "GEOGRAPHIC"
}| Property | Type | Description |
|---|---|---|
| class | string |
DID class Values: "CLASSIC", "GOLD" |
| hash | string |
DID ID Format: hash (Unique object identifier) |
| type | string |
DID type Values: "GEOGRAPHIC", "MOBILE", "NON-GEOGRAPHIC", "PERSONAL", "SHAREDREVENUE", "SMS-ONLY", "SPECIAL", "TOLLFREE" |
DID Availability
{
"CLASSIC": true,
"GOLD": true
}| Property | Type | Description |
|---|---|---|
| CLASSIC | bool | TRUE if at least one CLASSIC DID is available |
| GOLD | bool | TRUE if at least one GOLD DID is available |
DID Buy Status
{
"contract": {},
"cost": {},
"errors": [],
"success": []
}| Property | Type | Description |
|---|---|---|
| contract | object |
Subscription contract Object: DID.Store.Contract |
| cost | object |
DIDs cost Object: DID.Store.Cost |
| errors | array |
DIDs reserved but not bought Array of objects: DID.Store.Error |
| success | array |
DIDs successfully bought. Array of objects: DID.Store.Item |
DID Reservation Contract
{
"billing_mode": "POSTPAID",
"duration_month": 0,
"end_date": "2020-04-24 00:42:42"
}| Property | Type | Description |
|---|---|---|
| billing_mode | string |
Billing mode when buying DIDs. Values: "POSTPAID", "PREPAID" |
| duration_month | int | Contract duration in month |
| end_date | string |
Contract end date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
DID Reservation Cost
{
"amount_per_month": "0.00",
"amount_prepaid_debit": "0.00",
"amount_unit": "0.00",
"discount_percent": 0,
"quantity": 0,
"quantity_paying": 0
}| Property | Type | Description |
|---|---|---|
| amount_per_month | string |
DIDs cost (monthly) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| amount_prepaid_debit | string |
Amount that will be debited from your prepaid credit (if your account is PREPAID). Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| amount_unit | string |
Cost per DID Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| discount_percent | int | Discount (percentage) applied to your order |
| quantity | int | Number of DIDs reserved |
| quantity_paying | int | Number of DIDs you will be paying (some contract have free DIDs included) |
DID Store Error
{
"code": 0,
"DID": {},
"message": "(string)"
}| Property | Type | Description |
|---|---|---|
| code | int | Error code |
| DID | object |
DID with error Object: DID.Store.Item |
| message | string | Error message |
DID Item (phone number) in Store
{
"hash": "UNIQUEID",
"intl_number": "(string)",
"local_number": "(string)"
}| Property | Type | Description |
|---|---|---|
| hash | string |
DID ID Format: hash (Unique object identifier) |
| intl_number | string | Phone number (international) |
| local_number | string | Phone number (national) |
DID Store Quota Status
{
"assigned_count": 0,
"assigned_max": 0,
"quota_current_count": 0,
"quota_current_remaining": 0,
"quota_max_over_period": 0,
"quota_period_days": 0
}| Property | Type | Description |
|---|---|---|
| assigned_count | int | Current number of DIDs assigned |
| assigned_max | int | Max number of DIDs that can be assigned to your account, "-1" if unlimited. |
| quota_current_count | int | Current number of DIDs you bought in "$quota_period_days" days. |
| quota_current_remaining | int | Max number of DIDs you can buy given you previous orders, "-1" if unlimited. |
| quota_max_over_period | int | Max number of DIDs you can buy over "$quota_period_days" days, "-1" if unlimited. |
| quota_period_days | int | Quota period in days. |
DID Quote
{
"available": 0,
"contract": {},
"cost": {}
}| Property | Type | Description |
|---|---|---|
| available | int | Number of DIDs available based on your request |
| contract | object |
Subscription contract Object: DID.Store.Contract |
| cost | object |
DIDs cost Object: DID.Store.Cost |
DID Reservation Status
{
"contract": {},
"cost": {},
"expire": "2020-04-24 00:42:42",
"items": [],
"token": "(string)"
}| Property | Type | Description |
|---|---|---|
| contract | object |
Subscription contract Object: DID.Store.Contract |
| cost | object |
DIDs cost Object: DID.Store.Cost |
| expire | string |
Token expiration date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| items | array |
DIDs reserved. Array of objects: DID.Store.Item |
| token | string | Order token |
DID type
{
"available": {},
"code": "SMS-ONLY",
"label": "(string)"
}| Property | Type | Description |
|---|---|---|
| available | object |
DID availability in the store for this type Object: DID.Store.Availability |
| code | string |
DID type code Values: "GEOGRAPHIC", "MOBILE", "NON-GEOGRAPHIC", "PERSONAL", "SHAREDREVENUE", "SMS-ONLY", "SPECIAL", "TOLLFREE" |
| label | string | DID type label |
HRL response
{
"mcc": "(string)",
"mnc": "(string)",
"state": "FAILURE"
}| Property | Type | Description |
|---|---|---|
| mcc | string | Mobile Country Code |
| mnc | string | Mobile Network Code |
| state | string |
State Values: "FAILURE", "SUCCESS" |
Job object
{
"done_at": "2020-04-24 00:42:42",
"error": {},
"id": "(string)",
"percent": "(string)",
"result": {},
"status": "(string)"
}| Property | Type | Description |
|---|---|---|
| done_at | string |
Date and time of the process end Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| error | object | Error object if process failed. NULL if no error occurred. |
| id | string |
Unique ID Format: hid (Unique object identifier) |
| percent | string | Percentage of completion of the job. E.g.: "98.90", "100.00" |
| result | object | Object containing the result of the process when done |
| status | string | Status of the job. Can be one of : PENDING, RUNNING, CANCELED, DONE. |
Email template object
{
"hash": "UNIQUEID",
"name": "(string)",
"type": "VMS"
}| Property | Type | Description |
|---|---|---|
| hash | string |
Template ID Format: hash (Unique object identifier) |
| name | string | Template name |
| type | string |
Template type Values: "RECORD", "VMS" |
Media.Library object
{
"category": [],
"content": "(string)",
"duration": 0,
"hash": "UNIQUEID",
"id": 0,
"is_editable": true,
"language": [],
"name": "(string)",
"status": "READY",
"tags": {},
"url": "(string)",
"voice": "TTS_EN-GB_SERENA"
}| Property | Type | Description |
|---|---|---|
| category | array | Media categories (string) |
| content | string | Media text content if provided |
| duration | int | Media duration |
| hash | string |
Media Hash ID Format: hash (Unique object identifier) |
| id | int | Media ID |
| is_editable | bool | Is the media editable ? |
| language | array |
Media languages Format: locale (POSIX/IANA locale code. Example: "en_US" or "fr_FR".) |
| name | string | Media name |
| status | string |
Media status Values: "ERROR", "PENDING_CONTENT", "PENDING_CONVERSION", "PROCESSING", "READY" |
| tags | object | Dictionary (key/value) of tags. Key is the tag key (string). Value in an array of string (tag values). |
| url | string | Media MP3 URL |
| voice | string |
Text-to-Speech Voice ID Values: "TTS_DE-DE_ANNA", "TTS_DE-DE_YANNICK", "TTS_EN-GB_DANIEL", "TTS_EN-GB_SERENA", "TTS_FR-FR_AUDREY", "TTS_FR-FR_SEBASTIEN", "TTS_FR-FR_THOMAS", "TTS_FR-FR_VIRGINIE", "TTS_IT-IT_PAOLO", "TTS_IT-IT_SILVIA", "TTS_NL-BE_ELLEN", "TTS_NL-NL_CLAIRE", "TTS_NL-NL_XANDER" |
Library overview
{
"count": {},
"ready": {}
}| Property | Type | Description |
|---|---|---|
| count | object |
Quantities by status Object: Media.Library.Overview.Count |
| ready | object |
Quantity and total size of READY media Object: Media.Library.Overview.Ready |
Library overview (count)
{
"ERROR": 0,
"PROCESSING": 0,
"READY": 0
}| Property | Type | Description |
|---|---|---|
| ERROR | int | Quantity of ERROR media |
| PROCESSING | int | Quantity of PROCESSING media |
| READY | int | Quantity of READY media |
Library overview (ready)
{
"count": 0,
"size": 0
}| Property | Type | Description |
|---|---|---|
| count | int | Quantity of READY media |
| size | int | Total size of READY media (in bytes) |
Phone ID (DTMF sequence + phone number)
{
"code": "(string)",
"number": "+33612345678"
}| Property | Type | Description |
|---|---|---|
| code | string | DTMF sequence |
| number | string |
Phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
Media quota
{
"count": {},
"quota": {},
"status": {}
}| Property | Type | Description |
|---|---|---|
| count | object |
The quantity of media your have Object: Media.Quota.Count |
| quota | object |
The quota you have bought Object: Media.Quota.Quota |
| status | object |
Where you stand with your quota Object: Media.Quota.Status |
Media quota (count)
{
"library": 0,
"recording": 0
}| Property | Type | Description |
|---|---|---|
| library | int | Quantity of Library media |
| recording | int | Quantity of Recordings media |
Media quota (quota)
{
"free": 0,
"paid": 0,
"unit": "(string)"
}| Property | Type | Description |
|---|---|---|
| free | int | Free storage (GB) |
| paid | int | Paid storage (GB) |
| unit | string | Storage unit (always "GB") |
Media quota (status)
{
"unit": "(string)",
"unused": "(string)",
"used": "(string)",
"used_by_library": "(string)",
"used_by_recording": "(string)"
}| Property | Type | Description |
|---|---|---|
| unit | string | Storage unit ("B","KB","MB","GB", etc.) |
| unused | string | Storage unused |
| used | string | Storage used (total) |
| used_by_library | string | Storage used by library |
| used_by_recording | string | Storage used by recordings |
Media Recording
{
"app_hash": "UNIQUEID",
"app_name": "(string)",
"callid": 0,
"cli_name": "(string)",
"cli_number": "+447890123456",
"date": "2020-04-24 00:42:42",
"date_read": "2020-04-24 00:42:42",
"did_hash": "UNIQUEID",
"did_intl_number": "+16469820800",
"did_local_number": "(string)",
"duration": 0,
"file_size_total": 0,
"hash": "UNIQUEID",
"options": {},
"read": true,
"status": "PROCESSING",
"type": "CALL",
"url": "(string)",
"url_exts": []
}| Property | Type | Description |
|---|---|---|
| app_hash | string |
App ID Format: hash (Unique object identifier) |
| app_name | string | App name |
| callid | int |
Call ID (CDR) Format: callid (64-bit unsigned integer) |
| cli_name | string | Caller ID (name) |
| cli_number | string |
Caller ID (number) Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| date | string |
Date and time of the recording Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_read | string |
Date and time when the recording was read Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| did_hash | string |
DID ID (if the recording is linked to a DID) Format: hash (Unique object identifier) |
| did_intl_number | string |
DID number (international format) (if the recording is linked to a DID) Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| did_local_number | string | DID number (national format) (if the recording is linked to a DID) |
| duration | int | Recording duration (seconds) |
| file_size_total | int | File size in bytes |
| hash | string |
Recording ID Format: hash (Unique object identifier) |
| options | object |
Recording Options Object: Media.Recording.Options |
| read | bool | Read status |
| status | string |
Status Values: "ERROR", "PENDING", "PROCESSING", "READY", "RECORDING" |
| type | string |
Recording types Values: "CALL", "CONFERENCE", "RECORDING", "VOICEMAIL" |
| url | string | URL of the recording without the extension |
| url_exts | array | Array of available extensions (ususally "mp3") |
Recording Action Result
{
"errors": [],
"success": 0
}| Property | Type | Description |
|---|---|---|
| errors | array |
Array of Recordings (action failed) Array of objects: Media.Recording.ActionResult.Error |
| success | int | Quantity of successful actions |
Recording Action Result (error)
{
"code": 0,
"hash": "UNIQUEID",
"message": "(string)"
}| Property | Type | Description |
|---|---|---|
| code | int | Error Code |
| hash | string |
Recording ID Format: hash (Unique object identifier) |
| message | string | Error message |
Recording List Result
{
"items": [],
"total_items": 0
}| Property | Type | Description |
|---|---|---|
| items | array |
Recordings Array of objects: Media.Recording |
| total_items | int | Number of items |
The Media.Recording.Options object defines the following properties.
{
"webhook": {}
}| Property | Type | Description |
|---|---|---|
| webhook | object |
Dynamic webhook for this Media Recording. Status updates will be set to this specific webhook (and also to your "media.recording.new" and "media.recording.status_update" subscriptions). You only need to set 'endpoint' and optionally 'options'. Object: Webhook |
Recording overview
{
"CALL": {},
"CONFERENCE": {},
"RECORDING": {},
"VOICEMAIL": {}
}| Property | Type | Description |
|---|---|---|
| CALL | object |
Media of type CALL Object: Media.Recording.Overview.Status |
| CONFERENCE | object |
Media of type CONFERENCE Object: Media.Recording.Overview.Status |
| RECORDING | object |
Media of type RECORDING Object: Media.Recording.Overview.Status |
| VOICEMAIL | object |
Media of type VOICEMAIL Object: Media.Recording.Overview.Status |
Recording overview (status)
{
"count": {},
"ready": {}
}| Property | Type | Description |
|---|---|---|
| count | object |
Quantities by status Object: Media.Recording.Overview.Status.Count |
| ready | object |
Quantity and total size of READY media Object: Media.Recording.Overview.Status.Ready |
Recording overview (count)
{
"ERROR": 0,
"PROCESSING": 0,
"READY": 0,
"RECORDING": 0
}| Property | Type | Description |
|---|---|---|
| ERROR | int | Quantity of ERROR media |
| PROCESSING | int | Quantity of PROCESSING media |
| READY | int | Quantity of READY media |
| RECORDING | int | Quantity of RECORDING media |
Recording overview (ready)
{
"count": 0,
"read": 0,
"size": 0,
"unread": 0
}| Property | Type | Description |
|---|---|---|
| count | int | Quantity of READY media |
| read | int | Quantity of READY media (read) |
| size | int | Total size of READY media (in bytes) |
| unread | int | Quantity of READY media (unread) |
Recording read status
{
"CALL": {},
"CONFERENCE": {},
"RECORDING": {},
"VOICEMAIL": {}
}| Property | Type | Description |
|---|---|---|
| CALL | object |
Media of type CALL Object: Media.Recording.ReadStatus.Status |
| CONFERENCE | object |
Media of type CONFERENCE Object: Media.Recording.ReadStatus.Status |
| RECORDING | object |
Media of type RECORDING Object: Media.Recording.ReadStatus.Status |
| VOICEMAIL | object |
Media of type VOICEMAIL Object: Media.Recording.ReadStatus.Status |
Recording read status (status)
{
"count": 0,
"read": 0,
"unread": 0
}| Property | Type | Description |
|---|---|---|
| count | int | Quantity of media |
| read | int | Quantity of media (read) |
| unread | int | Quantity of media (unread) |
Search filters
{
"callid": 0,
"cli_number": "+16469820800",
"created_at_from": "2020-04-24 00:42:42",
"created_at_to": "2020-04-24 00:42:42",
"hash": "UNIQUEID",
"read": true,
"read_at_from": "2020-04-24 00:42:42",
"read_at_to": "2020-04-24 00:42:42",
"status": "RECORDING",
"type": "VOICEMAIL"
}| Property | Type | Description |
|---|---|---|
| callid | int |
Call ID (from CDR) Format: callid (64-bit unsigned integer) |
| cli_number | string |
Caller ID (number) Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| created_at_from | string |
Retrieve media recorded from this date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| created_at_to | string |
Retrieve media recorded until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| hash | string |
Media Hash Format: hash (Unique object identifier) |
| read | bool | Wether or not the media has been read |
| read_at_from | string |
Retrieve media read from this date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| read_at_to | string |
Retrieve media read until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| status | string |
Media status Values: "ERROR", "PENDING", "PROCESSING", "READY", "RECORDING" |
| type | string |
Type of recording Values: "CALL", "CONFERENCE", "RECORDING", "VOICEMAIL" |
Search filters
{
"category": "FAILURE",
"created_at_from": "2020-04-24 00:42:42",
"created_at_to": "2020-04-24 00:42:42",
"hash": "UNIQUEID",
"id": 0,
"language": [],
"name": "(string)",
"status": "PENDING_CONVERSION",
"tags_type": "(string)",
"tags_value": "(string)",
"voice": "TTS_EN-GB_SERENA"
}| Property | Type | Description |
|---|---|---|
| category | string |
Media category Values: "FAILURE", "IVR", "MISC", "RINGTONE", "VOICEMAIL", "WELCOME", "WHISPER" |
| created_at_from | string |
Retrieve from this date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| created_at_to | string |
Retrieve until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| hash | string |
Media Hash Format: hash (Unique object identifier) |
| id | int | Media ID |
| language | array |
Media languages Format: locale (POSIX/IANA locale code. Example: "en_US" or "fr_FR".) |
| name | string | Name |
| status | string |
Media status Values: "ERROR", "PENDING_CONTENT", "PENDING_CONVERSION", "PROCESSING", "READY" |
| tags_type | string | Media tag type, key used when calling media/library.set_tags |
| tags_value | string | Media tag value, value used when calling media/library.set_tags |
| voice | string |
Text-to-Speech Voice ID Values: "TTS_DE-DE_ANNA", "TTS_DE-DE_YANNICK", "TTS_EN-GB_DANIEL", "TTS_EN-GB_SERENA", "TTS_FR-FR_AUDREY", "TTS_FR-FR_SEBASTIEN", "TTS_FR-FR_THOMAS", "TTS_FR-FR_VIRGINIE", "TTS_IT-IT_PAOLO", "TTS_IT-IT_SILVIA", "TTS_NL-BE_ELLEN", "TTS_NL-NL_CLAIRE", "TTS_NL-NL_XANDER" |
Media Text-to-Speech Options
{
"rate": 0
}| Property | Type | Description |
|---|---|---|
| rate | int | Speech rate. min:1 max:100 default:50 |
NumberInfos object
{
"country_code": "FR",
"intl_code": "(string)",
"intl_max_length": "(string)",
"intl_min_length": "(string)",
"intl_number": "+447890123456",
"is_valid": true,
"local_number": "(string)",
"local_prefix": "(string)",
"location": "(string)",
"type": "(string)"
}| Property | Type | Description |
|---|---|---|
| country_code | string |
Phone number country Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| intl_code | string | International dial code |
| intl_max_length | string | Phone number maxmimum length |
| intl_min_length | string | Phone number minimum length |
| intl_number | string |
Phone number in international format Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| is_valid | bool | Indicate if the phone number is correctly formatted |
| local_number | string | Phone number in local format |
| local_prefix | string | Local (in country) dial prefix |
| location | string | Phone number location (not always accurate) |
| type | string | Phone number type (not always accurate) |
Push Hook (push URL configuration) - deprecated object
{
"auth": "(string)",
"url": "(string)"
}| Property | Type | Description |
|---|---|---|
| auth | string |
Basic HTTP Authentication (login:password) Format: http_basic_auth (login:password used for Basic HTTP Authentication) |
| url | string |
Your URL Format: url (HTTP(S) URL) |
Realtime App. Allows you to control the call in Real-Time.
{
"data_format": "JSON",
"login": "(string)",
"password": "(string)",
"url": "(string)"
}| Property | Type | Description |
|---|---|---|
| data_format | string |
Data format. The only format supported right now is "JSON" Values: "JSON" |
| login | string | Login if your URL is password protected (HTTP Basic Authentication) |
| password | string | Password If your URL is password protected (HTTP Basic Authentication) |
| url | string | Your URL callback. Our system will POST call status to your URL, and your answers will control the call |
Realtime Call Options
{
"cdr_field": "(string)",
"cli": "(string)"
}| Property | Type | Description |
|---|---|---|
| cdr_field | string |
Custom field written in the CDR. Format: cdr_customer_field (32 alphanumeric characters maximum) |
| cli | string |
Calling Line Identification. Can be "BLOCKED", any DID you have on your account, or any phone number we have authorized on your account. Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
Real-Time Request (Our POST to your server)
{
"app": "UNIQUEID",
"call_status": "INCOMING_CALL",
"callid": 0,
"cdr_field": "(string)",
"cli_name": "(string)",
"cli_number": "(string)",
"command": "(string)",
"command_error": "(string)",
"command_id": 42,
"command_result": "(string)",
"date_started": "2020-04-24 00:42:42",
"number": "+16469820800",
"request_hash": "UNIQUEID",
"variables": {}
}| Property | Type | Description |
|---|---|---|
| app | string |
Voice App ID Format: hash (Unique object identifier) |
| call_status | string |
Call status. Values: "BUSY", "CONGESTION", "HANGUP", "INCOMING_CALL", "NOANSWER", "REJECTED", "UP" |
| callid | int |
Call Unique ID (CDR) Format: callid (64-bit unsigned integer) |
| cdr_field | string |
Custom field set by you when making the call Format: cdr_customer_field (32 alphanumeric characters maximum) |
| cli_name | string | CLI name |
| cli_number | string | CLI number |
| command | string | The command name related to this request. |
| command_error | string | The command error (if any) related to this request. |
| command_id | mixed | The command id related to this request. |
| command_result | string | The command result related to this request. |
| date_started | string |
When the call has started Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| number | string |
DID/Outbound phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| request_hash | string |
Outbound Request ID (if outbound call) Format: hash (Unique object identifier) |
| variables | object | Key/Value object sent back with each request. You can use this as a session object. |
Real-Time Response (Your response to our requests). You have to send it within 5 seconds. The earliest, the better.
{
"command": "(string)",
"command_id": 42,
"params": {},
"variables": {}
}| Property | Type | Description |
|---|---|---|
| command | string | The command we have to execute (see the commands list in Real-Time) |
| command_id | mixed | Command ID. Use the value you want. We will send this ID back when we have the result ready. Useful to keep track of your scenario. |
| params | object | Command parameters. See the Real-Time commands. |
| variables | object | Key/Value object. You can fill this object with anything, we will send it back without touching it in our next request. You can use this as a session object. |
Search options
{
"offset": 0,
"order": "(string)",
"quantity": 0
}| Property | Type | Description |
|---|---|---|
| offset | int | Start index (zero-based) |
| order | string | Order by |
| quantity | int | Limit quantity |
Search results
{
"has_more": true,
"hits": [],
"offset": 0,
"total": 0
}| Property | Type | Description |
|---|---|---|
| has_more | bool | More items available |
| hits | array | Hits |
| offset | int | Current index |
| total | int | Total available |
Addressbook
{
"content_header": [],
"description": "(string)",
"hash": "(string)",
"imported_at": "2020-04-24 00:42:42",
"in_use": true,
"items_count": 0,
"name": "(string)"
}| Property | Type | Description |
|---|---|---|
| content_header | array | Headers |
| description | string | Description |
| hash | string | ID |
| imported_at | string |
Import date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| in_use | bool | Is the addressbook currently in use? |
| items_count | int | Numbers of items in addressbook |
| name | string | Name |
Search filters
{
"hash": "(string)",
"keywords": "(string)",
"name": "(string)"
}| Property | Type | Description |
|---|---|---|
| hash | string | ID filter |
| keywords | string | Keywords |
| name | string | Name filter |
Black list (do not call)
{
"content_header": [],
"created_at": "2020-04-24 00:42:42",
"hash": "(string)",
"items_count": 0,
"name": "(string)",
"updated_at": "2020-04-24 00:42:42"
}| Property | Type | Description |
|---|---|---|
| content_header | array | Headers |
| created_at | string |
Creation date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| hash | string | ID |
| items_count | int | Numbers of items in black list |
| name | string | Name |
| updated_at | string |
Update date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Search filters
{
"hash": "(string)",
"keywords": "(string)",
"name": "(string)"
}| Property | Type | Description |
|---|---|---|
| hash | string | ID filter |
| keywords | string | Keywords |
| name | string | Name filter |
Campaign
{
"created_at": "2020-04-24 00:42:42",
"hash": "(string)",
"ivr": {},
"name": "(string)",
"options": {},
"report": true,
"status": {},
"type": "VOICE_IVR",
"updated_at": "2020-04-24 00:42:42"
}| Property | Type | Description |
|---|---|---|
| created_at | string |
Creation date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| hash | string | ID |
| ivr | object |
Scenario / Call flow Objects: Sendr.10.Campaign.Ivr.Sms.Simple, Sendr.10.Campaign.Ivr.Sms.Survey, Sendr.10.Campaign.Ivr.Voice.Simple, Sendr.10.Campaign.Ivr.Voice.Survey, Sendr.10.Campaign.Ivr.Voice.Ivr |
| name | string | Name |
| options | object |
Options Objects: Sendr.10.Campaign.Options.Voice, Sendr.10.Campaign.Options.Sms |
| report | bool | Is a report available? |
| status | object |
Status Object: Sendr.10.Campaign.Status |
| type | string |
Type Values: "SMS_SIMPLE", "SMS_SURVEY", "VOICE_IVR", "VOICE_SIMPLE", "VOICE_SURVEY" |
| updated_at | string |
Update date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Campaign black list configuration
{
"method": "ALL",
"selected": []
}| Property | Type | Description |
|---|---|---|
| method | string |
Should we filter the address book? Values: "ALL", "NONE", "SELECT" |
| selected | array |
Specific list of black lists to apply. If empty, all black lists are applied. Format: hash (Unique object identifier) |
Simple SMS
{
"encoding": "(string)",
"optout_confirmed": "(string)",
"optout_suffix": "(string)",
"sender": "(string)",
"text": "(string)"
}| Property | Type | Description |
|---|---|---|
| encoding | string | Encoding of the SMS. Can be GSM or UNICODE. |
| optout_confirmed | string | Message sent to users to confirm an optout |
| optout_suffix | string | Message appended at the end of the SMS for optout information |
| sender | string |
Sender Format: sms_sender (a-zA-Z0-9, space, dash, underscore - must contain at least one alpha character) |
| text | string | Text |
Survey SMS
{
"final_text": "(string)",
"sender": "(string)",
"texts": []
}| Property | Type | Description |
|---|---|---|
| final_text | string | Last message sent (no reply expected) |
| sender | string |
Sender Format: sms_sender (a-zA-Z0-9, space, dash, underscore - must contain at least one alpha character) |
| texts | array | Survey questions. Each question is sent after the previous one has been answered. |
Bridge action
{
"broadcast": [],
"email": {},
"noanswer": true,
"ringtone": [],
"targets": [],
"voicemail": {},
"whisper": []
}| Property | Type | Description |
|---|---|---|
| broadcast | array | Broadcast messages |
| object |
Send email? Object: Sendr.10.Campaign.Ivr.Voice.Action.Bridge.Email |
|
| noanswer | bool | Played if targets do not answer |
| ringtone | array | Played while dialing targets. Leave empty for default ringtone. |
| targets | array |
Phone targets Array of objects: Target |
| voicemail | object |
If targets do not answer, voicemail settings. Object: Sendr.10.Campaign.Ivr.Voice.Action.Bridge.Email |
| whisper | array | Played to targets ONLY before bridging the call |
Email sub action
{
"emails": [],
"enabled": true,
"template": "(string)"
}| Property | Type | Description |
|---|---|---|
| emails | array | Emails |
| enabled | bool | Enabled? |
| template | string | Email template |
Broadcast action
{
"broadcast": [],
"goodbye": [],
"prompt": []
}| Property | Type | Description |
|---|---|---|
| broadcast | array | Broadcast messages |
| goodbye | array | Played after the prompt |
| prompt | array | Prompt to listen the broadcast again (key "1"), or go back to the main menu (key "") |
Callback action
{
"broadcast": [],
"delay": 0
}| Property | Type | Description |
|---|---|---|
| broadcast | array | Broadcast messages |
| delay | int | Delay (minutes) before calling back (5..240) |
Email action
{
"broadcast": [],
"emails": [],
"template": "(string)"
}| Property | Type | Description |
|---|---|---|
| broadcast | array | Broadcast messages |
| emails | array | Emails |
| template | string | Email template |
Record action
{
"broadcast": [],
"emails": [],
"goodbye": [],
"prompt": [],
"record_max_duration": 0,
"template": "(string)"
}| Property | Type | Description |
|---|---|---|
| broadcast | array | Broadcast messages |
| emails | array | Emails to send the recording to (mp3 attached) |
| goodbye | array | Played after accepting the recording. |
| prompt | array | Prompt: "1" to listen to the recording, "2" to accept it, "3" to record again. |
| record_max_duration | int | Max duration (seconds) 10..120 |
| template | string | Email template |
Instant voice response Messages are played in the following order: voicemail_detect_media, broadcast, prompt, goodbye.
{
"broadcast": [],
"keys": {},
"prompt": [],
"voicemail_broadcast": [],
"voicemail_detect_media": [],
"voicemail_detect_method": "DIRECT"
}| Property | Type | Description |
|---|---|---|
| broadcast | array | Broadcast messages |
| keys | object |
Key configuration Object: Sendr.10.Campaign.Ivr.Voice.IvrKeys |
| prompt | array | IVR prompt |
| voicemail_broadcast | array | Leave message on voicemail |
| voicemail_detect_media | array | Media played for the "DTMF" method (should ask to press a key) |
| voicemail_detect_method | string |
Voicemail detection method Values: "AUTO", "DIRECT", "DTMF", "NO" |
IVR key
{
"action": "NONE",
"params": {}
}| Property | Type | Description |
|---|---|---|
| action | string |
Key action Values: "BRIDGE", "BROADCAST", "CALLBACK", "EMAIL", "NONE", "RECORD" |
| params | object |
Key params Objects: Sendr.10.Campaign.Ivr.Voice.Action.Broadcast, Sendr.10.Campaign.Ivr.Voice.Action.Bridge, Sendr.10.Campaign.Ivr.Voice.Action.Email, Sendr.10.Campaign.Ivr.Voice.Action.Callback, Sendr.10.Campaign.Ivr.Voice.Action.Record |
IVR keys
{
"key_0": {},
"key_1": {},
"key_2": {},
"key_3": {},
"key_4": {},
"key_5": {},
"key_6": {},
"key_7": {},
"key_8": {},
"key_9": {}
}| Property | Type | Description |
|---|---|---|
| key_0 | object |
Key '0' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
| key_1 | object |
Key '1' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
| key_2 | object |
Key '2' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
| key_3 | object |
Key '3' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
| key_4 | object |
Key '4' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
| key_5 | object |
Key '5' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
| key_6 | object |
Key '6' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
| key_7 | object |
Key '7' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
| key_8 | object |
Key '8' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
| key_9 | object |
Key '9' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
Simple voice broadcasting. Messages are played in the following order: voicemail_detect_media, broadcast, prompt, goodbye.
{
"broadcast": [],
"goodbye": [],
"prompt": [],
"voicemail_broadcast": [],
"voicemail_detect_media": [],
"voicemail_detect_method": "DIRECT"
}| Property | Type | Description |
|---|---|---|
| broadcast | array | Broadcast messages |
| goodbye | array | Played after the prompt |
| prompt | array | Prompt to listen the broadcast again (key "1") |
| voicemail_broadcast | array | Leave message on voicemail |
| voicemail_detect_media | array | Media played for the "DTMF" method (should ask to press a key) |
| voicemail_detect_method | string |
Voicemail detection method Values: "AUTO", "DIRECT", "DTMF", "NO" |
Voice survey
{
"broadcast": [],
"goodbye": [],
"key_error": [],
"key_valid": [],
"questions": [],
"voicemail_broadcast": [],
"voicemail_detect_media": [],
"voicemail_detect_method": "DTMF"
}| Property | Type | Description |
|---|---|---|
| broadcast | array | Broadcast messages |
| goodbye | array | Goodbye messages |
| key_error | array | Played when an invalid key is pressed, or when no key is pressed |
| key_valid | array | Played when key is valid |
| questions | array |
Survey questions Array of objects: Sendr.10.Campaign.Ivr.Voice.Survey.Question |
| voicemail_broadcast | array | Leave message on voicemail |
| voicemail_detect_media | array | Media played for the "DTMF" method (should ask to press a key) |
| voicemail_detect_method | string |
Voicemail detection method Values: "AUTO", "DIRECT", "DTMF", "NO" |
Survey answer
{
"broadcast": "(string)",
"key": "(string)",
"text": "(string)"
}| Property | Type | Description |
|---|---|---|
| broadcast | string | Answer (media) |
| key | string | Key assigned to the answer |
| text | string | Answer (text) |
Survey question
{
"answers": [],
"broadcast": [],
"text": "(string)"
}| Property | Type | Description |
|---|---|---|
| answers | array |
Answers Array of objects: Sendr.10.Campaign.Ivr.Voice.Survey.Answer |
| broadcast | array | Question (media) |
| text | string | Question (text) |
Auto-stop conditions
{
"enabled": true,
"per_answer_count": {},
"per_key": {}
}| Property | Type | Description |
|---|---|---|
| enabled | bool | Enable auto-stop? |
| per_answer_count | object |
Stop on specific number of answered calls Object: Sendr.10.Campaign.Options.AutoStopConditions.PerAnswerCount |
| per_key | object |
Stop when count of specific keys are pressed Object: Sendr.10.Campaign.Options.AutoStopConditions.PerKey |
Auto-stop conditions: per-answer count
{
"count": 0,
"enabled": true
}| Property | Type | Description |
|---|---|---|
| count | int | Target number of answered calls |
| enabled | bool | Enable? |
Auto-stop conditions: per-key count
{
"enabled": true,
"key_0": 0,
"key_1": 0,
"key_2": 0,
"key_3": 0,
"key_4": 0,
"key_5": 0,
"key_6": 0,
"key_7": 0,
"key_8": 0,
"key_9": 0
}| Property | Type | Description |
|---|---|---|
| enabled | bool | Enable? |
| key_0 | int | Target number of key '0' press |
| key_1 | int | Target number of key '1' press |
| key_2 | int | Target number of key '2' press |
| key_3 | int | Target number of key '3' press |
| key_4 | int | Target number of key '4' press |
| key_5 | int | Target number of key '5' press |
| key_6 | int | Target number of key '6' press |
| key_7 | int | Target number of key '7' press |
| key_8 | int | Target number of key '8' press |
| key_9 | int | Target number of key '9' press |
Followup options
{
"actions": {},
"conditions": {},
"enabled": true
}| Property | Type | Description |
|---|---|---|
| actions | object |
Followup actions Object: Sendr.10.Campaign.Options.Followup.Actions |
| conditions | object |
Followup conditions Object: Sendr.10.Campaign.Options.Followup.Conditions |
| enabled | bool | Enable followup actions? |
Followup actions
{
"callback": {},
"sms": {}
}| Property | Type | Description |
|---|---|---|
| callback | object |
Callback actions Object: Sendr.10.Campaign.Options.Followup.Actions.Callback |
| sms | object |
SMS actions Object: Sendr.10.Campaign.Options.Followup.Actions.Sms |
Followup actions (callback)
{
"count": 0,
"delay_minutes": 0,
"enabled": true
}| Property | Type | Description |
|---|---|---|
| count | int | How many times should we call back? 1..5 |
| delay_minutes | int | Delay (minutes) between call back. 5..240 |
| enabled | bool | Enabled? |
Followup actions (SMS)
{
"enabled": true,
"sender": "(string)",
"text": "(string)"
}| Property | Type | Description |
|---|---|---|
| enabled | bool | Enabled? |
| sender | string |
Sms sender Format: sms_sender (a-zA-Z0-9, space, dash, underscore - must contain at least one alpha character) |
| text | string | Sms text |
Followup conditions
{
"no_response": true,
"short_call": true,
"short_call_duration": 0,
"voicemail_detected": true
}| Property | Type | Description |
|---|---|---|
| no_response | bool | Condition: no response or busy |
| short_call | bool | Condition: short call |
| short_call_duration | int | Short call duration in seconds (1..60) |
| voicemail_detected | bool | Condition: voicemail detected |
Report sending campaign options
{
"emails": [],
"enabled": true,
"phones": []
}| Property | Type | Description |
|---|---|---|
| emails | array | Emails to send report to |
| enabled | bool | Send report? |
| phones | array | Phones (SMS) to send report to |
SMS options
{
"nature": "ALERTING",
"send_report": {}
}| Property | Type | Description |
|---|---|---|
| nature | string |
Campaign nature Values: "ALERTING", "MARKETING" |
| send_report | object |
Report sending Object: Sendr.10.Campaign.Options.SendReport |
Voice options
{
"auto_stop": {},
"call_recording": true,
"ccl": 0,
"cli": "(string)",
"followup": {},
"nature": "ALERTING",
"send_report": {}
}| Property | Type | Description |
|---|---|---|
| auto_stop | object |
Auto stop conditions Object: Sendr.10.Campaign.Options.AutoStopConditions |
| call_recording | bool | Activate call recording (ONLY WHEN BRIDGING) |
| ccl | int | Concurrent call limit |
| cli | string |
Calling line identification Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
| followup | object |
Followup actions Object: Sendr.10.Campaign.Options.Followup |
| nature | string |
Campaign nature Values: "ALERTING", "MARKETING" |
| send_report | object |
Report sending Object: Sendr.10.Campaign.Options.SendReport |
Search filters
{
"hash": "(string)",
"keywords": "(string)",
"name": "(string)"
}| Property | Type | Description |
|---|---|---|
| hash | string | ID filter |
| keywords | string | Keywords |
| name | string | Name filter |
Campaign status
{
"counters": {},
"ended_at": "2020-04-24 00:42:42",
"finished_cause": "NONE",
"finished_cause_data": {},
"items_done": 0,
"items_total": 0,
"items_total_t": 0,
"percent": 0,
"started_at": "2020-04-24 00:42:42",
"state": "FINISHED"
}| Property | Type | Description |
|---|---|---|
| counters | object |
Counters Objects: Sendr.10.Campaign.Status.SmsSimple, Sendr.10.Campaign.Status.SmsSurvey, Sendr.10.Campaign.Status.VoiceSimple, Sendr.10.Campaign.Status.VoiceIvr, Sendr.10.Campaign.Status.VoiceSurvey |
| ended_at | string |
Ended time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| finished_cause | string |
Finished cause Values: "AUTOSTOP", "DONE", "NONE", "STOPPED", "SYSTEM" |
| finished_cause_data | object | More information about the cause |
| items_done | int | Number of phone numbers that have been processed and for which all possible followup actions have been exhausted |
| items_total | int | Number of phone numbers to call (initially - in the addressbook) |
| items_total_t | int | Number of phone numbers with retries (this can change if there are "retries") |
| percent | int | Percent completion 0..100 |
| started_at | string |
Start time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| state | string |
State Values: "CREATED", "FINISHED", "PAUSED", "STARTED", "STOPPED" |
SMS Sent Statuses Number of SMS per status.
{
"ERROR": 0,
"EXPIRED": 0,
"FAILED": 0,
"PENDING": 0,
"RECEIVED": 0,
"REMOTE_QUEUED": 0,
"SENT": 0,
"UNKNOWN": 0
}| Property | Type | Description |
|---|---|---|
| ERROR | int | Number of SMS in error |
| EXPIRED | int | Number of SMS that expired |
| FAILED | int | Number of SMS that failed to reach |
| PENDING | int | Number of SMS yet pending |
| RECEIVED | int | Number of SMS recieved |
| REMOTE_QUEUED | int | Number of SMS currently queuded within a remote carrier system |
| SENT | int | Number of SMS sent |
| UNKNOWN | int | Number of SMS with an unknown status |
Simple SMS campaign report status
{
"answers": 0,
"answers_unique": 0,
"billed": "(string)",
"cost": "(string)",
"errors": 0,
"optouts": 0,
"sent": 0,
"sent_status": {}
}| Property | Type | Description |
|---|---|---|
| answers | int | Number of answers |
| answers_unique | int | Number of unique answers |
| billed | string | Amount billed |
| cost | string | Mean cost per SMS in cents |
| errors | int | Number of SMS that failed |
| optouts | int | Number of optouts |
| sent | int | Number of SMS sent |
| sent_status | object |
Number of SMS per sent status Object: Sendr.10.Campaign.Status.Sms.SentStatus |
Survey SMS campaign report status
{
"answers": 0,
"billed": "(string)",
"cost": "(string)",
"errors": 0,
"optouts": 0,
"questions": [],
"sent": 0
}| Property | Type | Description |
|---|---|---|
| answers | int | Number of answers |
| billed | string | Amount billed |
| cost | string | Mean cost per SMS in cents |
| errors | int | Number of SMS that failed |
| optouts | int | Number of optouts |
| questions | array | Array containign the questions in the survey and the answers. |
| sent | int | Number of SMS sent |
Voice campaign call statuses
{
"ABSENT/BUSY": 0,
"ABSENT/NO_ANSWER": 0,
"ABSENT/VOICEMAIL_DETECTED": 0,
"ANSWERED/COMPLETE": 0,
"ANSWERED/INCOMPLETE": 0,
"ERROR/BLACKLISTED": 0,
"ERROR/OTHER": 0,
"ERROR/REJECTED": 0,
"ERROR/UNALLOCATED_NUMBER": 0
}| Property | Type | Description |
|---|---|---|
| ABSENT/BUSY | int | Number of unanswered calls because destination is busy |
| ABSENT/NO_ANSWER | int | Number of unanswered calls |
| ABSENT/VOICEMAIL_DETECTED | int | Number of unanswered calls with a voicemail detected |
| ANSWERED/COMPLETE | int | Number of answered and completed calls |
| ANSWERED/INCOMPLETE | int | Number of answered but incomplete calls |
| ERROR/BLACKLISTED | int | Number of calls not made because number is blacklisted |
| ERROR/OTHER | int | Number of calls with another unknown error |
| ERROR/REJECTED | int | Number of calls that were rejected |
| ERROR/UNALLOCATED_NUMBER | int | Numbers that are unallocated |
Voice campaign status per key pressed
{
"key_0": 0,
"key_1": 0,
"key_2": 0,
"key_3": 0,
"key_4": 0,
"key_5": 0,
"key_6": 0,
"key_7": 0,
"key_8": 0,
"key_9": 0
}| Property | Type | Description |
|---|---|---|
| key_0 | int | Number of times key '0' was pressed |
| key_1 | int | Number of times key '1' was pressed |
| key_2 | int | Number of times key '2' was pressed |
| key_3 | int | Number of times key '3' was pressed |
| key_4 | int | Number of times key '4' was pressed |
| key_5 | int | Number of times key '5' was pressed |
| key_6 | int | Number of times key '6' was pressed |
| key_7 | int | Number of times key '7' was pressed |
| key_8 | int | Number of times key '8' was pressed |
| key_9 | int | Number of times key '9' was pressed |
Voice campaign retries
{
"cause": {},
"count": 0,
"sms_sent": 0
}| Property | Type | Description |
|---|---|---|
| cause | object |
Object containing number of retries per cause Object: Sendr.10.Campaign.Status.Voice.Retries.Causes |
| count | int | Number of retries |
| sms_sent | int | Number of SMS sent as part of a retry condition |
Voice campaign retries causes
{
"CALLBACK": 0,
"NO_RESPONSE": 0,
"SHORTCALL": 0,
"VOICEMAIL_DETECTED": 0
}| Property | Type | Description |
|---|---|---|
| CALLBACK | int | Number of retries because the user asked for a callback |
| NO_RESPONSE | int | Number of retries because no response |
| SHORTCALL | int | Number of retries because the call was hung up too fast |
| VOICEMAIL_DETECTED | int | Number of retries because a voicemail was detected |
Voice IVR campaign status
{
"acd": 0,
"actions": {},
"call_status": {},
"calls": 0,
"calls_active": 0,
"calls_answered": 0,
"cost": "(string)",
"optouts": 0,
"retries": {}
}| Property | Type | Description |
|---|---|---|
| acd | int | Average call duration |
| actions | object |
Object containing status on actions per key pressed Object: Sendr.10.Campaign.Ivr.Voice.IvrKeys |
| call_status | object |
Object containing the number of calls per status Object: Sendr.10.Campaign.Status.Voice.CallStatus |
| calls | int | Number of calls |
| calls_active | int | Number of of active calls |
| calls_answered | int | Number of answered calls |
| cost | string | Mean cost per call in cents |
| optouts | int | Number of optouts |
| retries | object |
Object containing information on retries if applicable Object: Sendr.10.Campaign.Status.Voice.Retries |
Simple Voice campaign status
{
"acd": 0,
"broadcast": {},
"call_status": {},
"calls": 0,
"calls_active": 0,
"calls_answered": 0,
"cost": "(string)",
"keys": {},
"optouts": 0,
"retries": {}
}| Property | Type | Description |
|---|---|---|
| acd | int | Average call duration |
| broadcast | object |
Object containing details and history on calls. Object: Sendr.10.Campaign.Status.VoiceSimple.Broadcast |
| call_status | object |
Object containing the number of calls per status Object: Sendr.10.Campaign.Status.Voice.CallStatus |
| calls | int | Number of calls |
| calls_active | int | Number of of active calls |
| calls_answered | int | Number of answered calls |
| cost | string | Mean cost per call in cents |
| keys | object |
Number of optouts Object: Sendr.10.Campaign.Status.Voice.Keys |
| optouts | int | Number of optouts |
| retries | object |
Object containing information on retries if applicable Object: Sendr.10.Campaign.Status.Voice.Retries |
Simple Voice campaign report brodcast status info
{
"completed": 0,
"history": {}
}| Property | Type | Description |
|---|---|---|
| completed | int | Number of calls completed |
| history | object | Object with date-based properties indicating the number of calls for each date |
Voice survey campaign status
{
"acd": 0,
"call_status": {},
"calls": 0,
"calls_active": 0,
"calls_answered": 0,
"cost": "(string)",
"keys": {},
"optouts": 0,
"questions": [],
"retries": {}
}| Property | Type | Description |
|---|---|---|
| acd | int | Average call duration |
| call_status | object |
Object containing the number of calls per status Object: Sendr.10.Campaign.Status.Voice.CallStatus |
| calls | int | Number of calls |
| calls_active | int | Number of of active calls |
| calls_answered | int | Number of answered calls |
| cost | string | Mean cost per call in cents |
| keys | object |
Number of optouts Object: Sendr.10.Campaign.Status.Voice.Keys |
| optouts | int | Number of optouts |
| questions | array |
Survey questions Array of objects: Sendr.10.Campaign.Ivr.Voice.Survey.Question |
| retries | object |
Object containing information on retries if applicable Object: Sendr.10.Campaign.Status.Voice.Retries |
Test call
{
"call_answered_at": "2020-04-24 00:42:42",
"call_duration": 0,
"call_hangup_at": "2020-04-24 00:42:42",
"call_started_at": "2020-04-24 00:42:42",
"call_status": "ANSWERED",
"id": 0,
"number": "+16469820800"
}| Property | Type | Description |
|---|---|---|
| call_answered_at | string |
Call answer time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| call_duration | int | Call duration (secs) |
| call_hangup_at | string |
Call hangup time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| call_started_at | string |
Call start time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| call_status | string |
Call status Values: "ANSWERED", "DIALING", "HANGUP", "PENDING", "PROCESSING" |
| id | int | Call id |
| number | string |
Phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
Sendr campaign report
{
"campaign": {},
"created_at": "2020-04-24 00:42:42",
"data": {},
"hash": "UNIQUEID",
"state": "INTERIM",
"updated_at": "2020-04-24 00:42:42"
}| Property | Type | Description |
|---|---|---|
| campaign | object |
The campaign object when the report was generated Object: Sendr.10.Campaign |
| created_at | string |
Creation time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| data | object |
Report data Objects: Sendr.10.Campaign.Status.VoiceSimple, Sendr.10.Campaign.Status.VoiceSurvey, Sendr.10.Campaign.Status.VoiceIvr, Sendr.10.Campaign.Status.SmsSimple, Sendr.10.Campaign.Status.SmsSurvey |
| hash | string |
Report ID Format: hash (Unique object identifier) |
| state | string |
Report state Values: "FINAL", "INTERIM" |
| updated_at | string |
Update time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Search filters
{
"created_at_from": "2020-04-24 00:42:42",
"created_at_to": "2020-04-24 00:42:42",
"name": "(string)",
"type": "(string)",
"updated_at_from": "2020-04-24 00:42:42",
"updated_at_to": "2020-04-24 00:42:42"
}| Property | Type | Description |
|---|---|---|
| created_at_from | string |
Created at from Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| created_at_to | string |
Created at to Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| name | string | Campaign name |
| type | string | Campaign type : SMS_SIMPLE, SMS_SURVEY, VOICE_SIMPLE, VOICE_SURVEY, VOICE_IVR |
| updated_at_from | string |
Updated at from Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| updated_at_to | string |
Updated at to Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
SIP Subscriber
{
"cli": "(string)",
"codecs": [],
"domain": "(string)",
"id": 0,
"password": "(string)",
"privacy": "off",
"ring_timeout": 0,
"srtp": true,
"username": "(string)",
"vms": {}
}| Property | Type | Description |
|---|---|---|
| cli | string |
Calling Line Identification. Can be "BLOCKED", any DID you have on your account, or any phone number we have authorized on your account. Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
| codecs | array |
Codecs Values: "G729", "OPUS", "PCMA", "PCMU" |
| domain | string | Domain (auto-filled) |
| id | int | SIP Subscriber ID |
| password | string | Password (auto-generated) |
| privacy | string |
Privacy Values: "full", "off" |
| ring_timeout | int |
Ring timeout in seconds Format: ring_timeout (Must be between 5 and 120 seconds) |
| srtp | bool | Set to true to enable SRTP on inbound calls |
| username | string |
Username Format: sip_subscriber_username (SIP Subscriber username) |
| vms | object |
Voicemail Params Object: App.Param.Vms |
SIP Subscriber Options
{
"vms": {}
}| Property | Type | Description |
|---|---|---|
| vms | object |
Voicemail Params Object: App.Param.Vms |
SIP Subscriber Properties
{
"cli": "(string)",
"codecs": [],
"privacy": "off",
"ring_timeout": 0,
"srtp": true,
"username": "(string)"
}| Property | Type | Description |
|---|---|---|
| cli | string |
Calling Line Identification (optional, default: "BLOCKED"). Can be "BLOCKED", any DID you have on your account, or any phone number we have authorized on your account. Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
| codecs | array |
Codecs (optional, default: empty) Values: "G729", "OPUS", "PCMA", "PCMU" |
| privacy | string |
Privacy (optional, default: "full" ie. Presentation prohibited (Anonymous call)) Values: "full", "off" |
| ring_timeout | int |
Ring timeout in seconds (optional, default: 30) Format: ring_timeout (Must be between 5 and 120 seconds) |
| srtp | bool | Set to true to enable SRTP on inbound calls |
| username | string |
Username (optional, default: auto-generated) Format: sip_subscriber_username (SIP Subscriber username) |
SIP Subscriber Search filters
{
"domain": "(string)",
"username": "(string)"
}| Property | Type | Description |
|---|---|---|
| domain | string | Domain |
| username | string |
Username Format: sip_subscriber_username (SIP Subscriber username) |
SIP Trunk Origination
{
"id": 0
}| Property | Type | Description |
|---|---|---|
| id | int | SIP Trunk Origination ID |
SIP Trunk Origination Options
{
}| Property | Type | Description |
|---|
SIP Trunk Origination Properties
{
}| Property | Type | Description |
|---|
SIP Trunk Origination Search filters
{
}| Property | Type | Description |
|---|
SIP Trunk Termination
{
"id": 0
}| Property | Type | Description |
|---|---|---|
| id | int | SIP Trunk Termination ID |
SIP Trunk Termination Options
{
}| Property | Type | Description |
|---|
SIP Trunk Termination Properties
{
}| Property | Type | Description |
|---|
SIP Trunk Termination Search filters
{
}| Property | Type | Description |
|---|
SMS text message
{
"b_customer_debit": "0.00",
"b_customer_mode": "POSTPAID",
"date_creation": "2020-04-24 00:42:42",
"date_received": "2020-04-24 00:42:42",
"date_sent": "2020-04-24 00:42:42",
"date_update": "2020-04-24 00:42:42",
"encoding": "UNICODE",
"from": "(string)",
"hash": "UNIQUEID",
"nature": "MARKETING",
"options": {},
"parts": 0,
"status": "SENT",
"status_error": "(string)",
"text": "(string)",
"to": "(string)",
"type": "IN",
"user_data": "(string)"
}| Property | Type | Description |
|---|---|---|
| b_customer_debit | string |
Amount debited Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| b_customer_mode | string |
Billing mode Values: "POSTPAID", "PREPAID" |
| date_creation | string |
Date of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_received | string |
Received date (if received) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_sent | string |
Sent date (if sent) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| date_update | string |
Date of last update (status update) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| encoding | string |
The encoding used to send the SMS Values: "GSM", "UNICODE" |
| from | string | Sender |
| hash | string |
SMS ID Format: hash (Unique object identifier) |
| nature | string |
SMS Nature Values: "ALERTING", "MARKETING" |
| options | object |
SMS options Object: SMS.Options |
| parts | int | Number of SMS parts billed. May be > 1 if your text is too long. |
| status | string |
SMS status Values: "CREATED", "ERROR", "EXPIRED", "FAILED", "PENDING", "RECEIVED", "REMOTE_QUEUED", "SENT" |
| status_error | string | Descriptive error if status is "ERROR" |
| text | string | SMS content |
| to | string | Recipient |
| type | string |
SMS type Values: "IN", "OUT" |
| user_data | string |
Custom field set in $options Format: cdr_customer_field (32 alphanumeric characters maximum) |
The SMS.Options object defines the following properties.
{
"flash_message": true,
"force_encoding": "UNICODE",
"nature": "MARKETING",
"user_data": "(string)",
"webhook": {}
}| Property | Type | Description |
|---|---|---|
| flash_message | bool | Send the SMS as a Flash Message (text will be shown on phone but not stored - not supported by all carriers and phone) |
| force_encoding | string |
Force the encoding to be used. It is generally a good idea to force GSM because it is working everywhere on every carrier. Default is NULL (auto-detect). Values: "GSM", "UNICODE" |
| nature | string |
SMS Nature. Make sure to select the right nature, otherwise your account might be blocked. Values: "ALERTING", "MARKETING" |
| user_data | string |
Custom field sent back you Format: cdr_customer_field (32 alphanumeric characters maximum) |
| webhook | object |
Dynamic webhook for this SMS. Status updates will be set to this specific webhook (and also to your "sms.mt.status_update" subscriptions). Replies to this SMS will also be sent to this specific webhook. You only need to set 'endpoint' and optionally 'options'. Object: Webhook |
Quote for a SMS
{
"amount": "0.00",
"count": 0,
"currency": "USD",
"encoding": "UNICODE",
"length": 0
}| Property | Type | Description |
|---|---|---|
| amount | string |
The amount this SMS will cost Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| count | int | Number of SMS billed |
| currency | string |
The currency of the cost. This is always the same, depending on your account. Values: "EUR", "USD" |
| encoding | string |
Charset that will be used Values: "GSM", "UNICODE" |
| length | int | Text length (number of characters) |
Search filters
{
"created_at_from": "2020-04-24 00:42:42",
"created_at_to": "2020-04-24 00:42:42",
"from": "+16469820800",
"hash": "UNIQUEID",
"nature": "MARKETING",
"status": "EXPIRED",
"text": "(string)",
"to": "+33612345678",
"type": "IN"
}| Property | Type | Description |
|---|---|---|
| created_at_from | string |
Retrieve from this date (max. NOW minus 6 months) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| created_at_to | string |
Retrieve until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| from | string |
Sender Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| hash | string |
SMS Hash Format: hash (Unique object identifier) |
| nature | string |
SMS nature Values: "ALERTING", "MARKETING" |
| status | string |
SMS status Values: "CREATED", "ERROR", "EXPIRED", "FAILED", "PENDING", "RECEIVED", "REMOTE_QUEUED", "SENT" |
| text | string | SMS content |
| to | string |
Recipient Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| type | string |
SMS type Values: "IN", "OUT" |
Sub Account
{
"account": {},
"contact": {},
"credentials": {},
"params": {},
"state": {}
}| Property | Type | Description |
|---|---|---|
| account | object |
The Sub Account account informations Object: SubAccount.Account |
| contact | object |
The Sub Account contact informations Object: SubAccount.Contact |
| credentials | object |
The Sub Account credentials informations Object: SubAccount.Credentials |
| params | object |
The Sub Account params informations Object: SubAccount.Params |
| state | object |
The Sub Account state informations Object: SubAccount.State |
Sub Account Account
{
"company": "(string)",
"firstname": "(string)",
"lastname": "(string)"
}| Property | Type | Description |
|---|---|---|
| company | string |
The account company Format: field_name (Generic name field) |
| firstname | string |
The account firstname Format: field_name (Generic name field) |
| lastname | string |
The account lastname Format: field_name (Generic name field) |
Sub Account Contact
{
"addresses": [],
"emails": [],
"phones": [],
"tech_emails": []
}| Property | Type | Description |
|---|---|---|
| addresses | array |
The contact addresses (min:0, max :1) Array of objects: Address |
| emails | array |
The contact emails (min:1, max :1) Format: email (An email address) |
| phones | array |
The contact phones (min:0, max :1) Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| tech_emails | array |
The technical contact emails Format: email (An email address) |
Sub Account Creation Options
{
"password": {}
}| Property | Type | Description |
|---|---|---|
| password | object |
The password creation options Object: SubAccount.CreateOptions.Password |
Sub Account Creation Options Password
{
"method": "MANUAL",
"value": "(string)"
}| Property | Type | Description |
|---|---|---|
| method | string |
The password creation method Values: "AUTO", "MANUAL" |
| value | string |
The password value in MANUAL method Format: subaccount_password_value (Sub Account password) |
Sub Account Params Creation
{
"billing": {}
}| Property | Type | Description |
|---|---|---|
| billing | object |
The Sub Account billing params informations Object: SubAccount.CreateParams.Billing |
Sub Account Params Billing Creation
{
"addresses": [],
"emails": []
}| Property | Type | Description |
|---|---|---|
| addresses | array |
The billing addresses (min:0, max :1) Array of objects: Address |
| emails | array |
The billing emails (min:0) Format: email (An email address) |
Sub Account Creation Properties
{
"account": {},
"contact": {},
"params": {}
}| Property | Type | Description |
|---|---|---|
| account | object |
The Sub Account account informations Object: SubAccount.Account |
| contact | object |
The Sub Account contact informations Object: SubAccount.Contact |
| params | object |
The Sub Account params informations Object: SubAccount.CreateParams |
Sub Account Credentials
{
"login": "(string)",
"password": "(string)"
}| Property | Type | Description |
|---|---|---|
| login | string | The login |
| password | string | The password (print only the first time) |
Sub Account Edition Options
{
}| Property | Type | Description |
|---|
Sub Account Params Editable
{
"billing": {}
}| Property | Type | Description |
|---|---|---|
| billing | object |
The Sub Account billing params informations Object: SubAccount.EditParams.Billing |
Sub Account Params Billing Editable
{
"addresses": [],
"emails": []
}| Property | Type | Description |
|---|---|---|
| addresses | array |
The billing addresses (min:0, max :1) Array of objects: Address |
| emails | array |
The billing emails (min:0) Format: email (An email address) |
Sub Account Edition Properties
{
"contact": {},
"params": {}
}| Property | Type | Description |
|---|---|---|
| contact | object |
The Sub Account contact informations Object: SubAccount.Contact |
| params | object |
The Sub Account params informations Object: SubAccount.EditParams |
Sub Account Params
{
"billing": {},
"default": {}
}| Property | Type | Description |
|---|---|---|
| billing | object |
The Sub Account billing params informations Object: SubAccount.Params.Billing |
| default | object |
The Sub Account default params informations Object: SubAccount.Params.Default |
Sub Account Params Billing
{
"addresses": [],
"currency_code": "USD",
"emails": []
}| Property | Type | Description |
|---|---|---|
| addresses | array |
The billing addresses (min:0, max :1) Array of objects: Address |
| currency_code | string |
The billing currency Values: "EUR", "USD" |
| emails | array |
The billing emails (min:0) Format: email (An email address) |
Sub Account Params Default
{
"locale": "(string)",
"timezone": "(string)"
}| Property | Type | Description |
|---|---|---|
| locale | string |
The sub account locale Format: locale (POSIX/IANA locale code. Example: "en_US" or "fr_FR".) |
| timezone | string |
The sub account timezone Format: timezone_str (IANA timezone name. Example: "Europe/Paris".) |
Sub Account Quota
{
"actual": 0,
"max": 0
}| Property | Type | Description |
|---|---|---|
| actual | int | The number of Sub Accounts used |
| max | int | The maximum number of Sub Accounts allowed |
Sub Account Search filters
{
"archived": true
}| Property | Type | Description |
|---|---|---|
| archived | bool | FALSE: only not archived, TRUE: only archived, NULL: both (Default: FALSE) |
Sub Account State
{
"allow_calls_in": true,
"allow_calls_out": true,
"allow_sms_in": true,
"allow_sms_out": true,
"archived": true,
"credit": "0.00",
"disabled": true
}| Property | Type | Description |
|---|---|---|
| allow_calls_in | bool | Are inbound calls allowed? |
| allow_calls_out | bool | Are outbound calls allowed? |
| allow_sms_in | bool | Are inbound SMS allowed? |
| allow_sms_out | bool | Are outbound SMS allowed? |
| archived | bool | The archived state |
| credit | string |
The sub account credit Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| disabled | bool | The disabled state |
Sub Account Tranfer Options
{
}| Property | Type | Description |
|---|
Target (Phone number + timeout)
{
"number": "+16469820800",
"timeout": 30
}| Property | Type | Description |
|---|---|---|
| number | string |
The phone number to dial Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
| timeout | int |
Ringing timeout in seconds. Must be between 5 and 300 Format: dial_timeout (Must be between 5 and 300 seconds) |
Realtime App. Allows you to control the call in Real-Time. WARNING: DEPRECATED by REALTIME10.
{
"data_format": "JSON",
"login": "(string)",
"password": "(string)",
"url": "(string)"
}| Property | Type | Description |
|---|---|---|
| data_format | string |
Data format. The only format supported right now is "JSON" Values: "JSON" |
| login | string | Login if your URL is password protected (HTTP Basic Authentication) |
| password | string | Password If your URL is password protected (HTTP Basic Authentication) |
| url | string | Your URL callback. Our system will POST call status to your URL, and your answers will control the call |
Timezone object
{
"country_codes": [],
"dst": "(string)",
"iana": "(string)",
"iana_names": [],
"id": 0,
"label": "(string)"
}| Property | Type | Description |
|---|---|---|
| country_codes | array |
Countries in this timezone Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
| dst | string | Indicate if the timezone is subject to Daylight Saving Time |
| iana | string | IANA timezone name |
| iana_names | array | IANA timezone aliases |
| id | int | Timezone ID |
| label | string | Timezone name |
Object pushed to a your callback URL. Deprecated. See webhooks!
{
"data": {},
"datetime": "2020-04-24 00:42:42",
"try": 0,
"type": "CONFERENCE10_EVENT"
}| Property | Type | Description |
|---|---|---|
| data | object |
Push data Object: CONFERENCE10.Event |
| datetime | string |
Datetime related to the data pushed. Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
| try | int | Push try count. Starts at 1. Will try up to 10 times until the callback URL replies with a HTTP 2XX result code. |
| type | string |
Push type. Values: "CONFERENCE10_EVENT" |
Webhook object
{
"created_at": "2020-04-24 00:42:42.123",
"endpoint": "(string)",
"hash": "UNIQUEID",
"options": {},
"status": "ENABLED",
"type": "(string)",
"updated_at": "2020-04-24 00:42:42.123"
}| Property | Type | Description |
|---|---|---|
| created_at | string |
Date of creation Format: datetime_ms (YYYY-MM-DD HH:MM:SS.sss in UTC timezone. Example: "2012-04-24 23:42:00.123") |
| endpoint | string |
Endpoint URL Format: url (HTTP(S) URL) |
| hash | string |
Unique ID Format: hash (Unique object identifier) |
| options | object |
Options Object: Webhook.Options |
| status | string |
Status Values: "DISABLED", "DISABLED_ADMIN", "DISABLED_SYSTEM", "ENABLED" |
| type | string | Hook type |
| updated_at | string |
Date of update Format: datetime_ms (YYYY-MM-DD HH:MM:SS.sss in UTC timezone. Example: "2012-04-24 23:42:00.123") |
Webhook event object
{
"data": {},
"event_at": "2020-04-24T00:42:42.123Z",
"event_id": "(string)",
"hook_hash": "UNIQUEID",
"try": 0,
"type": "(string)"
}| Property | Type | Description |
|---|---|---|
| data | object | Webhook data |
| event_at | string |
Event time Format: datetime_ms_iso (YYYY-MM-DDTHH:MM:SS.sssZ in UTC timezone. Example: "2012-04-24T23:42:00.123Z" or "2012-04-24T23:42:00.123+00:00") |
| event_id | string | Unique event ID |
| hook_hash | string |
Webhook ID. Can be NULL if dynamic Webhook. Format: hash (Unique object identifier) |
| try | int | Push try number. Starts at 0. If push fails (you did not reply in time, or 200 < response code > 299), we try again and increment try. |
| type | string | Webhook type |
Webhook Credit event
{
"balance": "0.00",
"currency_code": "(string)",
"last_transaction_amount": "0.00",
"shutdown_limit": "0.00",
"warning_limit": "0.00"
}| Property | Type | Description |
|---|---|---|
| balance | string |
Current balance Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| currency_code | string | Currency code of your account ("EUR", "USD", etc.) |
| last_transaction_amount | string |
Amount of last transaction Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| shutdown_limit | string |
Shutdown limit Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
| warning_limit | string |
Warning limit Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
Webhook log search filters
{
"endpoint": "(string)",
"event_date": "(string)",
"event_id": "(string)",
"hook_hash": "(string)",
"http_code": "(string)",
"status": "(string)",
"try": 0,
"type": "(string)"
}| Property | Type | Description |
|---|---|---|
| endpoint | string | Search by endpoint |
| event_date | string | Search by event date |
| event_id | string | Search by event id |
| hook_hash | string | Search by hook id |
| http_code | string | Search by http code |
| status | string | Search by status |
| try | int | Search by try number 0..9 |
| type | string | Search by hook type |
Webhook options
{
"format": "(string)",
"hmac_algo": "MD5",
"hmac_secret": "(string)"
}| Property | Type | Description |
|---|---|---|
| format | string | Webhook format: "JSON" only for now. |
| hmac_algo | string |
Algorithm used for HMAC signature Values: "MD5", "SHA1", "SHA256", "SHA512" |
| hmac_secret | string | Secret used for HMAC signature. Length: 8..1024. |