Skip to content
English
  • There are no suggestions because the search field is empty.

Webhook Integration: Understanding Lead Status Notifications

Meera can send real-time lead status updates to your system using webhooks. This allows your team to stay in sync with how leads are progressing through your campaigns — from the moment they’re posted, to calls, transfers, and final outcomes.

🛠️ How It Works

This guide will walk you through what’s included in the webhook, the different statuses you may see, and how to interpret the data.

When a lead’s status changes, Meera sends a webhook (a type of automated notification) to the URL you’ve configured.

  • Webhook URL (Example):
    https://example.com/api/webhooks/meera

  • Authorization:
    Basic {Base64 encoded Meera API token}

  • Content Type:
    application/json

📌 These settings are typically used by your development or IT team to connect Meera to your internal systems.

 

🧾 What’s in the Webhook?

Meera’s webhook includes a structured JSON payload that contains two main sections:

  1. General Status Info

  2. Detailed Lead Information

 

1. ✅ General Status Info

Field Description
status Confirms the webhook was sent successfully (should be true)
message Usually displays "Success"
pushbackUrl The receiving URL provided by your system
lead_status The current status of the lead (see list below)

 

2. 👤 Lead Details (lead_details)

This section contains a comprehensive view of the lead, including contact info, campaign info, status updates, and call activity.

Key Fields:

  • Lead Identity:
    lead_id, first_name, last_name, full_name, email, mobile_number

  • Campaign Info:
    campaign_name, campaign_id, campaign_timezone, external_system_id

  • Status Details:
    current_status ("open" or "close"), lead_status, message_status

  • Call & Response Activity:

    • responded / responded_date_time

    • called / called_date_time / call_status

    • call_attempt, total_call_duration, representative_call_duration

  • Transfer & Conversion:

    • transfered, transfered_date_time

    • converted_inbound, converted_outbound, all_converted

  • Other Fields:

    • send_welcome_msg (Yes/No)

    • dnd_status, dnd_reason

    • soft_close, soft_close_reason

    • confirm_rsvp, scheduled, scheduled_date_time

    • external_caller_id, user_timezone, rep_phone

  • Custom Fields:
    The lead_info section includes any custom fields based on how your campaign is set up.

 

📋 Lead Statuses You May See

Here are the possible values you’ll receive under the lead_status field. Each reflects a different point in the lead’s journey:

NotDone  
Undelivered
Responded
Scheduled
Called
Transferred
DNC (Do Not Contact)
Converted
NoRepResponse
Delivered
ClosedAfterFollowup
ClosedByClient
BadPhone
RepCall30SEC
Posted
LcmExpensiveOutOfBudget
LcmAlreadySpokeWithRep
LcmExpensiveHealthIssues
LcmLeadClose

 

✅ What to Expect

Each webhook payload gives you a real-time snapshot of a lead’s progress — whether they’ve been contacted, responded, scheduled for a call, or marked as converted. This makes it easy to track performance, sync with your CRM, or trigger your own automation.

 

🧩 Further Reading

To better understand how these lead status updates are sent through webhooks, refer to our article on the full webhook flow: Understanding the Webhook Flow in Meera AI

 

📞 Need Help?

If you need assistance setting up your webhook URL, decoding the payload, or understanding how to map this data into your system, our team is happy to help.

Reach out at help@meera.ai