> For the complete documentation index, see [llms.txt](https://docs.senseloaf.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.senseloaf.ai/sia-chat/sia-for-microsoft-word.md).

# SIA for Microsoft Word

Use your own approved templates — SIA fills them in, you send them

Most teams already have the documents they need — offer letters, interview briefs, panel scorecards — with wording that's been reviewed and signed off. Connecting MS Word means SIA works with those existing templates rather than generating something from scratch. Your formatting stays intact, your approved language stays in place, and the only thing that changes is who fills in the fields.

{% hint style="warning" %}
**Note:** The templates you want SIA to use need to be stored in OneDrive or SharePoint before connecting. MS Word access is granted through those — make sure your files are there before you begin.
{% endhint %}

### Connecting MS Word

<figure><img src="https://1117388020-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGO7J9uIHFkn8y0ZeBqYC%2Fuploads%2FnDDhY7r4ftDMs2Trs8GP%2Fword-connect-flow.gif?alt=media&amp;token=82284004-974c-4936-ba8e-63d612f51e30" alt=""><figcaption><p>Connecting MS Word</p></figcaption></figure>

1. In Chat, open **Connectors** from the sidebar
2. Find the **Word** card and click **Connect Word**
3. A Microsoft sign-in tab opens — sign in with the Microsoft 365 account that has access to your templates
4. Review the permissions shown and click **Allow**
5. You're redirected back to Chat and the card now reads **Connected**

{% hint style="warning" %}
MS Word is its own separate Microsoft connection — connecting it does not connect OneDrive or MS Excel, and each needs its own approval even though all three are part of Microsoft 365.
{% endhint %}

### What you can do once connected

Once MS Word is connected, SIA can read and produce real MS Word documents on your behalf:

* **Fill in your own template with a candidate's details** — using `{{token}}` or `<<token>>` placeholders, SIA replaces each field with real data and produces a new document without touching the original
* **Write a candidate brief or interview summary as a .docx** — an actual file you can forward directly, not text pasted into chat
* **Read a document's content** — a scorecard, job description, or a set of interview notes. If it looks like a template, SIA also identifies which `{{placeholders}}` it contains
* **List your MS Word documents** — so you can point SIA at the right file by name rather than describing it

### Try it in chat

* *"What placeholders are in my offer letter template?"*
* *"Fill my offer letter template for Priya Sharma — start date 1 Sept, London."*
* *"Write up this candidate's interview summary as a Word doc."*
* *"Read the panel scorecard in my Word docs and tell me where the interviewers disagreed."*

<figure><img src="https://1117388020-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGO7J9uIHFkn8y0ZeBqYC%2Fuploads%2Ftp93Gx8QMB03USmaE4Up%2Fword-usecase-flow.gif?alt=media&amp;token=039d0629-857e-4ce5-8911-12623c4cad1f" alt=""><figcaption><p>Try it with SIA Chat</p></figcaption></figure>

### A few things to note

* **Tables and headings don't come through when reading -** Microsoft's Word API returns document content as flat, paragraph-by-paragraph text — so a table arrives as plain text rather than rows and columns. If the structure of a document matters, Google Docs handles it more accurately.
* **Documents SIA writes are plain text -** For the same reason, anything SIA creates — a candidate brief, a summary — comes out as unstyled paragraphs with no bold, headings, or tables.
* **Updating a document replaces it entirely -** Microsoft's Word API cannot edit just a portion of a file — it rewrites the whole thing, which means any existing formatting, images, or tables are lost. Only ask SIA to update documents it generated itself, not ones that have been carefully formatted by hand.
* **Placeholders need to be intact for SIA to find them -** If someone hand-edited a template and Word split a placeholder across separate text runs in the process, SIA won't recognise it. Ask SIA to read the template and confirm which placeholders it can see before filling anything in.
* **Nothing is created without your approval -** SIA always shows you what it's about to write before producing the file — you confirm before anything is saved.

### Disconnecting MS Word

1. Go to **Connectors** in the sidebar
2. On the Word card, click **Disconnect**

This revokes access to MS Word only — your OneDrive and MS Excel connections, if you have them, are unaffected.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.senseloaf.ai/sia-chat/sia-for-microsoft-word.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
