WunderIP Chat for Word - Technical Documentation

Word Add-in Types: Native (VSTO) vs. Web-Based (Office.js)

Microsoft supports two fundamentally different approaches for building Word add-ins. This section explains the differences and why WunderIP Chat uses the native approach.

Comparison Overview

Native Add-ins (VSTO/COM)

Advantages:

• Full Office Object Model access — Complete control over Word documents, including advanced features like content controls, building blocks, and custom XML parts
• Local system integration — Can read/write files, access registry, spawn processes, and integrate with other desktop applications
• No sandboxing limitations — Full .NET Framework capabilities including any NuGet package
• Better performance — Native code execution without browser runtime overhead
• Ribbon customization — Full control over Office ribbon with complex UI patterns
• No external hosting required — Runs entirely on the user's machine

Disadvantages:

• Windows only — No support for Mac, web, or mobile versions of Office
• Complex deployment — Requires MSI packaging, COM registration, and enterprise deployment tools
• Manual updates — Users must install new versions manually or via IT deployment
• Higher IT overhead — More complex troubleshooting and management

Web-Based Add-ins (Office.js)

Advantages:

• Cross-platform — Single codebase works on Windows, Mac, Office Online, iOS, and Android
• Easy deployment — Deploy via Microsoft 365 admin center or SharePoint; no client-side installation
• Automatic updates — Update the hosted web app, all users get changes immediately
• Modern web stack — Use React, Vue, or any JavaScript framework
• Lower IT burden — No registry, COM, or MSI complexity

Disadvantages:

• Limited API surface — JavaScript API covers only ~60-70% of Word's capabilities
• Sandboxed environment — Cannot access local files, registry, or other applications
• Web hosting required — Must maintain a web server for the add-in UI
• Performance constraints — Browser-based runtime adds latency
• Task pane limitations — Less flexibility in UI placement and interaction patterns
• Offline limitations — Requires internet to load the add-in (even if cached)

Why WunderIP Chat Uses Native (VSTO)

WunderIP Chat is built as a native VSTO add-in for the following reasons:

1. Full Document Access — Patent drafting requires deep integration with Word's document model, including track changes, comments, and complex formatting that the Office.js API doesn't fully support

1. Local File Handling — The context file attachment feature needs direct file system access to read PDFs and other documents from the user's machine without upload workflows

1. WebView2 Integration — The native approach allows embedding Microsoft Edge WebView2 for a rich, modern UI while maintaining full Office integration

1. Enterprise Environment — Law firms and IP departments primarily use Windows desktops with Microsoft 365/Office 2019+, making cross-platform support less critical

1. Performance — AI-assisted patent drafting involves processing large documents; native performance ensures responsive user experience

1. Security Requirements — Enterprise customers often prefer locally-installed software over web-hosted add-ins for sensitive patent work

1. Exchange Online Dependency — Web-based Office add-ins are distributed through Exchange Server and require Exchange Online (Microsoft 365). Many law firms, IP departments, and high-security organizations run Exchange on-premises, which does not support centralized web add-in deployment. Native add-ins have no such dependency and work regardless of the email/collaboration infrastructure.

Introduction

WunderIP Chat is a Microsoft Word add-in that provides AI-powered assistance for patent drafting and prosecution. This documentation is intended for IT administrators and technical staff at law firms and IP departments responsible for deploying and managing the add-in.

Key Features

• Native Microsoft Word ribbon integration
• AI-powered patent drafting assistance
• Claim consistency checking
• Prior art search and analysis
• Document summarization
• Track changes integration
• Context file attachment (PDF, Word, text files)
• Secure OTP-based authentication

System Requirements

Hardware Requirements

Network Requirements

The add-in requires internet connectivity to communicate with WunderIP services:

Installation

Installation Methods

WunderIP Chat can be installed using one of the following methods:

Prerequisites

Before installing WunderIP Chat, ensure the following prerequisites are met:

1. .NET Framework 4.8

The add-in requires .NET Framework 4.8. This is included by default in:

• Windows 10 version 1903 and later
• Windows 11

To verify installation:

