# 📱 Outlook Add-in Installation - Step by Step

## 🚨 IMPORTANT: Tell me the exact error message you see!

Without knowing the specific error, here are the most common solutions:

## 🔄 Method 1: Clear Cache & Retry

### Step 1: Clear Browser Cache
1. **Press F12** in your browser
2. **Right-click refresh button** → **"Empty Cache and Hard Reload"**
3. **Or use Ctrl+Shift+R** (Chrome/Firefox)

### Step 2: Try Installation Again
1. Go to **https://outlook.office.com**
2. Open any email
3. Click **"..." menu** (three dots)
4. Select **"Get Add-ins"**
5. Click **"My add-ins"** (left sidebar)
6. Scroll to **"Custom add-ins"**
7. Click **"Add a custom add-in"**
8. Select **"Add from file..."**
9. Upload: **manifest.xml** from your computer
10. Click **"Install"**

## 🌐 Method 2: Direct URL Installation

Instead of uploading a file:
1. In step 8 above, select **"Add from URL..."**
2. Enter: **`https://firmly.webiton.pt/outlook-addon/manifest.xml`**
3. Click **"Install"**

## 🖥️ Method 3: Try Desktop Outlook

If web version fails:
1. **Open Outlook Desktop** (Windows/Mac app)
2. **File** → **Get Add-ins**
3. **My add-ins** → **Custom add-ins**
4. **Add from file** → Upload manifest

## 🔧 Method 4: Simplified Manifest

If still failing, try this minimal manifest:

```xml
<?xml version="1.0" encoding="UTF-8"?>
<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" 
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xsi:type="MailApp">
  <Id>CBCA31DD-9253-4944-BD81-795C61E5987C</Id>
  <Version>1.0.0.0</Version>
  <ProviderName>Firmly</ProviderName>
  <DefaultLocale>en-US</DefaultLocale>
  <DisplayName DefaultValue="Firmly CRM" />
  <Description DefaultValue="Create tasks from Outlook emails" />
  <Hosts>
    <Host Name="Mailbox" />
  </Hosts>
  <DefaultSettings>
    <SourceLocation DefaultValue="https://firmly.webiton.pt/outlook-addon/index.html" />
  </DefaultSettings>
  <Permissions>ReadWriteMailbox</Permissions>
  <AppDomains>
    <AppDomain>https://firmly.webiton.pt</AppDomain>
  </AppDomains>
</OfficeApp>
```

## ❓ Common Error Messages & Solutions

### "Invalid manifest file"
- **Cause**: XML syntax error
- **Solution**: Use the simplified manifest above

### "App domain not allowed"  
- **Cause**: Domain restrictions
- **Solution**: ✅ Already fixed - domain is in AppDomains

### "Resource not found"
- **Cause**: Missing files
- **Solution**: ✅ Already fixed - all files deployed

### "This add-in is not supported"
- **Cause**: Outlook version compatibility
- **Solution**: Try different Outlook version (Web vs Desktop)

### "Installation failed"
- **Cause**: Network/permission issues
- **Solution**: Try URL method instead of file upload

## 🧪 Quick Test

Before installation, test these URLs in your browser:
1. https://firmly.webiton.pt/outlook-addon/manifest.xml
2. https://firmly.webiton.pt/outlook-addon/index.html

Both should load without errors.

## 📞 Next Steps

**Please tell me:**
1. **What exact error message** do you see?
2. **Which method** are you trying?
3. **Which Outlook** (Web, Desktop, Mobile)?
4. **At what step** does it fail?

This will help me give you the specific solution!