AlmaIQ_Updated

AlmaIQ is an intelligent virtual concierge designed to live where employees already work: inside Microsoft Teams.
It is an artificial intelligence layer built on top of the Collective IQ® DEX (Digital Employee Experience) data platform, allowing employees and IT teams to talk directly to environment data using natural language.

Through a simple chat conversation, AlmaIQ can:

• Understand questions about the hardware of the device (performance, capacity, health, bottlenecks)
• Check installed software and versions
• Provide insights about business applications (status, usage, incidents, dependencies)
• Analyze aspects of collaboration (usage and quality of tools such as Microsoft Teams)
• Present and explain DEX scores (digital employee experience indicators and trends)

Beyond raw data, AlmaIQ combines:

• Device and experience data from Collective IQ DEX®
• Organizational knowledge from AlmaKnowledge, where IT teams can add articles, procedures, documents, and URLs

AlmaIQ has a clear focus on operational and contextual support:
helping employees understand their devices, applications, and processes, and guiding them toward the best way to solve problems or use other tools when appropriate.
It can enhance simpler answers with extra details, perform translations, and answer in the requester’s language, always grounded in the organization’s data and knowledge.

To use AlmaIQ in Microsoft Teams, the following requirements must be met:

• An Azure AD (Entra ID) administrator must perform the integration
• The AlmaAI® integration must be configured in Collective IQ® DEX

📍 CIQ DEX navigation path:
Collective IQ DEX > Administrative Settings > Integrations > AlmaAI®

Log in to the Azure Portal using an administrative account:
https://portal.azure.com

From Azure Services, select App registrations.

In the top menu, click + New registration.

On the Register an application screen, configure the following:

• Name: AlmaIQ
• Supported account types:
  Accounts in any organizational directory (Any Azure AD directory – Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)
• Redirect URI (Web):

LAD1:
https://lad1-ciq.almaden.app/integration

LAD2:
https://lad2-ciq.almaden.app/integration

Click Register to complete the process.

After the application is created, copy the Application (client) ID shown on the application overview page.

Paste this value into:
CIQ > Administrative Settings > Integrations > AlmaAI®

1. In the application’s left menu, click Certificates & secrets
2. Click + New client secret

1. Fill in:
   • Description: Alma
   • Expires: 24 months
2. Click Add

1. Immediately copy the value displayed in the Value field
   ⚠️ The secret value cannot be viewed again after leaving the page.

Paste the secret into:
CIQ > Administrative Settings > Integrations > AlmaAI®

1. In the left menu, click API permissions
2. Click + Add a permission

1. Select Microsoft Graph
2. Choose Delegated permissions

Add the following permissions:

AppCatalog

• AppCatalog.ReadWrite.All
• AppCatalog.Submit

AccessReview / Directory

• AccessReview.Read.All
• Directory.Read.All

Files

• Files.ReadWrite.All

User

• User.Read.All

Look for “Directory” and select the “Directory” permission “Read.All”.

Under API permissions, click APIs my organization uses

Search for App Studio for Microsoft Teams

Select Delegated permissions

Enable:

• AppDefinitions.ReadWrite
• Cards.ReadWrite

After all permissions are added:

1. Click Grant admin consent
2. Confirm by clicking Yes
3. Wait for the message “Grant consent successful”

This message confirms that all required permissions have been successfully applied.

📷 Insert image – Grant admin consent

Add a new app.
Microsoft Teams> + Apps

Search for “AlmaIQ” and add the app.

AlmaIQ will be listed as a contact; start interacting with it!

On top of Collective IQ® DEX, AlmaIQ can be enhanced with AlmaKnowledge, the organization’s knowledge management platform.

In AlmaKnowledge, you can:

• Add text-based knowledge (articles, procedures, FAQs, internal manuals)
• Upload files (PDFs, technical documents, guides, presentations)
• Register URLs (internal wikis, knowledge bases, support pages)

AlmaIQ then starts to:

• Query real device information (via Collective IQ® DEX)
• Cross-check it with the AlmaKnowledge base
• Deliver richer answers, such as:
  • Step-by-step troubleshooting
  • IT-recommended procedures
  • Company policies
  • Best-practice guidelines

The result: the employee receives an answer that understands the technical context of their device and follows the organization’s official support standards.

Access to AlmaIQ is designed to protect data while keeping the experience simple for the employee.

• The employee must be registered as an Employee in Collective IQ® DEX, with a device associated to their user.
• If the company uses the Teams Data Collector integration, this association does not need to be done manually:
  • When the employee sends a message to AlmaIQ in Microsoft Teams,
    the system automatically identifies the device linked to that user.

This ensures each employee only sees information related to their own device, following the organization’s security and privacy rules.