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

# Collect Leads

## Overview

Traditionally, lead collection happens at the start of a agent conversation (e.g., asking for name, email, or phone). With smart lead collection, the agent can now detect intent mid-conversation — such as when a user requests a product demo, pricing, or more details — and automatically prompt for relevant contact details.

Example: When will Product X be back in stock?

## How to Use Collect Leads

### Step 1: Create a Collect Leads Action

1. Go to the **Actions** tab.

2. Click **List** from the left-hand menu.

3. Select **Create Action**.

<img className="block" src="https://mintcdn.com/chatnode-55/2HMEPn0IOnlaIVdX/images/server-action-one.webp?fit=max&auto=format&n=2HMEPn0IOnlaIVdX&q=85&s=2ccd092de9d1610bc9bd87cbd7ad2b97" alt="Server Action One" width="2914" height="952" data-path="images/server-action-one.webp" />

4. Choose **Collect Leads**.

<img className="block" src="https://mintcdn.com/chatnode-55/kq4juHBrTPOM3I5k/images/collect-leads-one.webp?fit=max&auto=format&n=kq4juHBrTPOM3I5k&q=85&s=412a1483d2ad2486b6a8ad1288e85c93" alt="Collect Leads One" width="1224" height="750" data-path="images/collect-leads-one.webp" />

5. Enter an **Action Title** in the pop-up window and click **Create**.

<img className="block" src="https://mintcdn.com/chatnode-55/kq4juHBrTPOM3I5k/images/collect-leads-two.webp?fit=max&auto=format&n=kq4juHBrTPOM3I5k&q=85&s=a9a542a4510a9a218c1ad90767e18841" alt="Collect Leads Two" width="2036" height="910" data-path="images/collect-leads-two.webp" />

6. You will be redirected to the configuration page.

### Step 2: Basic Settings

* **Name** → Enter a descriptive name for this action. (e.g., collect\_info)

* **Description** → Provide a short explanation of when to use this action.

  * Example: Collects user contact details for the sales team.

<img className="block" src="https://mintcdn.com/chatnode-55/kq4juHBrTPOM3I5k/images/basic-settings-cl.webp?fit=max&auto=format&n=kq4juHBrTPOM3I5k&q=85&s=5719a0ddea715139100cf6d1419486ed" alt="Basic Settings Cl" width="1754" height="668" data-path="images/basic-settings-cl.webp" />

### Step 3: Messages

You can customize the messages shown during the lead capture process:

* **Submit Button Message** → Label for the submit button (e.g., **Submit Details**).

* **Submitted Message** → Confirmation shown after the user submits their information (e.g., **Thank you! We'll be in touch soon.**).

* **Dismissed Message** → Message displayed if the user closes the form without submitting (e.g., **You dismissed the form.**).

<img className="block" src="https://mintcdn.com/chatnode-55/voSbmewMUDsA6Upv/images/messages-cl.webp?fit=max&auto=format&n=voSbmewMUDsA6Upv&q=85&s=a5227fbe8ffaddd722f48a4e9f0187e2" alt="Messages Cl" width="1738" height="534" data-path="images/messages-cl.webp" />

### Step 4: Inputs

Inputs are the fields that make up your lead form.

By default, common fields are provided:

* **Name**

* **Email**

* **Phone**

You can configure each field by editing:

* **Label** → What the user sees (e.g., **Your Email**).

* **Placeholder** → Example text inside the field (e.g., **Enter your email address**).

* **Required** → Toggle whether the field must be filled out before submission.

**Example Setup:**

* Name → Required text field.

* Email → Required email field.

* Phone → Optional text field.

<img className="block" src="https://mintcdn.com/chatnode-55/voSbmewMUDsA6Upv/images/inputs-cl.webp?fit=max&auto=format&n=voSbmewMUDsA6Upv&q=85&s=95aea767bafab5a6bf8874e73f093b5b" alt="Inputs Cl" width="1738" height="450" data-path="images/inputs-cl.webp" />

### Step 5: Webhook (Optional)

You can send collected lead data to an external system automatically.

* Submissions are sent as a POST request in JSON format.

* Configure your webhook endpoint in the settings tab.

* Example Event Name: collect\_info\_lead\_form

This is helpful if you want to sync leads with a CRM, Google Sheets, or another database.

<img className="block" src="https://mintcdn.com/chatnode-55/0YS3s-ubNlawEfQh/images/webhook-cl.webp?fit=max&auto=format&n=0YS3s-ubNlawEfQh&q=85&s=1aa51c73036fe2056a0b8d770c8c01d7" alt="Webhook Cl" width="1760" height="318" data-path="images/webhook-cl.webp" />

### Step 6: Enable the Action

At the top of the screen, switch from **Disable → Enable** to activate the lead collection action.

<img className="block" src="https://mintcdn.com/chatnode-55/vLxQUcFeBIXUl-sG/images/enable-action-cl.webp?fit=max&auto=format&n=vLxQUcFeBIXUl-sG&q=85&s=5ed5572d55a99bba64a5a63625e3077d" alt="Enable Action Cl" width="2052" height="414" data-path="images/enable-action-cl.webp" />

## Example Workflow

1. Visitor says: **I'd like more info.”**

2. AI Agent triggers the **Collect Leads** form.

3. User enters **Name, Email, and Phone Number**.

4. AI Agent confirms: **“Thanks! A team member will reach out to you shortly.”**

5. (Optional) Data is automatically pushed to your webhook endpoint.

With the **Collect Leads** action, you can turn conversations into valuable contacts, helping you grow your pipeline and engage potential customers more effectively.
