BlogMake.com SharePoint to Voiceflow KB Sync...
cornerstoneautomationhealthcare

Make.com SharePoint to Voiceflow KB Sync: Complete Production Guide

June 8, 2025

The Problem

Knowledge base drift is the silent killer of enterprise AI deployments.

In a typical operational environment—especially in healthcare or complex B2B services—Standard Operating Procedures (SOPs), playbooks, and compliance guidelines are living documents. A clinical manager might update a SharePoint document on Tuesday to reflect a new billing code, but if the AI chatbot relies on a static PDF uploaded last month, the bot is now confidently dispensing incorrect, out-of-compliance information.

The standard operational "fix" for this is entirely manual: someone in operations must notice the SharePoint edit, download the new PDF, log into the Voiceflow dashboard, delete the old file, and upload the new one.

When you scale this across 4+ complex playbooks and multiple stakeholders editing documents daily, knowledge base drift is inevitable within days. The chatbot gives stale answers. Support escalations increase. Trust in the AI system collapses.

Why This Matters for AI Assistants

Stale knowledge bases are one of the top failure modes for enterprise AI chatbots.

Retrieval-Augmented Generation (RAG) is only as good as the freshness of the source documents. If the context window is injected with outdated policies, the LLM will hallucinate answers that were correct yesterday but are wrong today. In healthcare staffing and medical billing, dispensing the wrong procedural information doesn't just annoy a user; it can result in rejected claims, SLA violations, or compliance breaches.

To solve this, we cannot rely on humans. We need a deterministic, low-latency sync between the source of truth (SharePoint) and the inference engine (Voiceflow).

Architecture Overview

To achieve this, we designed a 7-step Make.com scenario that entirely eliminates the human in the loop.

The architecture guarantees that within 60 seconds of a document being modified in SharePoint, that exact modification is indexed and ready for retrieval in the Voiceflow Knowledge Base.

[SharePoint Watch] 
       │
       ▼
[Filetype Gate] ──(Drop)──> [Invalid Files: Images/ZIP/Sheets]
       │
       ▼ (Pass)
[HTTP GET Binary]
       │
       ▼
[HTTP POST Voiceflow KB] (multipart/form-data, overwrite=true)
       │
       ▼
[Tools: Sleep 60s] 
       │
       ▼
[HTTP GET Status Poll]
       │
       ▼
[Set Variable: Audit Log]

Step-by-Step Build

Let's break down the exact module configuration for each step in this Make.com pipeline.

Step 1: SharePoint Watch

We begin with the Microsoft 365 SharePoint module: "Watch Files/Folders".

  • Site: Select your specific organization site.
  • Drive: Select the specific Document Library.
  • Folder: Target the exact folder where the playbooks live.
  • Limit: Set to 10 (to handle bulk uploads gracefully).

Step 2: The Filetype Gate

SharePoint folders get messy. Users drop images, ZIP files, and massive spreadsheets into folders meant for PDFs. If you try to push a 50MB ZIP file into the Voiceflow KB API, the pipeline will crash.

We use a Make.com Router combined with a Filter to act as a filetype gate.

  • Condition: File Name (from Step 1)
  • Operator: Ends with (case insensitive)
  • Value 1: .pdf
  • OR Value 2: .docx

If the file does not meet this criteria, the route simply ends. No errors, no noise.

Step 3: HTTP GET Binary

The Watch module only gives us metadata (filename, ID, timestamp). We need the actual file contents. Add a Microsoft 365 SharePoint "Download a File" module. Map the File ID from Step 1. This outputs the raw binary data.

Step 4: HTTP POST to Voiceflow KB

This is the core of the integration. We use the Make.com "HTTP - Make a request" module to interact with the Voiceflow REST API.

  • URL: https://api.voiceflow.com/v1/knowledge-base/docs/upload?overwrite=true
  • Method: POST
  • Headers:
    • Authorization: Bearer your_voiceflow_api_key
    • Accept: application/json
  • Body Type: Multipart/form-data
  • Fields:
    • Field Type: File
    • Key: file
    • File Name: Map File Name from Step 1.
    • Data: Map Data from Step 3.

