How do I set the domain/host in external provisioning?

Use the host value in Account XML to set your SIP domain when your plan includes Open White Label or the Unlimited subdomains feature; otherwise, the app uses the portal’s configured domain.

When can you set the host via External Provisioning?

You can do so for softphone projects that select the Open White Label set or any set that includes the unlimited subdomains feature:

  • Open White Label bundle allows you to provision any domain you want.
  • Unlimited subdomains: You can set different subdomains under one suffix (for example, pbx1.somesuffix.comnewyork.somesuffix.comcompanyname.somesuffix.com).

These values are returned by your External Provisioning service as Account XML that the app merges with portal defaults.

Learn how the merge works in the provisioning flow: External Provisioning.

For both cases, the host parameter in the account XML is used to set the domain name.

Note

For more information about the host parameter, refer to Acrobits Account XML documentation at doc.acrobits.net/cloudsoftphone/account.html#host.

How to set it

Return the desired domain as <host>your.domain.tld</host> in your Account XML response. Keep it simple and consistent with your SIP infrastructure.

When you cannot set the host here

For Cloud Softphone projects do not select Open White Label or the unlimited subdomains feature, the app uses the domain configured in the Provisioning options section in your app in the Cloud Softphone web portal.

For where this fits in the overall setup, see: Provisioning introduction. And for information about the methods of provisioning, please visit this page