Calls through a REST API: sending a lead from your website and getting the result back
Sado AI team · · 4 min read
In short
A REST API is a simple way for programs to send each other requests over the internet. For calls it works like this: your website, app or internal software sends a new lead to Sado, the AI operator calls right away, and the result (a short summary and next step) comes back to your system by webhook. With each lead, send the phone, name, topic, the reason you may call and your own ID. With Bitrix24 or another ready connection, you don’t need the API.
A REST API in plain words
An API is an agreed language one program uses to tell another “here’s a lead, call them”. With a REST API, the request goes to an ordinary web address, the data is in JSON, and a secret key proves who sent it.
For example, when someone presses “Send” on your website form, your server sends Sado one request: phone, name and topic. For a business owner, the point is simple: a lead comes in from the website, nobody copies anything, and the call starts by itself.
What an API gives you for calls
- A website form is filled in, and the operator calls the customer right away, while they’re still on your site.
- Someone taps “Call me back” in your mobile app: the same.
- A list from your internal software, such as tomorrow’s deliveries, goes out for calls.
- Leads from Instagram or ad forms work the same way: the service that collects them passes them to the API.
- Results come back into your own report or CRM: who was interested, who booked, what the next step is.
What to send with a lead
| Data | Example | Why |
|---|---|---|
| Phone | +998 XX XXX XX XX | To make the call |
| Name | Aziz | To address the customer by name |
| Topic | 2-room apartment | The operator knows where to start |
| Reason you may call | Website request | Only people you may call are called |
| Your own ID | site-form-1042 | If a lead is sent twice, no second lead is created |
Exact field names and the full reference are on the developers page.
Steps for developers
- Read the developers page: request examples and the full reference are there.
- Get an API key and keep it on the server only. Never put it in website code, the browser or a chat.
- When a lead comes from a form, send the request from your server.
- Check the response: on an error, log it and retry later with the same ID.
- To receive results, connect a webhook address. How that works: how webhooks work.
- Send a test lead with your own number, take the call and check that the result came back to your system.
Security and rules
- An API key is a password: if someone has seen it, replace it at once.
- Send only people you may call: those who left a request, gave consent or are your customers.
- A number that says “don’t call me” isn’t called again.
- Calling hours, the daily limit and the stop button are in the portal; set them before you switch on the API.
- Don’t send more than needed: phone, name and topic are enough.
Do you need the API, or can you do without a developer?
Often you don’t need the API. Bitrix24 has a ready connection: as soon as a lead reaches the stage you choose, the operator calls. Our team connects amoCRM, Google Sheets, 1C, BILLZ and MoySklad with you. If your list is in Excel, just upload it to Auto-calls.
The price is the same whichever way you use: only talked minutes, 800 so‘m a minute. More: AI outbound calls, Bitrix24 AI calling and pricing. Try it live or call 78 778 01 23.
Questions
What do I need to make calls through the API?
A developer, a Sado API key and a server that sends the leads. The full reference and request examples are on the developers page.
When does the operator call a lead sent by API?
Right away, within the calling hours you set. You set the hours and the daily limit in the portal yourself.
Can I send a whole list through the API?
Yes. Send a list through the API and the operator calls each person on it. Calling hours and the daily limit are set in the portal.
How much does a call through the API cost?
Sado charges only for talked minutes: 800 so‘m a minute, with no monthly or setup fee. Unanswered numbers cost nothing.