> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quick.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Human Handoff

Human Handoff is a feature that allows you to transfer the conversation from your bot to a human
agent. This is useful when the bot is unable to handle a user's request or when the user prefers to
speak with a human.

## Human Handoff block

To start a human handoff you need to have your bot **published**.

In the flow editor, grab and drop the **Human Handoff** block into your flow. You can find it in the
**integration** section of the blocks panel.

<Frame>
  <img src="https://mintcdn.com/urbiport-eca888d8/KPSdaS9HkoqnwSDh/images/human-handoff/flow-editor.png?fit=max&auto=format&n=KPSdaS9HkoqnwSDh&q=85&s=4a2000cb8c46f7579ec005dbf4ea286d" alt="Human Handoff Block" width="1451" height="1026" data-path="images/human-handoff/flow-editor.png" />
</Frame>

You don't need to configure any settings for the human handoff block or add any additional blocks,
the block itself has all the necessary to handle the conversation.

<Note>
  Currently the human handoff block does not have output points. This means it cannot direct the
  flow to other blocks. May change in future updates.

  We recommend placing the human handoff block at the end of your flow, after all other blocks have
  been executed. This ensures that the user has completed their interaction with the bot before being
  transferred to a human agent.
</Note>

Once you have added the human handoff block to your flow, you can start using it by speaking with
your bot in viewer or via whatsapp if you have it deployed.

<Info>
  Preview mode does not work here because you will use the inbox to take over the conversation.
</Info>

When the bot reaches the human handoff block, the customer will see a message that this conversation
is being transferred to a human agent.

<Frame>
  <img src="https://mintcdn.com/urbiport-eca888d8/KPSdaS9HkoqnwSDh/images/human-handoff/viewer-preview-message.png?fit=max&auto=format&n=KPSdaS9HkoqnwSDh&q=85&s=8d6fdb57c34b1149a4ca0e51f57788ba" alt="Flow editor" width="451" height="257" data-path="images/human-handoff/viewer-preview-message.png" />
</Frame>

The bot will send a request to the inbox for a human agent to take over the conversation. Until an
agent takes over, the customer cannot continue interacting with the bot.

## Human Handoff in the inbox

In your inbox, Search for the conversation with the customer awaiting a human agent.

Inside the conversation, you can see a new button in the inbox that says **Take Over**. This button
will only appear when the bot flow has a human handoff block and the customer is waiting for a human
agent.

<Frame>
  <img src="https://mintcdn.com/urbiport-eca888d8/KPSdaS9HkoqnwSDh/images/human-handoff/inbox.png?fit=max&auto=format&n=KPSdaS9HkoqnwSDh&q=85&s=efef6c7cab5769a54cb084ae2b9e9f9f" alt="Inbox conversation" width="1446" height="1023" data-path="images/human-handoff/inbox.png" />
</Frame>

You have the option to accept or reject the conversation. If you accept, you can start chatting with
the customer. If you reject, by clicking in **End conversation**, the customer will be notified that
the conversation will be closed.

To start a conversation with the customer, Click on **Take Over** and confirm.

<Frame>
  <img src="https://mintcdn.com/urbiport-eca888d8/KPSdaS9HkoqnwSDh/images/human-handoff/take-over.png?fit=max&auto=format&n=KPSdaS9HkoqnwSDh&q=85&s=86e4f94261d489e764b3c93ca81c13ce" alt="Take Over" width="935" height="803" data-path="images/human-handoff/take-over.png" />
</Frame>

After taking over the conversation, the customer will be notified that an agent has joined and start
chatting. You can then send messages to the customer, and they will be able to reply.

<Frame>
  <img src="https://mintcdn.com/urbiport-eca888d8/KPSdaS9HkoqnwSDh/images/human-handoff/conversation-start.png?fit=max&auto=format&n=KPSdaS9HkoqnwSDh&q=85&s=097637f0b76957b26837f7eb7f59570c" alt="Conversation Started" width="947" height="845" data-path="images/human-handoff/conversation-start.png" />
</Frame>

### Multiple agents support

If multiple agents are available, the first agent to click **Take Over** will be assigned to the
conversation. Other agents will not be able to take over the same conversation while it is being
handled.

<Frame>
  <img src="https://mintcdn.com/urbiport-eca888d8/KPSdaS9HkoqnwSDh/images/human-handoff/inbox-another-member.png?fit=max&auto=format&n=KPSdaS9HkoqnwSDh&q=85&s=b5255631dfafcca3670f360b055c1a5a" alt="Conversation Started" width="1428" height="988" data-path="images/human-handoff/inbox-another-member.png" />
</Frame>

<Info>
  To have multiple agents, you need to invite other members to your workspace. To know more about
  how to invite members, check the [workspace members section](/app/workspace/members).
</Info>
