| Required role: | User |
| GET | /app/config |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| DeviceType | query | DeviceTypes | No | The type of device you are requesting config for |
| PushCredentialSid | query | string | No | Use a specific push credential SID |
| ApplicationSid | query | string | No | Use a specific application SID |
| Sandbox | query | bool | No | Is this device operating in a sandbox environment? IOS only. |
| Web | |
| iOS | |
| Android |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| EndpointId | form | string | No | The ID of this endpoint |
| AccountId | form | string | No | The ID of the account |
| CustomerId | form | string | No | The customer ID associated with this user |
| AccessToken | form | string | No | The access token for use with Twilio Voice |
| Identity | form | string | No | The access token's identity |
| EmailAddress | form | string | No | The email address of the user |
| UserInfo | form | AppUserInfo | No | The user's information |
| AgentState | form | AgentStates | No | The agent state (for call center users) |
| AgentStateReason | form | AgentStateReasons | No | The agent state reason |
| Tabs | form | List<Object> | No | The tabs for the app |
| AppSettings | form | AppSettings | No | The app settings |
| ThirdPartyPhoneSystemSettings | form | ThirdPartyPhoneSystemSettings | No | The phone settings for third party connectivity |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| FirstName | form | string | No | The user's first name |
| LastName | form | string | No | The user's last name |
| Name | form | string | No | Shortcut to the user's full name |
| AvatarUrl | form | string | No | The URL to the user's avatar |
| Unknown | |
| Ready | |
| NotReady | |
| LoggedOut | |
| WrapUp | |
| Outgoing | |
| Other |
| Unknown | |
| SetByUser | |
| MissedCall | |
| SetBySystem |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| EnablePhoneNumberManagement | form | bool | No | |
| EnableDeviceManagement | form | bool | No | |
| EnableDialer | form | bool | No | |
| EnableCallHistory | form | bool | No | |
| EnableAssistants | form | bool | No | |
| ShowFileNameInMessageCenter | form | bool | No | |
| ChakraTheme | form | string | No | |
| CustomCss | form | string | No | |
| PageTitle | form | string | No | |
| StringMappings | form | string | No | |
| LogoutUrl | form | string | No | |
| PortMyNumberUrl | form | string | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Type | form | ThirdPartyPhoneSystemTypes | No | |
| SipSettings | form | ThirdPartySipSettings | No | |
| DemoSettings | form | ThirdPartyDemoSettings | No |
| Demo | |
| Sip |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Accounts | form | List<ThirdPartySipAccountSettings> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Number | form | string | No | |
| Agent | form | string | No | |
| AuthName | form | string | No | |
| UserName | form | string | No | |
| DisplayName | form | string | No | |
| Password | form | string | No | |
| UserDomain | form | string | No | |
| RegistrationExpires | form | int | No | |
| TransportType | form | TransportTypes | No | |
| LocalIP | form | string | No | |
| LocalPort | form | int | No | |
| SipServer | form | string | No | |
| SipServerPort | form | int | No | |
| OutboundServer | form | string | No | |
| OutboundServerPort | form | int | No | |
| StunServer | form | string | No | |
| StunPort | form | int | No | |
| AudioPlaybackDeviceName | form | string | No | |
| AudioRecordingDeviceName | form | string | No | |
| AudioCodecs | form | List<AudioCodecTypes> | No | |
| DTMFMethod | form | DtmfMethods | No |
| UDP | |
| TLS | |
| TCP | |
| PERS |
| Name | Value | |
|---|---|---|
| PCMU | 0 | |
| GSM | 3 | |
| PCMA | 8 | |
| G722 | 9 | |
| G729 | 18 | |
| ILBC | 97 | |
| AMR | 98 | |
| AMRWB | 99 | |
| SPEEX | 100 | |
| DTMF | 101 | |
| SPEEXWB | 102 | |
| ISACWB | 103 | |
| ISACSWB | 104 | |
| OPUS | 105 | |
| G7221 | 121 | |
| NONE | -1 |
| RFC2833 | |
| INFO |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Extension | form | string | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /app/config HTTP/1.1 Host: team.evovoice.io Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length
<AppConfig xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.App">
<AccessToken>String</AccessToken>
<AccountId>String</AccountId>
<AgentState>Unknown</AgentState>
<AgentStateReason>Unknown</AgentStateReason>
<AppSettings xmlns:d2p1="http://schemas.datacontract.org/2004/07/Voice.Api.Customers">
<d2p1:ChakraTheme>String</d2p1:ChakraTheme>
<d2p1:CustomCss>String</d2p1:CustomCss>
<d2p1:EnableAssistants>false</d2p1:EnableAssistants>
<d2p1:EnableCallHistory>false</d2p1:EnableCallHistory>
<d2p1:EnableDeviceManagement>false</d2p1:EnableDeviceManagement>
<d2p1:EnableDialer>false</d2p1:EnableDialer>
<d2p1:EnablePhoneNumberManagement>false</d2p1:EnablePhoneNumberManagement>
<d2p1:LogoutUrl>String</d2p1:LogoutUrl>
<d2p1:PageTitle>String</d2p1:PageTitle>
<d2p1:PortMyNumberUrl>String</d2p1:PortMyNumberUrl>
<d2p1:ShowFileNameInMessageCenter>false</d2p1:ShowFileNameInMessageCenter>
<d2p1:StringMappings>String</d2p1:StringMappings>
</AppSettings>
<CustomerId>String</CustomerId>
<EmailAddress>String</EmailAddress>
<EndpointId>String</EndpointId>
<Identity>String</Identity>
<Tabs xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d2p1:anyType />
</Tabs>
<ThirdPartyPhoneSystemSettings xmlns:d2p1="http://schemas.datacontract.org/2004/07/Voice.Api.Endpoints">
<d2p1:DemoSettings>
<d2p1:Extension>String</d2p1:Extension>
</d2p1:DemoSettings>
<d2p1:SipSettings>
<d2p1:Accounts>
<d2p1:ThirdPartyPhoneSystemSettings.ThirdPartySipSettings.ThirdPartySipAccountSettings>
<d2p1:Agent>String</d2p1:Agent>
<d2p1:AudioCodecs>
<d2p1:ThirdPartyPhoneSystemSettings.ThirdPartySipSettings.AudioCodecTypes>PCMU</d2p1:ThirdPartyPhoneSystemSettings.ThirdPartySipSettings.AudioCodecTypes>
</d2p1:AudioCodecs>
<d2p1:AudioPlaybackDeviceName>String</d2p1:AudioPlaybackDeviceName>
<d2p1:AudioRecordingDeviceName>String</d2p1:AudioRecordingDeviceName>
<d2p1:AuthName>String</d2p1:AuthName>
<d2p1:DTMFMethod>RFC2833</d2p1:DTMFMethod>
<d2p1:DisplayName>String</d2p1:DisplayName>
<d2p1:LocalIP>String</d2p1:LocalIP>
<d2p1:LocalPort>0</d2p1:LocalPort>
<d2p1:Number>String</d2p1:Number>
<d2p1:OutboundServer>String</d2p1:OutboundServer>
<d2p1:OutboundServerPort>0</d2p1:OutboundServerPort>
<d2p1:Password>String</d2p1:Password>
<d2p1:RegistrationExpires>0</d2p1:RegistrationExpires>
<d2p1:SipServer>String</d2p1:SipServer>
<d2p1:SipServerPort>0</d2p1:SipServerPort>
<d2p1:StunPort>0</d2p1:StunPort>
<d2p1:StunServer>String</d2p1:StunServer>
<d2p1:TransportType>UDP</d2p1:TransportType>
<d2p1:UserDomain>String</d2p1:UserDomain>
<d2p1:UserName>String</d2p1:UserName>
</d2p1:ThirdPartyPhoneSystemSettings.ThirdPartySipSettings.ThirdPartySipAccountSettings>
</d2p1:Accounts>
</d2p1:SipSettings>
<d2p1:Type>Demo</d2p1:Type>
</ThirdPartyPhoneSystemSettings>
<UserInfo>
<AvatarUrl>String</AvatarUrl>
<FirstName>String</FirstName>
<LastName>String</LastName>
<Name>String</Name>
</UserInfo>
</AppConfig>