Botpress Customer Support Chatbot

Voiceflow WhatsApp Human Handoff (HITL)

Connect using WhatsApp Business API or QR Code

Let your Voiceflow WhatsApp chatbot route conversations directly to real human agents on request

botpress WhatsApp human handoff

Handle Voiceflow WhatsApp conversations from one shared team inbox

Assign Voiceflow WhatsApp chats between agents without losing conversation history or context

Send WhatsApp Bulk messaging campaigns to your customers

Use your existing Meta Business account credentials, or connect instantly with a QR scan

Also available for webchat

Voiceflow human handoff works across both WhatsApp and Webchat (ie. website chat widget)

What Is Human Handoff (And How Does It Work on Voiceflow WhatsApp)?

Human handoff, or human-in-the-loop (HITL), is what lets a Voiceflow WhatsApp agent hand a conversation over to a real person mid-chat - without the customer needing to repeat anything or move to a new channel. The customer keeps chatting in the same WhatsApp thread; only who's replying on the other end changes.

Why it's necessary

Voiceflow agents are strong at structured conversation design - guiding users through flows, qualifying leads, and answering common questions. But like any chatbot, a Voiceflow agent will eventually hit a question it can't resolve, or a customer who simply wants to speak to a person. Without a human handoff solution, that's usually where the conversation stalls or the customer gives up.

How hitlchat works

hitlchat connects directly to your Voiceflow project using your Voiceflow API key. Once connected, it monitors WhatsApp conversations for handoff triggers - HITL keywords typed by the customer, or an agent manually taking over - and when one fires, the bot pauses on that conversation and it's routed into a shared team inbox. Your agent replies from there, with the full bot conversation visible, and can hand control back to the Voiceflow agent once the conversation is resolved.

"Because the handoff happens behind the scenes on the same WhatsApp number, customers experience it as a natural conversation - not a transfer to a different system."

Why Add Human Handoff to a Voiceflow WhatsApp Agent?

Integrating a human layer into your automated flows ensures that your customer experience remains high-quality even when automation reaches its limits.

Don't let well-built flows hit a dead end

Even a well-designed Voiceflow agent can't anticipate every question - handoff means there's always a way forward.

Keep the conversation on WhatsApp

No redirect to email or a separate live chat tool, which keeps response times fast and the experience consistent.

Choose how to enable Voiceflow WhatsApp HITL

OPTION 1

WhatsApp Business API

Designed for production environments and higher message volumes.

Uses Meta’s official WhatsApp Business API platform

Requires registering a dedicated WhatsApp number with Meta

Can be set up manually, or through Meta’s embedded onboarding flow

Built to handle large-scale messaging and campaign traffic

Conversations are managed inside the hitlchat team inbox

OPTION 2

QR Code connection

Ideal for quick testing, demos, and lightweight deployments.

No WhatsApp Business API approval process needed

Link your number by scanning a QR code, similar to WhatsApp Web

Works directly with the WhatsApp mobile application

Best suited for lower daily message volumes

Reply to conversations directly from your WhatsApp app

Begin with QR code mode for fast setup and testing, then later switch to the WhatsApp Business API when ever you are ready to

Voiceflow WhatsApp Business API vs QR Code: Which Should You Use?

Just as with Botpress, hitlchat supports two ways to connect a Voiceflow agent to WhatsApp. The right choice depends on your message volume and how quickly you need to launch.

Feature

WhatsApp Business API

QR Code

Setup time
Setup time 15–30 minutes (requires Meta verification)
Under 2 minutes
Meta Business verification required?
Yes
No
Best for
Production, high message volume, bulk campaigns
Pilots, demos, small teams, lower volume
Where agents reply
hitlchat inbox (web & mobile app)
hitlchat inbox or directly from the WhatsApp mobile app
Message volume limits
Scales reliably for high-volume use
Best suited to small/moderate volume
WhatsApp number used
Dedicated Business API number
Existing personal or business WhatsApp number
Bulk broadcast campaigns
Fully supported
Supported at lower send volume

Our general recommendation: Many agencies building Voiceflow assistants for clients start every new client on the QR code connection during the pilot phase, then migrate to the WhatsApp Business API once the client is ready to scale messaging volume or run broadcast campaigns. Both options use the same Voiceflow agent and the same hitlchat inbox - switching later is a configuration change, not a rebuild..

Reply to Voiceflow WhatsApp conversations from anywhere using the hitlchat mobile app or the official WhatsApp mobile app

botpress WhatsApp

How to Connect Voiceflow to WhatsApp with hitlchat

Setup takes only a few minutes using your existing, already-published Voiceflow agent - no rebuilding required.

1

Create an Account

Create a hitlchat account and start a free trial - no credit card required.

2

Choose your integration

In the hitlchat dashboard, open Configuration and select Voiceflow as your integration type.

3

Connect Voiceflow