# Check .NET Framework version
(Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full").Release -ge 528040

If not installed, download from: https://dotnet.microsoft.com/download/dotnet-framework/net48

2. Microsoft Edge WebView2 Runtime

The add-in uses WebView2 for its user interface. WebView2 is included by default in:

• Windows 11
• Windows 10 with Microsoft Edge installed

To verify installation:

# Check WebView2 installation
Get-ItemProperty "HKLM:\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}" -ErrorAction SilentlyContinue

If not installed, download the Evergreen Bootstrapper from: https://developer.microsoft.com/en-us/microsoft-edge/webview2/

3. Microsoft Word

Ensure Microsoft Word is installed and activated:

• Microsoft 365 (Desktop version, not web)
• Office 2019 or Office 2021

MSI Installation (Recommended)

Interactive Installation

1. Download WunderIPChat-x.x.x.msi from the releases page
2. Double-click the MSI file
3. Follow the installation wizard
4. Restart Microsoft Word

Silent Installation

For unattended deployment:

# Silent install
msiexec /i WunderIPChat-1.0.0.msi /qn

# Silent install with logging
msiexec /i WunderIPChat-1.0.0.msi /qn /l*v "%TEMP%\WunderIPChat_Install.log"

# Silent install to custom location
msiexec /i WunderIPChat-1.0.0.msi /qn INSTALLFOLDER="C:\Program Files\WunderIPChat"

Installation Verification

After installation, verify the add-in is registered:

# Check registry entry
Get-ItemProperty "HKCU:\Software\Microsoft\Office\Word\Addins\WunderIPChat.Connect"

Expected output:

FriendlyName  : WunderIP Chat
Description   : WunderIP Chat - AI-powered patent drafting assistant
LoadBehavior  : 3

Group Policy Deployment (GPO)

For domain-joined computers, deploy via Group Policy:

1. Copy the MSI to a network share accessible by target computers
2. Open Group Policy Management Console (GPMC)
3. Create or edit a GPO linked to the target OU
4. Navigate to: User Configuration > Policies > Software Settings > Software Installation
5. Right-click and select "New > Package"
6. Browse to the network share and select the MSI
7. Choose "Assigned" for mandatory installation

Microsoft Intune Deployment

Line-of-Business App

1. Sign in to the Microsoft Endpoint Manager admin center
2. Navigate to: Apps > Windows > Add
3. Select app type: Line-of-business app
4. Upload the MSI file
5. Configure app information:

- Name: WunderIP Chat for Word - Publisher: Wunder-IP - Category: Productivity

1. Set install command: msiexec /i "WunderIPChat-1.0.0.msi" /qn
2. Set uninstall command: msiexec /x {ProductCode} /qn
3. Detection rules: MSI product code or registry key
4. Assign to users/groups

Detection Rule (Registry)

Key path: HKEY_CURRENT_USER\Software\Microsoft\Office\Word\Addins\WunderIPChat.Connect
Value name: LoadBehavior
Value: 3

SCCM Deployment

Create Application

1. Open Configuration Manager Console
2. Navigate to: Software Library > Application Management > Applications
3. Create Application > Manually specify application information
4. Add deployment type: Windows Installer (MSI)
5. Configure:

- Installation program: msiexec /i WunderIPChat-1.0.0.msi /qn - Uninstall program: msiexec /x WunderIPChat-1.0.0.msi /qn - Installation behavior: Install for user - Detection method: Registry (see above)

Baramundi Management Suite Deployment

For organizations using Baramundi Management Suite:

Create Application

1. Open Baramundi Management Center
2. Navigate to: Software > Applications
3. Right-click and select "New Application"
4. Configure application settings:

- Name: WunderIP Chat for Word - Manufacturer: Wunder-IP - Version: 1.0.0

Installation Job

1. Add a new installation job to the application
2. Configure:

- Installation type: MSI Package - MSI file: Upload or reference WunderIPChat-1.0.0.msi - Installation parameters: /qn - Uninstall parameters: /x {ProductCode} /qn

Job Options

Installation command: msiexec /i "WunderIPChat-1.0.0.msi" /qn /l*v "%TEMP%\WunderIPChat_Install.log"
Uninstall command: msiexec /x "WunderIPChat-1.0.0.msi" /qn
User context: Current user (per-user installation)

Detection Rule

Configure a registry-based detection rule:

Deployment

1. Create a job targeting the desired endpoints or user groups
2. Since the MSI installs per-user, ensure jobs run in user context
3. Schedule deployment or push immediately
4. Monitor job status in the Baramundi dashboard

PowerShell Installation (Manual)

For testing or small deployments without MSI:

Installation

1. Extract the installation package to a permanent location (e.g., C:\Program Files\WunderIPChat)
2. Run the install script as Administrator:

# Navigate to installation folder
cd "C:\Program Files\WunderIPChat"

# Run install script
.\Install.ps1

What the Script Does

The PowerShell install script performs the following:

1. COM Registration: Registers the DLL with RegAsm.exe /codebase /tlb
2. Registry Entries: Creates Office add-in discovery keys in HKCU
3. No Admin Required: Uses HKCU (per-user) instead of HKLM (per-machine)

Configuration

Installation Location

The MSI installs to the following location:

%LocalAppData%\WunderIP\WunderIPChat\

Example:

C:\Users\JohnDoe\AppData\Local\WunderIP\WunderIPChat\

Installed Files

Registry Keys

Add-in Registration

HKCU\Software\Microsoft\Office\Word\Addins\WunderIPChat.Connect

LoadBehavior Values

COM Registration

HKCU\Software\Classes\CLSID\{A1B2C3D4-E5F6-7890-ABCD-EF1234567891}
HKCU\Software\Classes\WunderIPChat.Connect

User Data Location

User-specific data and logs are stored in:

%LocalAppData%\WunderIPChat\

User Authentication

OTP-Based Login

WunderIP Chat uses email-based one-time password (OTP) authentication:

1. User clicks "Sign In" in the Word ribbon
2. Enters their email address
3. Receives a 6-digit code via email
4. Enters the code to complete authentication

Session Management

• Sessions persist until explicit logout
• Tokens are automatically refreshed
• Multiple devices can be signed in simultaneously

SSO / Enterprise Authentication

Contact WunderIP support for enterprise SSO integration options:

• SAML 2.0
• OAuth 2.0 / OIDC
• Azure AD integration

Updating

Automatic Updates

Currently, the add-in does not include automatic updates. Updates require manual installation of a new MSI.

Manual Update Process

1. Download the latest MSI from the releases page
2. Install over the existing version:

``powershell msiexec /i WunderIPChat-x.x.x.msi /qn ``

1. Restart Microsoft Word

The MSI supports major upgrades - previous versions are automatically removed.

Enterprise Update Workflow

For enterprise deployments:

1. Test new version in a pilot group
2. Update the MSI in your deployment share/Intune
3. Deploy to production users
4. Verify via registry or log files

Uninstallation

Via Windows Settings

1. Open Windows Settings > Apps > Installed Apps
2. Search for "WunderIP Chat"
3. Click "Uninstall"

Via MSI (Silent)

# Uninstall by product name
$app = Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -eq "WunderIP Chat for Word" }
$app.Uninstall()

