Evo Voice

<back to all web services

GetAppConfig

Gets the config for the app including webRTC token

Requires Authentication
Required role:User
The following routes are available for this service:
GET/app/config
GetAppConfig Parameters:
NameParameterData TypeRequiredDescription
DeviceTypequeryDeviceTypesNoThe type of device you are requesting config for
PushCredentialSidquerystringNoUse a specific push credential SID
ApplicationSidquerystringNoUse a specific application SID
SandboxqueryboolNoIs this device operating in a sandbox environment? IOS only.
DeviceTypes Enum:
Web
iOS
Android
AppConfig Parameters:
NameParameterData TypeRequiredDescription
EndpointIdformstringNoThe ID of this endpoint
AccountIdformstringNoThe ID of the account
CustomerIdformstringNoThe customer ID associated with this user
AccessTokenformstringNoThe access token for use with Twilio Voice
IdentityformstringNoThe access token's identity
EmailAddressformstringNoThe email address of the user
UserInfoformAppUserInfoNoThe user's information
AgentStateformAgentStatesNoThe agent state (for call center users)
AgentStateReasonformAgentStateReasonsNoThe agent state reason
TabsformList<Object>NoThe tabs for the app
AppSettingsformAppSettingsNoThe app settings
ThirdPartyPhoneSystemSettingsformThirdPartyPhoneSystemSettingsNoThe phone settings for third party connectivity
AppUserInfo Parameters:
NameParameterData TypeRequiredDescription
FirstNameformstringNoThe user's first name
LastNameformstringNoThe user's last name
NameformstringNoShortcut to the user's full name
AvatarUrlformstringNoThe URL to the user's avatar
AgentStates Enum:
Unknown
Ready
NotReady
LoggedOut
WrapUp
Outgoing
Other
AgentStateReasons Enum:
Unknown
SetByUser
MissedCall
SetBySystem
AppSettings Parameters:
NameParameterData TypeRequiredDescription
EnablePhoneNumberManagementformboolNo
EnableDeviceManagementformboolNo
EnableDialerformboolNo
EnableCallHistoryformboolNo
ShowFileNameInMessageCenterformboolNo
ChakraThemeformstringNo
CustomCssformstringNo
PageTitleformstringNo
StringMappingsformstringNo
LogoutUrlformstringNo
PortMyNumberUrlformstringNo
ThirdPartyPhoneSystemSettings Parameters:
NameParameterData TypeRequiredDescription
TypeformThirdPartyPhoneSystemTypesNo
SipSettingsformThirdPartySipSettingsNo
DemoSettingsformThirdPartyDemoSettingsNo
ThirdPartyPhoneSystemTypes Enum:
Demo
Sip
ThirdPartySipSettings Parameters:
NameParameterData TypeRequiredDescription
AccountsformList<ThirdPartySipAccountSettings>No
ThirdPartySipAccountSettings Parameters:
NameParameterData TypeRequiredDescription
NumberformstringNo
AgentformstringNo
AuthNameformstringNo
UserNameformstringNo
DisplayNameformstringNo
PasswordformstringNo
UserDomainformstringNo
RegistrationExpiresformintNo
TransportTypeformTransportTypesNo
LocalIPformstringNo
LocalPortformintNo
SipServerformstringNo
SipServerPortformintNo
OutboundServerformstringNo
OutboundServerPortformintNo
StunServerformstringNo
StunPortformintNo
AudioPlaybackDeviceNameformstringNo
AudioRecordingDeviceNameformstringNo
AudioCodecsformList<AudioCodecTypes>No
DTMFMethodformDtmfMethodsNo
TransportTypes Enum:
UDP
TLS
TCP
PERS
AudioCodecTypes Enum:
NameValue
PCMU0
GSM3
PCMA8
G7229
G72918
ILBC97
AMR98
AMRWB99
SPEEX100
DTMF101
SPEEXWB102
ISACWB103
ISACSWB104
OPUS105
G7221121
NONE-1
DtmfMethods Enum:
RFC2833
INFO
ThirdPartyDemoSettings Parameters:
NameParameterData TypeRequiredDescription
ExtensionformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + 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: 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: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>