> For the complete documentation index, see [llms.txt](https://replai-1.gitbook.io/replai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://replai-1.gitbook.io/replai-docs/answers-and-grounding/handoff-and-lead-capture.md).

# Handoff & lead capture

## Handoff & lead capture

Replai has two fallback paths.

It can hand the conversation to a human on **Live**.

It can also capture contact details for follow-up.

### When does Replai offer a human handoff?

Human handoff is available on **Live**.

Replai can offer it when the visitor asks, or when the assistant decides a human should take over.

A proactive offer is optional per assistant.

### What does the visitor see during handoff?

The visitor confirms the handoff first.

Then the conversation enters a FIFO queue.

When an agent joins, the visitor sees that the agent joined the chat.

Typing indicators stay visible during the live conversation.

### What happens when nobody is online?

If lead capture is enabled, Replai asks for the visitor email instead of sending the visitor into a dead queue.

The workspace owner is notified.

{% hint style="info" %}
Lead capture is also useful when the assistant cannot answer.
{% endhint %}

### What does lead capture collect?

Lead capture can ask for:

* Email
* Name
* Message

Follow-up is manual.

### What happens after the human resolves the chat?

Control returns to the assistant when the human resolves the conversation or the visitor goes quiet.

A new handoff can happen later if needed.

### Related links

* [Live tier](/replai-docs/features-by-tier/live-tier.md)
* [Honest decline](/replai-docs/answers-and-grounding/honest-decline.md)
* [How answering works](/replai-docs/answers-and-grounding/how-answering-works.md)
* [The widget](/replai-docs/features-by-tier/the-widget.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://replai-1.gitbook.io/replai-docs/answers-and-grounding/handoff-and-lead-capture.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
