WhatsApp human handoff for AI agents and workflows

Move WhatsApp conversations from automation to a person with Handoff nodes, inbox assignment, conversation history, workflow status, and real-time updates.

Official Meta Business Partner

Handoff is a product behavior

Good WhatsApp automation knows when to stop, preserve context, and make a human responsible.

Handoff node

Stop automated execution and mark the workflow as waiting for a person.

Conversation history

Give the human the WhatsApp thread and the context that led to escalation.

Inbox assignment

Make ownership explicit so the next response belongs to a person or team.

Project webhooks

Notify external systems when workflow.execution.handoff happens.

Workflow status

Keep handoff, failed, and active states visible to operations.

Automation pause

Prevent more automated processing while the conversation is human-owned.

A safe handoff loop

Keep escalation deterministic enough for operations and flexible enough for real conversations.

  1. 1

    Detect the trigger

    A customer asks, confidence drops, or business rules require review.

  2. 2

    Run handoff

    The workflow stops automation and marks the conversation for a human.

  3. 3

    Assign ownership

    Inbox and webhooks route the conversation to the right team.

  4. 4

    Reply with context

    The human sees the thread, status, and workflow history before replying.

When agents should hand off

The goal is not to automate every conversation. Resolve the easy parts and move sensitive moments to a person quickly.

  • Customer asks for a human
  • Low-confidence answer
  • Approval or sensitive data is involved
  • Complaint or emotional message
  • Payment or identity issue
  • VIP or high-value lead

Inbox options for human teams

Use the inbox mode that matches where your team works.

App inbox

For teams that need dashboard access and full project operations.

Standalone inbox

For support agents focused only on live WhatsApp conversations.

Embedded inbox

For products that need human takeover inside their own app.

Let automation stop cleanly

Build WhatsApp agents and workflows that know when a human should take over.