Using QR Codes – SessionTalk Docs

Simplify setup for your users

If you don’t have your own provisioning server you can still use QR codes to save users entering credentials. Simply embed the credentials in the QR code in the format specified below and email the QR code to your end user. They will simply scan the code and the softphone will be ready to use.

Generic Apps


scloc:providerId| {   "sipaccounts" : [ { "sipusername" : "user1" , "sippassword": "29de?8", "subdomain" : "pbx"} ] }

Whitelabel Apps


scloc: {   "sipaccounts" : [ { "sipusername" : "user1" , "sippassword": "29de?8", "subdomain" : "pbx"} ] }

Additional parameters available are shown below


scloc:  {   "sipaccounts" : [ {
   "sipusername" : "user1" ,
   "sippassword": "29de?8",
   "subdomain":"pbx" ,
   "authusername": "629456",
   "transport" : "UDP",
   "srtp" : "Enabled" ,
   "messaging" : "Enabled",
   "video" : "Enabled" ,
   "callrecording" : "Enabled"
   } ] }

Multiple SIP accounts may be passed as separate entries in json array

XMPP Accounts

XMPP messaging accounts can be included in the QR code alongside SIP accounts. Add an xmppaccounts array to the JSON payload:


scloc: {
  "sipaccounts" : [
    { "sipusername" : "user1", "sippassword": "29de?8" }
  ],
  "xmppaccounts" : [
    {
      "jid": "user1@chat.example.com",
      "password": "xmpp_password",
      "domain": "chat.example.com"
    }
  ]
}

Example with all optional XMPP parameters:


scloc: {
  "sipaccounts" : [
    { "sipusername" : "user1", "sippassword": "29de?8" }
  ],
  "xmppaccounts" : [
    {
      "jid": "user1@chat.example.com",
      "password": "xmpp_password",
      "domain": "chat.example.com",
      "server": "xmpp.example.com",
      "port": 5222,
      "resource": "",
      "usetls": true,
      "verifycert": true,
      "priority": 5,
      "displayname": "User One",
      "accountname": "Work XMPP"
    }
  ]
}

Parameter	Required	Description
jid	Yes	XMPP address (e.g. user@chat.example.com)
password	Yes	XMPP account password
domain	Yes	XMPP service domain
server	No	Server host override. If blank, resolves via DNS SRV
port	No	XMPP server port (default: 5222)
resource	No	XMPP resource identifier for multi-device support
usetls	No	Enable TLS encryption (default: true)
verifycert	No	Verify server TLS certificate (default: true)
priority	No	XMPP presence priority, -128 to 127 (default: 5)
displayname	No	Display name for the XMPP account
accountname	No	Friendly label for the XMPP account

Multiple XMPP accounts may be passed as separate entries in the array. The softphone will automatically connect to the XMPP server after scanning the QR code.