In Voiceflow, open your agent's Settings → API Keys, copy the API key, then paste it into the Voiceflow Configuration screen in hitlchat. Leave the Bot Active toggle enabled.

4

Connect WhatsApp

Connect your WhatsApp number using your existing WhatsApp Business API credentials or by scanning a QR code. No Meta approval is required for QR setup.

5

Define Handoff Triggers

Add your HITL keywords (such as "agent" or "human") to automatically transfer conversations from the bot to your team.

6

Test the Flow

Send a WhatsApp message to confirm your Voiceflow agent responds correctly, then test a handoff keyword to ensure the conversation reaches your hitlchat inbox.

7

Invite Your Team

Each agent gets Invite your team to the shared inbox. Each team member gets their own login, with access available on desktop and the hitlchat mobile app (iOS & Android).own login to the shared inbox, available on desktop and via the hitlchat mobile app (iOS & Android).

Managing Voiceflow WhatsApp Conversations from a Shared Inbox

Every WhatsApp conversation your Voiceflow agent handles - along with every handoff - lands in the hitlchat shared team inbox. From there, agents can:

  • View the complete bot conversation history before responding
  • Reply with text, images, documents, and WhatsApp message templates
  • Transfer a chat to another teammate without losing conversation context
  • Hand the conversation back to the Voiceflow agent once it's resolved
  • Tag and organize contacts for follow-up, reporting, or future campaigns

Agencies building Voiceflow agents for multiple clients often use hitlchat as a packaged human handoff layer they include with every project - each client gets their own inbox and team without needing direct access to the underlying Voiceflow project.

User interface for importing contacts showing instructions, a file selection of 'Contact list - big 11401.csv', notification of 11400 contacts to be imported, and a green 'Import CSV' button.
botpress WhatsApp hitl

Enable live agent handoff for your Voiceflow WhatsApp assistant in 2 minutes

Link your Voiceflow project to hitlchat and start routing WhatsApp conversations immediately with our easy 'no code' setup. Simply copy & paste your Voiceflow project API key and you'll be up and running!

Connect Voiceflow to HitlChat

Botpress Live Agent Hand-Off For WhatsApp

Automatically route Botpress conversations to a live agent when needed. Customers get instant human support without leaving WhatsApp

AI Chatbot Human Handoff

Shared WhatsApp Team Inbox

Manage all WhatsApp conversations from a shared team inbox. Assign and transfer WhatsApp chats between agents. Send rich media, templates and more

Instant Setup

Connect your hitlchat account to WhatsApp, paste your Botpress webhook URL into your hitlchat account, and start intercepting bot conversations immediately

Mobile App & Desktop Access

Handle WhatsApp conversations using the hitlchat web app or mobile app (iOS & Android), or respond directly from the WhatsApp mobile app when using QR connection

Connect via API or QR Code

Use the official WhatsApp Business API for production workloads, or connect instantly with a QR code for demos, testing, and smaller implementations without Meta approval

botpress

WhatsApp Conversation Visibility

Track all Botpress WhatsApp conversations from a single dashboard to review interactions, improve flows, and support customers more effectively

What people say about hitlchat

Voiceflow WhatsApp Business APIVoiceflow WhatsApp Business APIVoiceflow WhatsApp Business APIVoiceflow WhatsApp Business APIVoiceflow WhatsApp Business API

Jason Marks

Botpress Bot builder

“Game changer. Finally a human hand-off solution for Botpress WhatsApp bots. We specialize in building complex Botpress chatbots for our clients. We finally have the ability to intercept the bot's chats and respond to customers using WhatsApp. Also, no need to use an additional marketing tool for broadcast campaigns as hitlchat has it all built in.”

Voiceflow WhatsApp Business APIVoiceflow WhatsApp Business APIVoiceflow WhatsApp Business APIVoiceflow WhatsApp Business APIVoiceflow WhatsApp Business API

Kavish Bhatt

AI Agency

“Quick setup, works incredibly well. Our clients generally have teams of 3 to 6 agents currently responding to their customers using the hitlchat team inbox. The ability to intercept Botpress conversations and respond directly to customers via WhatsApp was much needed”

Voiceflow WhatsApp Business APIVoiceflow WhatsApp Business APIVoiceflow WhatsApp Business APIVoiceflow WhatsApp Business APIVoiceflow WhatsApp Business API

Michael Ensling

eCommerce Owner

“We use WhatsApp as our main sales / service channel for our ecommerce store  combined with a Botpress chatbot. For our complex customer enquiries hitlchat allows us to provide customers with a 'live chat' experience using WhatsApp. This has resulted in more sales and a more personalized customer experience.”

Frequently Asked Questions

Everything you need to know about human handoff for Botpress WhatsApp.

Does hitlchat require a WhatsApp Business API account?

No, you can connect using either the official WhatsApp Business API...

