Send a lead. Get the call result.
One HTTPS request puts a lead in your agent’s queue; it is called within seconds. When the call ends, the result comes back to your webhook.
1. Send a lead
POST JSON to your agent’s lead link with its secret in the header. Only phone is required; every other field is passed to the agent and can be used in the script as {{field}}.
POST https://api.dinus.in/api/lead-intake/{agent_slug}
Content-Type: application/json
X-Dinus-Lead-Secret: {your_secret}
{
"phone": "9848022338",
"name": "Ramesh",
"project": "Sri Lakshmi Towers",
"budget": "80 lakh"
}Response, straight away:
202 Accepted
{ "accepted": true, "calling": "within seconds" }
// outside calling hours:
{ "accepted": true, "calling": "next calling window (10:00–19:00)" }| Field | Required | Notes |
|---|---|---|
phone (or mobile, phone_number) | Yes | 10-digit Indian mobile or with 91 / +91 |
name (or full_name) | No | Used to greet the customer |
| Any other field | No | Available to the agent, for example project, course, order_id |
2. Receive the result
Add your webhook URL to the agent. After every call we POST the result, retrying up to 3 times if your server doesn’t answer with 2xx.
POST {your_webhook_url}
Content-Type: application/json
{
"event": "call.completed",
"call": {
"id": "c_x1Y2z3",
"to": "919848022338",
"name": "Ramesh",
"status": "completed",
"duration_sec": 94,
"outcome": "booked",
"summary": "Interested in 2BHK for own use, budget 80 lakh, site visit Saturday 11 am.",
"data": { "purpose": "own use", "budget": "80 lakh", "visit_date": "Saturday 11:00" },
"languages": ["te-IN"],
"recording_url": "https://…",
"transcript": [{ "role": "agent", "text": "…" }, { "role": "customer", "text": "…" }]
}
}Outcomes: interested, booked, callback, not_interested, wrong_number, no_response, do_not_call, other.
3. No code? Use Zapier or Pabbly
Add a webhook action in Zapier, Pabbly Connect, Make or n8n, paste the lead link, add the X-Dinus-Lead-Secret header and map the phone and name fields from your form or Meta Lead Ads.
Questions
Where do I find my lead link and secret?
Open your agent in the dashboard. The lead link and secret are under "Connect your leads". Each agent has its own.
How fast is a lead called?
Within seconds, when the agent is live and it is inside the agent’s calling hours. Leads outside hours are called when the window opens.
Is the same number called twice?
No. If a number is already waiting in the queue, the new request is accepted but not added again.
Do you have SDKs?
You don’t need one: it is one HTTPS POST with JSON. Zapier, Pabbly, Make and n8n can call it with their webhook step.