# Or via msiexec with product code
msiexec /x {ProductCode} /qn

Via PowerShell Scripts

If installed via PowerShell scripts:

cd "C:\Program Files\WunderIPChat"
.\Uninstall.ps1

Manual Cleanup

If uninstallation fails, manually remove:

1. Delete installation folder: %LocalAppData%\WunderIP\WunderIPChat\
2. Delete user data: %LocalAppData%\WunderIPChat\
3. Remove registry keys:

``powershell Remove-Item "HKCU:\Software\Microsoft\Office\Word\Addins\WunderIPChat.Connect" -Force Remove-Item "HKCU:\Software\Classes\WunderIPChat.Connect" -Recurse -Force Remove-Item "HKCU:\Software\Classes\CLSID\{A1B2C3D4-E5F6-7890-ABCD-EF1234567891}" -Recurse -Force ``

Troubleshooting

Add-in Not Loading

Check if Add-in is Disabled

1. Open Word
2. Go to File > Options > Add-ins
3. At the bottom, select "Disabled Items" from the Manage dropdown
4. Click "Go..."
5. If WunderIP Chat is listed, select it and click "Enable"

Check LoadBehavior

Get-ItemProperty "HKCU:\Software\Microsoft\Office\Word\Addins\WunderIPChat.Connect"

If LoadBehavior is 0 or 2, reset to 3:

Set-ItemProperty "HKCU:\Software\Microsoft\Office\Word\Addins\WunderIPChat.Connect" -Name "LoadBehavior" -Value 3

Re-register COM Assembly

$assemblyPath = "$env:LOCALAPPDATA\WunderIP\WunderIPChat\WunderIPChat.dll"
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\RegAsm.exe $assemblyPath /codebase /tlb

WebView2 Errors

If you see "WebView2 Runtime not found" errors:

1. Install the WebView2 Runtime:

``powershell # Download and install Invoke-WebRequest -Uri "https://go.microsoft.com/fwlink/p/?LinkId=2124703" -OutFile "$env:TEMP\MicrosoftEdgeWebview2Setup.exe" Start-Process "$env:TEMP\MicrosoftEdgeWebview2Setup.exe" -ArgumentList "/silent /install" -Wait ``

1. Restart Word

Task Pane Not Appearing

1. Click "Toggle Panel" in the Wunder tab
2. If still not visible, try:

- Close and reopen Word - Check if blocked by Group Policy - Review the log file (see below)

Viewing Logs

Log files are located at:

%LocalAppData%\WunderIPChat\addin.log

View recent entries:

Get-Content "$env:LOCALAPPDATA\WunderIPChat\addin.log" -Tail 50

Common Error Codes

Reporting Issues

When reporting issues to support, include:

1. Windows version (winver)
2. Office version (File > Account)
3. Log file contents
4. Steps to reproduce
5. Screenshots if applicable

