Troubleshooting & Technical Reference

๐Ÿง  General Information to Collect

When reporting or diagnosing an issue, please include:

  • Username(s) involved

  • Time of error occurrence

  • Event(s) affected

  • Is the issue repeatable?

  • Mobile app version number

  • Any additional context (e.g., duplicated event, first-time setup, etc.)


 

โšก Live Updates Not Working

Checks:

  1. Does the dashboard live update outside the corporate network?

    • โœ… Works outside โ†’ Possible firewall issue.

  2. Has the customer whitelisted / allow-listed *.prod.wbim.io?

  3. Are some areas updating while others are not?

    • Specify which areas are affected.

  4. Has anyone seen an โ€œofflineโ€ error message?


 

๐Ÿ“ง Can't Set User Emails on a New Account

  • The account must have a master email set before assigning user emails.


 

๐Ÿ“‹ Can't Update Tasks (v1)

  • Tasks in v1 cannot be updated.

  • To resolve: Delete and re-create the task.

  • This will be flexible in v2.


๐ŸŒ Network Connectivity & Firewall Requirements

Halo communicates with the following domains:

Primary Domains:

*.halosystem.cloud
control-api.prod-pool-1.halosystem.cloud
data-api.prod-pool-1.halosystem.cloud
media.prod-pool-1.halosystem.cloud

WBIM Domains:

*.prod.wbim.io
apiv2.prod.wbim.io
clientapi.prod.wbim.io
doclibapi.prod.wbim.io
fileapi.prod.wbim.io
formsapi.prod.wbim.io
locws.prod.wbim.io
tasksapi.prod.wbim.io

AWS Resources: 

*.amazonaws.com
prod-halo-client-doclib.s3.eu-west-2.amazonaws.com
halo-v5prod-images.s3.eu-west-2.amazonaws.com

Note:
If using software that inspects or re-encrypts HTTPS traffic (e.g., SSL inspection) or modifies the HOST header, these domains may need to be bypassed.

 


 

๐Ÿ” Realtime Updates

Halo uses persistent WebSocket connections from:

apiv2.prod.wbim.io
locws.prod.wbim.io
tasksapi.prod.wbim.io
data-api.prod-pool-1.halosystem.cloud

These connections are required for normal operation.

 


 

๐Ÿ”ฎ Future-Proofing Notice

All domains will gradually be consolidated under:

<subdomains>.halosystem.cloud

CORS will only allow requests from:

my.halosystem.cloud
halosystem.cloud

 


 

๐Ÿ“ฑ Device Compatibility

Minimum Supported Versions:

  • iOS: 13.4+

  • Android: 11+

Recommended for new hardware purchases:

  • iOS: 16+

  • Android: 13+