How to use Lead Received from Widget Webhook
Automatically Capture Every Website Visitor Who Messages You on WhatsApp — the Moment They Reach Out
You have a WhatsApp widget on your website. A visitor lands on your page, clicks the widget, and sends a message. That person is a potential lead — they came to your website, found your WhatsApp button, and took the effort to reach out.
But if no one is watching the inbox at that moment, that message sits there. The visitor waits. No one follows up. By the time someone on your team notices the message, the visitor has already moved on.
The Lead Received from Widget Webhook ensures this never happens. The moment any website visitor clicks your WhatsApp widget and sends a message, this webhook fires instantly — capturing their details and sending them to whatever system your team uses, so the right person can follow up immediately.
Before You Begin
This webhook works only if your DoubleTick WhatsApp Widget is already live on your website. If you have not set it up yet, follow the step-by-step guide here first:
How to Create a WhatsApp Widget on Your Website
Once your widget is live and receiving messages, come back here to set up the webhook.
What Is the Lead Received from Widget Webhook?
The DoubleTick Widget is a small WhatsApp button placed on your website. When a visitor clicks it, they are taken directly to a WhatsApp chat with your business number. The moment that visitor sends their first message through the widget, DoubleTick records them as a new lead and this webhook fires.
Think of it as an automatic lead catcher. Every person who reaches out through your website's WhatsApp button is captured instantly — with their details sent to your connected system before anyone on your team has even seen the message.
When Does This Webhook Trigger?
This webhook activates when:
A visitor clicks the WhatsApp widget on your website
They send a message to your WhatsApp Business number through that widget
DoubleTick records them as a new lead
In short: visitor clicks widget → sends WhatsApp message → webhook fires.
Step-by-Step Setup Guide
Step 1: Open Webhooks in DoubleTick
Log in to your DoubleTick account
Go to Settings
Click on Webhooks
Step 2: Create a New Webhook
Click New Webhook
Give it a clear name — for example:
Website WhatsApp Lead Tracker
Step 3: Get Your Webhook URL
You need a destination URL — this is where DoubleTick will send the lead data every time the webhook fires.
You can connect it to:
A CRM like Zoho, HubSpot, or Salesforce
An automation tool like Zapier or Pabbly
A spreadsheet like Google Sheets
Your own backend or internal system
For testing purposes, you can use DoubleTick's Bot Studio to capture and preview the data first:
Open a new tab and go to Bot Studio
Click Create New Bot
Set the trigger to On Webhook
Copy the webhook URL that appears
Step 4: Fill in Webhook Details
Go back to the Webhooks page
Paste the webhook URL
Select your API Number (your WABA/WhatsApp Business number)
Click Continue
Step 5: Choose the Event
Select Lead Received from Widget from the event list
Click Create Webhook
Your webhook is now live and capturing every widget lead the moment it arrives.
How to Test It
Go to your website and click the WhatsApp widget
Send a test message through the widget
Go to Bot Studio → Capture Response → View Response Data
You will see all the lead details captured at the exact moment the message was sent.
What Data Do You Receive?
When this webhook fires, it sends the following information to your system:
Customer Name
The name of the visitor who messaged through the widget
Phone Number
The customer's WhatsApp number
Email Address
The customer's email, if shared
Message
The first message the visitor sent
Source
Confirms the lead came through the widget
Timestamp
The exact date and time the message was received
Real-Life Business Use Case: An Interior Design Studio Capturing and Responding to Website Leads Within Minutes
The Situation
An interior design studio runs a website showcasing their portfolio of residential and commercial projects. Potential clients browse the website, get interested, and click the WhatsApp widget to enquire about pricing, availability, or to request a consultation. The studio's sales team manages all incoming leads and is responsible for following up and converting enquiries into booked consultations.
The Problem
The widget was generating enquiries throughout the day, but the process of handling them was entirely manual. When a visitor sent a message through the widget, it would arrive in DoubleTick's inbox and wait for a sales agent to notice it. During busy periods — or after working hours — messages would sit for hours without a response.
Interior design is a considered purchase. A potential client enquiring about a home renovation project is likely also browsing two or three competitor websites at the same time. The studio that responds first makes the strongest first impression and is most likely to get the consultation booked. Delayed responses were costing the studio warm leads to faster-moving competitors.
There was also no automatic record of widget leads in the studio's CRM. Agents had to manually create a new lead record for every widget enquiry, which was time-consuming and often inconsistent.
How the Lead Received from Widget Webhook Solves This
The studio connects this webhook directly to their CRM.
The moment a visitor clicks the widget and sends a message, the webhook fires and a new lead record is automatically created in the CRM with the customer's name, phone number, their opening message, and the timestamp of their enquiry. The lead is automatically assigned to the next available sales agent and that agent receives an instant notification on their phone.
The agent follows up within minutes — while the potential client is still actively browsing and engaged. The first message they receive from the studio arrives before they have even finished looking at the portfolio.
For enquiries that come in after working hours, the webhook still fires and creates the CRM record immediately. The agent assigned to that lead sees it first thing the next morning and follows up at the start of the business day — with the full context of when the enquiry came in and what the client asked.
The Result
Every widget lead is automatically captured in the CRM the moment it arrives — with zero manual data entry from any agent
Response times drop from hours to minutes for enquiries that come in during working hours
After-hours leads are not lost — they are recorded immediately and followed up first thing the next morning
The sales team always has a clean, organised lead queue in the CRM with full details of every website enquiry
The studio's conversion rate on website leads improves because faster, more informed follow-up makes a stronger first impression
Summary
The Lead Received from Widget Webhook turns your website's WhatsApp button into an automated lead capture system. Every visitor who clicks the widget and sends a message is instantly recorded, their details are sent to your CRM or connected system, and your team is notified — all before anyone has manually checked the inbox. For businesses where website leads are a key source of new customers, this webhook ensures that no enquiry is ever missed, delayed, or handled inconsistently.
Set it up once, and every website lead is captured, logged, and actioned automatically.
Last updated