The Critical Detail: Async Indexing

If you stop at Step 4, your pipeline will technically "work," but it will fail silently in production.

Why? Because Voiceflow indexes documents asynchronously. When you receive a 200 OK from the upload endpoint, it merely means Voiceflow has received the file. It has not chunked, embedded, or indexed the text yet. If a user asks the chatbot a question 5 seconds later, they will not get the new information.

Step 5: Tools Sleep 60s

We must wait for the indexing to complete. Add the Make.com "Tools - Sleep" module.

  • Delay: 60 seconds.

Why exactly 60 seconds? Through extensive production testing, we found that 95% of standard text PDFs (under 50 pages) finish indexing in Voiceflow within 35-45 seconds. 60 seconds provides a safe buffer. Without this sleep, the polling step (Step 6) fires before indexing even starts and always returns a non-READY state.

Step 6: HTTP GET Status Poll

After the sleep, we must verify the document actually indexed successfully. Add another "HTTP - Make a request" module.

  • URL: https://api.voiceflow.com/v1/knowledge-base/docs
  • Method: GET
  • Headers: Authorization: Bearer your_voiceflow_api_key

This returns an array of all documents. We use a Make.com array function to find the document that matches our specific filename and check its status. We are looking for the status "READY".

Step 7: Audit Trail Design

We finish with a Make.com "Set Variable" module. This acts as our audit log anchor. We map the filename, the upload timestamp, and the final "READY" status into a clean JSON string.

In a more complex deployment, you would route this variable to a Slack channel (#bot-updates) or append it to a Google Sheet for compliance tracking.

Idempotency via overwrite=true

Notice the query parameter in Step 4: ?overwrite=true.

This is the most elegant parameter in the entire Voiceflow API. Without it, you would have to build complex deduplication logic:

  1. Get all documents.
  2. Check if a document with this filename exists.
  3. If yes, grab its internal Document ID.
  4. Send a DELETE request to remove the old version.
  5. Send a POST request to upload the new version.

By simply appending overwrite=true, Voiceflow handles all of this internally. If a document with the exact same filename exists, it is seamlessly replaced. If it doesn't exist, it is created.

This makes our entire sync pipeline idempotent. If the Make.com scenario accidentally triggers twice, or if you force-run it for testing, it is completely safe. No duplicate documents will ever bloat your Knowledge Base.

Results: Teknicare Production Deployment

We deployed this exact architecture for Teknicare, syncing critical clinical playbooks directly from their operations SharePoint into their Voiceflow triage agent.

The operational metrics speak for themselves:

  • Sync Latency: Under 1 minute from the moment a manager hits "Save" in Word to the moment the chatbot answers questions using the new data.
  • Manual Upload Time: Reduced from hours per week to absolutely 0.
  • KB Coverage: 100%. The bot always has the exact same documentation as the human staff.
  • Duplicate Documents: 0, thanks to strict idempotency.

Extensions and Variations

Once this core pipeline is stable, you can extend it based on enterprise requirements:

  1. Error Notifications: Add an Error Handler route to the Voiceflow HTTP POST module. If the API returns a 5xx error or a rate limit (429), route a notification to a Slack channel tagging the engineering team.
  2. Metadata Tagging: If you use Voiceflow's advanced KB tagging, you can extract folder names from SharePoint and pass them as tags in the Voiceflow API payload, allowing your bot to filter context by department.
  3. Multi-Folder Watch: Use a Make.com Array Aggregator to watch multiple SharePoint drives simultaneously and funnel them all into the same Voiceflow KB.

Conclusion

Building an AI chatbot is easy; keeping it accurate in a dynamic enterprise environment is incredibly difficult. By treating your knowledge base as a living, synchronized cache rather than a static filing cabinet, you ensure your AI operations scale without requiring constant human intervention.

If your Voiceflow assistants are suffering from knowledge drift, or if you are tired of manually managing KB uploads across multiple bots, book a free consultation with me. I can build this exact sync architecture directly into your tenant.