--- title: "Wallboards FAQ and Troubleshooting" slug: "wallboards-faq-and-troubleshooting" tags: ["Errors", "FAQs", "Admin", "Troubleshooting", "Wallboards"] updated: 2026-11-13T17:09:54Z published: 2026-11-13T17:09:54Z canonical: "docs.natterbox.com/wallboards-faq-and-troubleshooting" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.natterbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Wallboards FAQ and Troubleshooting This article answers the most common questions about Natterbox Wallboards and explains how to resolve the issues and error messages you are most likely to encounter. Use the sections below to find the area you need. ## Displaying And Accessing Wallboards **How do I prevent timeouts when a wallboard is on public display?** When using a wallboard for public display, create a **read-only link** and run it from a new tab (outside Salesforce). The wallboard is then unaffected when the Salesforce session expires and will keep running. **How do non-Salesforce users access wallboards?** Non-Salesforce users must first be given a Salesforce Chatter Free licence, then added as a Natterbox User (no Natterbox licence is required). They use these Chatter Free credentials to log in to Wallboards via Flight Deck. **How do I sign in with SSO from a wallboard read-only link?** If your organisation has SSO enabled in its Salesforce account, follow these steps to log in using your SSO provider (for example Google or LinkedIn) from a wallboard read-only link: 1. Click **Sign in** on the Natterbox login page. ![Natterbox login page Sign in button](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/faq-part-2-image-f9inc2i9.png?sv=2026-02-06&spr=https&st=2026-11-20T20%3A41%3A07Z&se=2026-11-20T21%3A41%3A07Z&sr=b&sp=r&sig=TJZJQHzdkADTFeBTTmjWasP2hBTuavHB250tpJ8Sb0w%3D) 2. Select **Use Custom Domain** on the Salesforce login page. ![Salesforce login page Use Custom Domain option](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/faq-part-2-image-m6563z47.png?sv=2026-02-06&spr=https&st=2026-11-20T20%3A41%3A07Z&se=2026-11-20T21%3A41%3A07Z&sr=b&sp=r&sig=I9k7IFKHkjyWzOydY1vKkkKCNwc8ZDq%2B2d6r6mdf2tM%3D) 3. Enter your company’s Salesforce domain name and click **Continue**. ![Enter Salesforce custom domain name](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/faq-part-2-image-pva2c54z.png?sv=2026-02-06&spr=https&st=2026-11-20T20%3A41%3A07Z&se=2026-11-20T21%3A41%3A07Z&sr=b&sp=r&sig=IUBs0G1JysIodAisu1C0LLrg9oyz8tn%2FKu0k8%2Bhf5VA%3D) 4. Log in to Wallboards using the SSO provider configured by your organisation. ![Log in using your organisation's SSO provider](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/image-1755902225729.png?sv=2026-02-06&spr=https&st=2026-11-20T20%3A41%3A07Z&se=2026-11-20T21%3A41%3A07Z&sr=b&sp=r&sig=0Xm%2F9hzaVzwdxogOvsHVxBA23zwsFF49ltQLCgLWsT8%3D) > [!NOTE] > ℹ️ > > **Note:** If you have already signed in to Salesforce in another tab (with or without SSO), opening a read-only link afterwards will log you in automatically without any prompt. **How can I make sure a user only has access to a single wallboard?** Give the user a read-only wallboard URL. This gives them access to just that specific wallboard and stops them navigating to any other wallboard or changing its configuration. You can revoke access at any time by disabling the URL link in the wallboard settings. ## Wallboard Groups **Why can’t I add more wallboards to my wallboard group?** A single wallboard group can contain a maximum of 10 wallboards. To display more information beyond this, either create additional wallboard groups or add more components to the individual wallboards. **What happens if I delete a wallboard that is used in a wallboard group?** Deleting a wallboard that belongs to a wallboard group removes it from the step it was associated with and introduces an artificial 30-second delay at that step. It is therefore recommended to review any groups that featured the wallboard and tidy up the steps to prevent this delay. ## Agents, Queues And Availability **My user is in wrap up but is being sent another call – why?** Wrap-up time applies to the individual call queue rather than to the agent. This means an agent can still receive a call from any other call queue they are assigned to, and will also continue to receive internal calls and direct-dial calls while on wrap up. **Not all my agents are showing in the Agent List – why?** First, check that you have selected the queue you intend to view, as agents can be associated with multiple queues – double-check the Agent List configuration to be sure. Also, if an agent has been created and associated with a call queue recently, that queue may not be up to date yet. The queue is updated each time a call goes into it, so you will need to perform a page refresh. **Some components ask me to select a group and others a call queue – what is the difference?** A group is a set of agents, whereas a call queue can dial a set of groups. When you view calls going into a queue, you select a queue, which returns all groups associated with that queue and all the agents associated with those groups. When you view stats on when users log in and out, or stats on all calls from agents, you select a group, as these stats are independent of call queues. **Why do my agents’ avatars disappear sometimes?** Avatars disappear when the user’s Salesforce session has expired. To resolve this, the user simply needs to log out of Salesforce and back in. **Can I align my agents to an office floor plan?** No – this is not something that is available in Wallboards. ## Data, Display And Configuration **How close to real time is the wallboard?** Wallboards update every few seconds. The response from the server depends on several factors, including: - internet speed - the time the server takes to answer the request - how many requests are being made **What’s the maximum number of results I can see on the Agent Login component?** The maximum value is 100. If you try to exceed this, a message asks you to limit the value to no more than 100. **Can I download data from a wallboard?** Yes. Data on when users log in to and out of their groups, or change their Availability State, can be exported as a CSV file from the Agent Login and Agent Status components in the configuration settings. **Can I change the branding on wallboards?** No – wallboard branding is not currently configurable. **How do I match data between wallboards and the Natterbox Call Reporting object?** See [Wallboards and the Natterbox Call Reporting Object](/docs/wallboards-and-the-natterbox-call-reporting-object) for details of how to retrieve the same information from the Natterbox Call Reporting object within Salesforce. **I can’t see the Wallboards tab in the Natterbox app – why?** You may not have the correct permissions, you need to be a Natterbox team lead or admin. If you aren’t sure, search for it in the Salesforce app launcher (3×3 dots). If you can’t see it, you likely are a ‘basic’ user and can only view wallboards via a read-only link. ## Error Logs And Troubleshooting Service-related issues with Wallboards are recorded in the Natterbox app’s error logs. To view them, go to **Natterbox App → Admin Home → Error Logs**. Each entry also shows which user(s) are affected and how often. ![Natterbox error logs panel](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/faq-part-2-image-ewjcoy34.png?sv=2026-02-06&spr=https&st=2026-11-20T20%3A41%3A07Z&se=2026-11-20T21%3A41%3A07Z&sr=b&sp=r&sig=90Xro7tTUeqbRNV9bTswdSfDXbZ9C9AcplpuwO4%2FPLs%3D) Most entries are one-off and caused by temporary connection issues. If an error repeats – particularly one involving saving to or loading from the Natterbox service – it is best raised with Natterbox. The table below explains the most common entries and what to do about them. | Error log message | What it means | What to do | | --- | --- | --- | | Load Wallboards / Loads Wallboards config – Network Error | A temporary connection issue has caused the request to load a wallboard to fail. | Usually a one-off – try loading the wallboard again. If it keeps happening, raise it with Natterbox. | | The user [X] with ID [Y] had (failed to connect to Natterbox) in the past 10 minutes | Salesforce and Natterbox have temporarily lost connection. | Usually a temporary connection issue. If it repeats, raise it with Natterbox. | | The user [X] with ID [Y] had {403} in the past 10 minutes | The user has had a connection dropout. | Usually temporary – the user should reload the wallboard. If it repeats, raise it with Natterbox. | | User [X] with ID [Y] attempted to access Wallboard/Wallboard Group which is not allowed | The user does not have access to that wallboard or wallboard group but reached it via the URL – typically because access was granted and later revoked. | Check the user’s wallboard permissions. | | User [X] with ID [Y] is not able to save Wallboard/Wallboard Group | The save action failed, often because of a sudden permission change. | Check that the affected user has the right level of access. | | User [X] with ID [Y] is not able to load Wallboard/Wallboard Group | The load action failed – either a permission change, or the wallboard/group has been removed (the user was viewing an outdated list, or using a URL to a wallboard that no longer exists). | Check the user’s access and confirm the wallboard or group still exists. | | A Wallboard/Wallboard Group is no longer able to update from the backend | The save action failed – usually a permission change or, more likely, a service issue between Salesforce and Natterbox. | Check access. If the problem continues, raise it with Natterbox. | When a wallboard fails to load, the user may see an on-screen message such as these examples: ![Wallboard network error on-screen message](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/faq-part-2-image-dm6ny1d0.png?sv=2026-02-06&spr=https&st=2026-11-20T20%3A41%3A07Z&se=2026-11-20T21%3A41%3A07Z&sr=b&sp=r&sig=nHNRHU8bpGKVv8bZKIGkdzmiPejhV0GLX7VbKi5zhiY%3D) **Why does my wallboard show Error 404?** An Error 404 when trying to access a wallboard means that particular wallboard can no longer be found. This usually happens for one of two reasons: - the wallboard has since been deleted (by an admin) - the wallboard was never actually saved ![Wallboard Error 404 message](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/faq-part-3-image-yh0dxzzk.png?sv=2026-02-06&spr=https&st=2026-11-20T20%3A41%3A07Z&se=2026-11-20T21%3A41%3A07Z&sr=b&sp=r&sig=l3dq6hHkTFAFa%2FURANT%2B%2FLt4lqOgsrLzzjfC6Y2QBlM%3D) **Why am I getting an OAuth error when I try to sign in?** You may see the following message when trying to sign in: “We can't authorize you because of an OAuth error. For more information, contact your Salesforce administrator. OAUTH_APPROVAL_ERROR_GENERIC: An unexpected error occurred during authentication. Please try again.” ![Salesforce OAuth error message indicating authorisation failure](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/image002%20(2)(1).png?sv=2026-02-06&spr=https&st=2026-11-20T20%3A41%3A07Z&se=2026-11-20T21%3A41%3A07Z&sr=b&sp=r&sig=W86HtdvTw1bQj%2B97OU8nqEJXEDm4ioyPjWs73Az7EmA%3D) To resolve this, you need to install the Natterbox Freedom OAuth app. See [How to install the Natterbox Freedom OAuth app](/docs/install-natterbox-freedom-oauth-app) for step-by-step instructions. ## Related - [Wallboard Best Practices and Scenarios](/wallboard-best-practices-and-scenarios.md) - [Wallboard System Requirements](/wallboard-system-requirements.md) - [Wallboards and the Natterbox Call Reporting Object](/wallboards-and-the-natterbox-call-reporting-object.md) - [Wallboard Settings](/wallboard-settings.md) - [Wallboard/Wallboard Group Permissions](/wallboard-permission-levels.md) - [Wallboard Components and their Configuration](/wallboard-components-and-their-configuration.md) - [Wallboard Groups](/wallboard-groups.md)