Howto:Billboard - Wecom - Partner App

FIXME: Work in progress, still incomplete

Partner App Info
Billboard Icon
Name	Billboard
Company	Wecom
Version	1.0
License	Via Innovaphone Pricelist
Languages	Czech, English, Estonian, French, German, Italian, Polish, Portuguese, Slovenian, Spanish

Product Name

Billboard Link

Certification Status

Space dedicated to Billboard certification information.

Category

Space dedicated to Billboard category information.

Vendor

Wecom's logo

Wecom

• wecom.com.br

Description

Billboard is a Partner App developed by Wecom to modernize internal communications by digitizing traditional bulletin boards. Through a user-friendly interface integrated into Innovaphone’s myApps workspace, departments (referred to as "groups" within the app) can publish announcements with scheduled validity, targeted visibility, and interaction tracking.

Main components:

• Users App – For general users to access and interact with department posts.
• Admin App – For administrators to manage groups, posts, and licensing.

Functions

Users App

The Users App is the interface where users access, read, create, and manage department posts, based on their permissions (viewer or editor). Each user sees only the groups they are part of.

1. Accessing a Group

1. Upon opening the Users App, the main screen lists all groups (departments) the user belongs to.
2. To enter a group, simply click on the desired group.

   Groups are color-coded and may display badges for new or unseen posts.

   

   Users App main page with every group you are on

2. Creating a Group (Admins only)

1. Only users assigned with the "create department" permission (via Admin App) will see the Add+ button on the main screen.

   

   Groups page with "+ Add" button outlined

2. Click Add+ to open the group creation modal.
3. Fill in:
   • Enter the Department Name
   • Select the color using the color picker
   • Assign users to roles:
     • Editor – Can manage posts, see group's history and edit the department.
     • Viewer – Can only view posts.
   • Clicking "Viewer" name label selects all users as viewers.

     

     Group creation modal with roles selection, color picking and name input

3. Viewing a Post

1. Inside a group, posts are displayed as cards.

   

   Posts inside a group

   • If you are an Editor, the post will also show the visibility period on the bottom of the card.
   • Unread posts display a red NEW label in the top-left corner of the card.
     • The label disappears as soon as the post is opened.

       

       New post with visibility period

2. Click on a post to open its details.

   

   Open post with information and description

3. The post view shows:
   • Type (External or Internal)
   • Creator's name
   • Start and end dates of visibility
4. To close the post, click the X button in the top right corner.

4. Creating a Post

1. Editors will see an Add+ card within the department page.

   

   Posts on a group with Editor view, with "Add+" card

2. Click it to open the post creation modal.
3. Fill in the following:
   • Title (top input)
   • Description (main text area)
   • Start and end dates

     

     Post start and end date time picking

   • Type (Internal or External)

     

     Type drop down selection

   • Color (default is black if not selected)

     

     Post and group color picker

4. Click Insert to save or Close to cancel.

   

   Post creation and editing modal

5. Editing or Deleting a Post

1. If you are the creator or an editor of the group:
   • Click the pencil icon to edit – the modal opens pre-filled with existing data.
   • Click the trash icon to delete – the post is removed immediately.

     

     Post view as Editor with actions outlined

6. Viewing Post History

1. Inside the post, click the Clock icon to view who has accessed it.
   • The view shows user names and access timestamps.
   • A back arrow icon replaces the clock to return to the post details.

     

     Post history of who has viewed and when

7. Managing Groups (Editor role)

• Editors see extra options in the bottom menu of the department page.

  

  Posts on a group as an Editor with bottom menu outlined

1. Click the trash icon to delete the group.
2. Click the clock icon to access post history.
   • You can filter posts:
     • By time period (Today, Last 7 days, Custom...)
     • By deleted or active status

       

       Group's posts history drop down time filter

       

       Group's posts history time filter with custom period time picking

3. Click the gear icon to edit group settings:
   • Change the name or color
   • Modify members and their roles

     

     Group editing modal with users and their roles that were previous selected

Admin App

The Admin App provides global management functionalities for users, groups (departments), and posts. Only users marked as administrators via this panel will have access to it.

1. Granting Administrator Access

1. Access the Admin App – it will open on the Users Page by default.
2. Use the search bar at the top to find the user you wish to promote.
3. Locate the user in the list below.
4. Click the checkbox next to their name to grant administrator privileges.

Only an existing admin can assign admin rights to another user.

Users Page with search bar and checkboxes for admin privileges

2. Viewing the Billboard License Information

1. In the Admin App sidebar, click on the Licensing tab.
2. The page will display information related to the current license.

• System Token: Unique identifier for the system, used for license validation.
• Active License: Indicates if the license is active (e.g., Temporary).
• Billboard Install Date: Shows the exact date and time when the Billboard app was installed.
• Licenses in Use: Displays the number of users currently using the Billboard Apps.

Licensing page showing all license details

3. Managing Departments

1. In the Admin App sidebar, click on the Departments tab.
2. Browse the list of all departments created in the system.
3. Scroll to locate the department you wish to edit.
4. Click on the color circle next to the department to open the editing modal.
5. In the modal:
   1. Update the department's name.
   2. Change its color using the color picker.
   3. Add or remove users as Editors or Viewers.
   4. Save the changes to apply them.

Group management modal

• The list includes all departments, including those marked as deleted.
• Deleted departments are labeled with their deletion date.
• Each department entry shows:
  • Department name
  • Assigned color
  • Creator's name
  • Status (active or deleted)

