Beginner10 min

Build a Chatbot in Voiceflow

A chatbot is just an automation that talks. Voiceflow lets you design one on a visual canvas without code, then publish it as a web widget you can drop on any site. We will build a small support bot that greets a visitor, answers from a knowledge base, and hands off to a human when stuck.

Step 1: Create the agent and add knowledge

In Voiceflow, create a new project and set its type to Chat. This becomes your agent. Open the Knowledge Base tab and add a data source: upload a PDF or CSV, paste text, or add a URL with your FAQ or help docs. This is what the bot will answer from, so it does not make things up.

Step 2: Point the agent at your knowledge base

Open the Agent tab and write a short global prompt describing the bot's personality and one firm rule: only answer from the knowledge base, never invent a fact. Then turn on the Knowledge base toggle under System tools. One Agent step now handles the question and the answer, so you are not wiring separate capture and response blocks by hand the way older tutorials describe.

Voiceflow - support bot flow
Agent
Hi! I am the Acme help bot. What can I help you with?
You
How do I reset my password?
Agent
Go to Settings, Security, then Reset password. You will get an email link that expires in 15 minutes. Want me to send it now?
You
Actually I need to talk to a person.
Agent
No problem, connecting you to a human agent now.
A minimal but complete support conversation.

Step 3: Add the human handoff

Add an Intent that triggers on phrases like talk to a human or speak to support. Route that intent to a message confirming handoff, with your contact email or live chat link. Voiceflow's built-in Handoff step can route a conversation straight into a helpdesk like Zendesk or Genesys, but that needs a paid support-tool integration, so it is worth adding once you have one. Always give people an exit; a bot that traps users is worse than no bot.

Step 4: Test and publish

Use the Test panel to chat with your bot and check that every answer comes from your uploaded docs, not a guess. When it answers cleanly, publish and copy the embed snippet into your site.

embed snippet
<script type="text/javascript">
  (function(d, t) {
    var v = d.createElement(t), s = d.getElementsByTagName(t)[0];
    v.onload = function() {
      window.voiceflow.chat.load({
        verify: { projectID: 'YOUR_PROJECT_ID' },
        url: 'https://general-runtime.voiceflow.com',
      });
    };
    v.src = 'https://cdn.voiceflow.com/widget-next/bundle.mjs';
    s.parentNode.insertBefore(v, s);
  })(document, 'script');
</script>
Test with real questions
Before you publish, ask the bot the five questions your customers actually ask most. If it nails those, you have already beaten most FAQ pages.

Hands-on tasks