Security Considerations

Data Handling

• Document Content: Document text is sent to WunderIP servers for AI processing
• Storage: No document content is stored permanently on WunderIP servers
• Encryption: All communication uses TLS 1.2+

Permissions

The add-in requires the following permissions:

Network Security

• All API calls use HTTPS
• Certificate pinning: Not implemented (uses system trust store)
• No data cached locally except WebView2 session data

Compliance

Contact WunderIP for compliance documentation:

• SOC 2 Type II
• GDPR compliance
• Data processing agreements (DPA)

FAQ

Does the add-in work with Office 365 web version?

No, WunderIP Chat requires the desktop version of Microsoft Word. Office Online / Word for the web is not supported.

Can multiple users share an installation?

The MSI installs per-user to %LocalAppData%. Each user requires their own installation.

Is an internet connection required?

Yes, an internet connection is required for all AI features. The add-in will load without internet, but functionality will be limited.

What data is sent to WunderIP?

When using AI features, document content (or selected text) is sent to WunderIP servers for processing. See our privacy policy for details.

Can we use our own AI models?

Contact WunderIP sales for enterprise options including on-premises deployment and custom model integration.

Support

Contact Information

Version History

Appendix

Complete Registry Reference

Windows Registry Editor Version 5.00

; Word Add-in Registration
[HKEY_CURRENT_USER\Software\Microsoft\Office\Word\Addins\WunderIPChat.Connect]
"FriendlyName"="WunderIP Chat"
"Description"="WunderIP Chat - AI-powered patent drafting assistant"
"LoadBehavior"=dword:00000003

; COM Class Registration
[HKEY_CURRENT_USER\Software\Classes\CLSID\{A1B2C3D4-E5F6-7890-ABCD-EF1234567891}]
@="WunderIPChat.Connect"

[HKEY_CURRENT_USER\Software\Classes\CLSID\{A1B2C3D4-E5F6-7890-ABCD-EF1234567891}\InprocServer32]
@="mscoree.dll"
"ThreadingModel"="Both"
"Class"="WunderIPChat.ThisAddIn"
"Assembly"="WunderIPChat, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null"
"RuntimeVersion"="v4.0.30319"
"CodeBase"="[InstallPath]\\WunderIPChat.dll"

[HKEY_CURRENT_USER\Software\Classes\WunderIPChat.Connect]
@="WunderIP Chat Add-in"

[HKEY_CURRENT_USER\Software\Classes\WunderIPChat.Connect\CLSID]
@="{A1B2C3D4-E5F6-7890-ABCD-EF1234567891}"

PowerShell Diagnostic Script

# WunderIPChat Diagnostic Script
Write-Host "=== WunderIP Chat Diagnostics ===" -ForegroundColor Cyan

# Check .NET Framework
$netfx = (Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" -ErrorAction SilentlyContinue).Release
if ($netfx -ge 528040) {
    Write-Host "[OK] .NET Framework 4.8+ installed" -ForegroundColor Green
} else {
    Write-Host "[FAIL] .NET Framework 4.8 not found" -ForegroundColor Red
}

# Check WebView2
$wv2 = Get-ItemProperty "HKLM:\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}" -ErrorAction SilentlyContinue
if ($wv2) {
    Write-Host "[OK] WebView2 Runtime installed: $($wv2.pv)" -ForegroundColor Green
} else {
    Write-Host "[FAIL] WebView2 Runtime not found" -ForegroundColor Red
}

# Check Add-in Registration
$addin = Get-ItemProperty "HKCU:\Software\Microsoft\Office\Word\Addins\WunderIPChat.Connect" -ErrorAction SilentlyContinue
if ($addin) {
    Write-Host "[OK] Add-in registered (LoadBehavior: $($addin.LoadBehavior))" -ForegroundColor Green
} else {
    Write-Host "[FAIL] Add-in not registered" -ForegroundColor Red
}

# Check Installation Folder
$installPath = "$env:LOCALAPPDATA\WunderIP\WunderIPChat\WunderIPChat.dll"
if (Test-Path $installPath) {
    Write-Host "[OK] Installation found at $installPath" -ForegroundColor Green
} else {
    Write-Host "[WARN] Installation not found at expected location" -ForegroundColor Yellow
}

# Check Log File
$logPath = "$env:LOCALAPPDATA\WunderIPChat\addin.log"
if (Test-Path $logPath) {
    Write-Host "[INFO] Log file exists: $logPath" -ForegroundColor Cyan
    Write-Host "Last 5 log entries:"
    Get-Content $logPath -Tail 5
} else {
    Write-Host "[INFO] No log file found (add-in may not have run yet)" -ForegroundColor Yellow
}