Priced plans for teams of all sizes

Save 25% with our annual plan

Annual

Monthly

Solo Agent (1 user)

$29

/ Per Month

Human handoff for Botpress and Voiceflow chatbots across WhatsApp and Webchat for one user

Live agent handoff for Botpress & Voiceflow (WhatsApp & Webchat)

Shared inbox for two-way customer conversations

Automation rules & contact management

Mobile & desktop inbox access

Send Bulk WhatsApp campaigns

Developer API access for custom integrations

1 user included

Usage:

8,000 contacts

20k broadcasts per month

15 automations

20 tags & 20 lists

5 custom fields

Try Hitlchat For Free

Small Business (5 users)

$47

/ Per Month

Everything in Solo Agent, as well as multi-agent collaboration for 5 users

Multi-agent human handoff for Botpress & Voiceflow (WhatsApp & Webchat)

Shared inbox for two-way customer conversations

Automation rules & contact management

Mobile & desktop inbox access

Send Bulk WhatsApp campaigns

Developer API access for custom integrations

5 users included

Usage:

15k contacts

40k broadcasts per month

30 automations

40 tags & 40 lists

10 custom fields

10k API calls per month

Try Hitlchat For Free

Growth

$89

/ Per Month

Everything in Small Business, with larger contact database and support for 10 users

Multi-agent human handoff for Botpress & Voiceflow (WhatsApp & Webchat)

Shared inbox for two-way customer conversations

Advanced automation rules & contact management

Mobile & desktop inbox access

Send Bulk WhatsApp campaigns (faster send speeds)

Developer API access for custom integrations

10 users included

Usage:

35k contacts

80k broadcasts per month

Unlimited automations

Unlimited tags & lists

Unlimited custom fields

50k API calls per month

Try Hitlchat For Free

Enterprise (30 users)

$210

/ Per Month

Everything in Growth, with enterprise-scale contact limits, ultra-fast broadcast sending and support for 30 users

Enterprise-grade human handoff for Botpress & Voiceflow (WhatsApp & Webchat)

Shared inbox for two-way customer conversations

Advanced automation rules & contact management

Mobile & desktop inbox access

Send Bulk WhatsApp campaigns (ultra fast send speeds)

Developer API access for custom integrations

30 users included

Usage:

300k contacts

500k broadcasts per month

Unlimited automations

Unlimited tags & lists

Unlimited custom fields

300k API calls per month

Try Hitlchat For Free

Solo Agent (1 user)

$37

/ Per Month

Human handoff for Botpress and Voiceflow chatbots across WhatsApp and Webchat for one user

Live agent handoff for Botpress & Voiceflow (WhatsApp & Webchat)

Shared inbox for two-way customer conversations

Automation rules & contact management

Mobile & desktop inbox access

Send Bulk WhatsApp campaigns

Developer API access for custom integrations

1 user included

Usage:

8,000 contacts

20k broadcasts per month

15 automations

20 tags & 20 lists

5 custom fields

Try Hitlchat For Free

Small Business (5 users)

$62

/ Per Month

Everything in Solo Agent, as well as multi-agent collaboration for 5 users

Multi-agent human handoff for Botpress & Voiceflow (WhatsApp & Webchat)

Shared inbox for two-way customer conversations

Automation rules & contact management

Mobile & desktop inbox access

Send Bulk WhatsApp campaigns

Developer API access for custom integrations

5 users included

Usage:

15,000 contacts

40k broadcasts per month

30 automations

40 tags & 40 lists

10 custom fields

10k API calls per month

Try Hitlchat For Free

Growth

$115

/ Per Month

Everything in Small Business, with larger contact database and support for 10 users

Multi-agent human handoff for Botpress & Voiceflow (WhatsApp & Webchat)

Shared inbox for two-way customer conversations

Advanced automation rules & contact management

Mobile & desktop inbox access

Send Bulk WhatsApp campaigns (faster send speeds)

Developer API access for custom integrations

10 users included

Usage:

35k contacts

80k broadcasts per month

Unlimited automations

Unlimited tags & lists

Unlimited custom fields

50k API calls per month

Try Hitlchat For Free

Enterprise (30 users)

$265

/ Per Month

Everything in Growth, with enterprise-scale contact limits, ultra-fast broadcast sending and support for 30 users

Enterprise-grade human handoff for Botpress & Voiceflow (WhatsApp & Webchat)

Shared inbox for two-way customer conversations

Advanced automation rules & contact management

Mobile & desktop inbox access

Send Bulk WhatsApp campaigns (ultra fast send speeds)

Developer API access for custom integrations

30 users included

Usage:

300k contacts

500k broadcasts per month

Unlimited automations

Unlimited tags & lists

Unlimited custom fields

300k API calls per month

Try Hitlchat For Free

Ready to try hitlchat ?

Create Your Free Account Now

No credit card required