Departments list with edit modal access

4. Managing Posts

1. Click on the Posts tab in the Admin App sidebar.
2. Browse the full list of posts created across all departments.
3. Scroll to locate a specific post.
4. Click the edit icon next to a post to open the editing modal.
5. In the modal:
   1. Modify the title, description, color, type, and visibility period.
   2. Save the changes to update the post.

Post management modal

• The post list includes:
  • Active posts
  • Expired posts
  • Deleted posts (showing the deletion date)
• Each post displays:
  • Title
  • Department (group) association
  • Type: Internal or External
  • Start and end dates (visibility period)
  • Creator's name
  • Current status: active, expired, or deleted

All posts view with status, creator, and edit access

5. Accessing Public Posts

1. In the sidebar, click on the Public Posts tab.
2. A modal will appear, redirecting you to the Billboard Users App to view a list of posts.
3. Click on any post from this list.

• Only posts with the "External" type selected during creation appear here.
• This page is read-only and used for quick access to public content.

Public posts modal with redirect to Users App

Component Diagram

The diagrams below illustrate the architecture of the Billboard application and its interaction with the Innovaphone platform, as well as the various components involved.

User and Admin Interaction Flow

Flow Overview:

• ADMIN: The administrator has the ability to manage groups and posts across the system, including controlling visibility and user access.
• DEPARTMENT (Group): Represents different groups (like IT and HR), each having specific announcements and user interactions.
• NOTES: Each group can have specific notes (e.g., IT or HR), which are shown to relevant users.
• USERS: Users from various groups (IT, HR, and General) can access posts that are published within their allowed groups.

Application Architecture

Flow Overview:

• PBX Platform: Interacts with the Billboard App, managing internal communication and service integration.
• APP Platform: Hosts the Billboard Service, which manages posts and user interactions, and communicates with the database.
• Service DWC: Responsible for managing the backend services for the Billboard app, providing routes to interact with both the database and the PBX platform.

This architecture shows how the components integrate within the Innovaphone ecosystem, allowing for seamless communication between groups and users through the Billboard app.

Licensing

Billboard is licensed via the Innovaphone Pricelist.

License type: Innovaphone Pricelist License model: One license per user Trial: 30 days temporary license available after installation

Listed at: https://www.innovaphone.com/en/services/licenses/partner-apps.html?app=Billboard&type=license#billboard

Prerequisites

System Requirements

• Innovaphone firmware: 14r1 or later
• Innovaphone App Platform with myApps
• PBX Manager for app registration

Licensing Activation

• Requires license token and file provided by Wecom
• Insert into Admin interface for activation

Versions

• Current version: 1.0
• Latest release: 1011 final
• Release date: June 17, 2025
• Innovaphone compatibility: Yes
• Architectures supported: arm, x86_64, arm64

Installation

Follow the steps below to install the Billboard application in your Innovaphone environment.

Option 1: Installing via AP Manager App Store (Recommended)

You can install Billboard directly through the App Platform Manager (AP Manager) by accessing the App Store:

1. Open the AP Manager.
2. Click the yellow App Store button in the top-right corner.
3. Search for Billboard in the list.
4. Click on it to open further information
5. Select the latest version and confirm the download.
6. The app will be automatically installed and ready to configure.

🛈 This is the easiest and fastest way to deploy the app.

AppStore Button in AP Manager outlined

AP Manager Appstore interface with actions outlined

Option 2: Manual Installation via Upload

If you prefer installing manually, follow the steps below:

Step 1: Download the App Package

1. Visit the official Wecom myApps Downloads Portal.
2. Find the Billboard app.
3. Download the latest available version compatible with your system architecture.

Billboard on MyApps' Wecom's App Store

Step 2: Upload to AP Manager

1. In AP Manager, click App upload (top right).
2. Select the .app package you downloaded from the portal.
3. After successful upload, the app will appear in your list and show as Running.

App Upload button on AP Manager outlined

Billboard on AP Manager

Uploading Billboard on Ap Manager

Step 3: Add Application Instance

1. After uploading the app, click the yellow + Add button to create an instance of the application.
2. Fill in the required fields:
   • Name: A recognizable name for the instance.
   • Domain: The domain for the PBX.
   • Password: A secure admin password for the app instance.
   • Webserver path: Optional path (or leave blank).
   • Database host: Leave empty for local DB or specify IP/DNS if external.
   • Database name and Database user: Use consistent values for your environment.
   • Database password: Corresponding DB password.
3. When all values are filled, click Save.

Example of instance creation screen in AP Manager

Final Step: Registering the App in PBX Manager

1. Open the PBX Manager.
2. Go to the Apps section.
3. Click Add App and register:
   • A Users App
   • An Admin App
4. Assign access rights as needed.

PBX Manager Add an App app selection

PBX Manager Add an App configuration

Billboard on PBX Manager configured

⇒ After registration, both apps will appear in MyApps and are ready for use.

Copyright

Space dedicated to Flowe copyright information.

Contact

• PORTO ALEGRE - RS

Av. Carlos Gomes, 466 / 401

Boa Vista - CEP 90480-000

Tel: +55 51 3079.5000

• FLORIANÓPOLIS - SC

SC 401, 8600 - Room 7

Corporate Park - Block 2

Santo Antônio de Lisboa

CEP 88050-001

Tel: +55 48 3112.6200

Mail: comercial@wecom.com.br

Support: suporte@wecom.com.br

Website: wecom.com.br

For any questions please refer to our contact page.