# AI voice bot database lookup: how to connect and test it

The bot searches your catalog, schedule or stock mid-conversation: a developer brief, the database search trigger, parameter prompts and call review.

Section: AI voice bot · Updated: 2026-11-11 · http://my.lptracker.ru/land/lk/faq/?a=voice-bot-dynamic-database&lang=en

> **In short:** AI voice bot database lookup (a dynamic database) is a search in your own data during the call: AI takes parameters from the conversation (date, service, district), the platform sends a GET request to your server, and the bot answers only from the records it finds. You set it up on the “Triggers” tab of the bot card: “Add trigger” → the database search action → keywords, a link and parameters with prompts.

AI voice bot database lookup is what you need when there is so much data that the bot starts mixing it up. A real estate agency has hundreds of apartments, a taxi fare depends on two addresses, a clinic or salon runs the schedules of a dozen specialists, and a store has a catalog of thousands of products. You can't load all of that into the bot at once: the call gets pricier, the bot confuses dates and prices, and the client goes to a competitor.

With a dynamic database, the bot finds the two or three rows it needs right during the conversation — apartments within budget, the fare, a stylist's free time, stock on hand — and books the client for an exact time by itself. This is the voice bot's main advantage: large live databases with no made-up answers. There is no separate fee — only conversation minutes, $0.12 per minute on average. Watch the two-minute video, and below you'll find the developer brief, the setup and a breakdown of mistakes.

[Video: AI voice bot database lookup: how to connect and test it](http://my.lptracker.ru/land/n/multic/faq_media.php?f=2026-11/voice-bot-dynamic-database-en-f9e01f.mp4)
- 0:03 Database lookup
- 0:15 Check first
- 0:24 Developer brief
- 0:35 New trigger
- 0:45 Parameters
- 0:54 Launch phrase
- 1:04 Chat test
- 1:15 Call review
- 1:27 Summary

## What a dynamic database is and how it works during a call

A dynamic database is a search in your data during the call through a webhook: a link the platform uses to query your server by itself. On the bot card, it is a trigger with the database search action. Here is how it works:

1. A keyword is said — by the client (“any free time tomorrow?”) or by the bot (“Checking the schedule...”).
2. AI uses the parameter prompts to take the date, service, district or item number from the conversation.
3. The platform sends a GET request, and the bot says a short pause phrase like “one second, let me check”.
4. Your server returns a short answer: three free slots, five apartments, the stock of an item.
5. The bot answers from the “Dynamic webhook instruction” — only from this data, so it doesn't mix up dates.

## When you don't need a dynamic database

First check whether a regular loading webhook is enough — it usually is. Connect a Google document with your data (“Webhooks” → the loading webhooks block) and ask the bot about dates, services and prices in “Training AI”. If it doesn't get confused, you don't need a developer. The platform recommends keeping loading data within 50 KB and 7 seconds, and it won't save more than 100 KB or 10 seconds. Read more in “[AI voice bot knowledge base](http://my.lptracker.ru/land/lk/faq/?a=voice-bot-knowledge&format=md&lang=en)”.

For Yclients you don't need a developer either: the wizard on the “Integrations” tab creates the database search trigger by itself — a ready-made example of a dynamic database, see “[Yclients integration](http://my.lptracker.ru/land/lk/faq/?a=yclients-integration&format=md&lang=en)”. Free time from Google Calendar comes in through its own wizard: “[Google Calendar integration](http://my.lptracker.ru/land/lk/faq/?a=google-calendar-integration&format=md&lang=en)”.

## Developer brief: three endpoints and the response format

A developer writes the middleware — a small piece of code between the bot and your database. The database can be anything: a spreadsheet, XML, MySQL, a CRM or a booking service with an API. First list the search parameters (date, service, staff member), then hand over the task. Booking needs three endpoints:

- A directory of services and staff with their IDs goes into a loading webhook: AI uses it to turn the client's words into an ID.
- A slot search, for example `https://example.com/slots?date=24.03.2026&service_id=3`, goes into the database search trigger.
- The booking itself goes into “Webhooks” → the write webhook block.

Requirements for the search response:

- Short: up to three slots closest to the requested time; for a catalog, 3–5 items.
- Plain text, JSON or XML with clear field names; in our setup experience, the bot reads XML most reliably.
- Instead of “error” or code 500 — a phrase with a hint, so the bot asks the client again by itself.
- Fast and GET only: the client is waiting on the line the whole time.

| What the search received | What to return to the bot |
| --- | --- |
| Date and service | A `freeSlots` block with three slots: 09:00, 12:00, 12:30 |
| No date | Please choose a day that suits you for the appointment. |
| Day off | No free slots. Please choose another day. |

The trigger's ready-made answer instruction understands the `freeSlots` block. Before setup, open every link in a browser: remove the date, change the service, pick a day off. You can build the middleware yourselves or order a turnkey setup with the button at the end of the article.

## How to set up the database search trigger

1. **Add a trigger** — “Triggers” tab → “Add trigger”. A new trigger gets the database search action and a demo database right away: the bot asks for an account number and reads out the balance.
2. **Enter the keywords** — Fill in the “Trigger name”, for example “Schedule”, and the trigger keywords field: the phrase the bot says before the search (“checking the schedule”) and, if you like, client phrases.
3. **Check the pause** — The pause filler phrase: a new trigger already has a short “one second, let me check” phrase with a 2,000 ms delay.
4. **Paste the link** — The search address goes into the dynamic database request URL field, method GET. Put constant values straight into the link: `city=nyc`.
5. **Add parameters** — Delete the demo parameter `akk`, click “Add parameter”, and set the parameter name in Latin characters and the parameter prompt. The parameter is added to the link by itself: `date=${date}`.
6. **Describe the answer** — “Dynamic webhook instruction”. If left empty, a ready-made instruction for booking slots is used; for a catalog or stock, rewrite it. Click “Save”.

An enabled trigger without keywords won't save — a window will warn that the trigger keywords are empty. The parameter model field isn't always visible: a new trigger sets the standard model by itself.

![An AI voice bot database lookup is set up with the database search trigger](http://my.lptracker.ru/land/n/multic/faq_media.php?f=2026-11/voice-bot-dynamic-database-1-en-089f74.webp)

## How to write a parameter prompt: examples for dates, IDs and names

A parameter prompt is a question to AI that it answers with a single value from the conversation. State the format and what to write if there is no value:

| Parameter | Prompt | What goes into the link |
| --- | --- | --- |
| `date` | Write the booking date and time strictly as DD.MM.YYYY HH:MM. If no day was named, write -. No comments. | 24.03.2026 14:00 |
| `service_id` | Which service from the directory matches the client's choice? Write only its ID in digits. | 3 |
| `district` | Which district did the client name? One word. If none, write -. | Midtown |

A short list, such as branches, can be spelled out right in the prompt: “downtown branch — 1, airport branch — 2”. The client says “hair dye”, but the directory says “Hair coloring”? Have the bot name the service as it appears in the directory and confirm it: then AI picks the right ID.

## How the bot starts the search: a phrase in the conversation plan

It's most reliable to start the search with the bot's own phrase: it says it once it has all the parameters. Open the “Instruction” tab → “Plan” → the “Conversation plan” block, click “Add step” and drag the steps into place:

1. After the question about the service: “Name the service as it appears in the directory and confirm it”.
2. After the question about the day: “When you know the service and the day, write ‘Checking the schedule...’, add nothing else and wait for an answer”.
3. For a repeat search: “If the client wants another day or service, write ‘Checking the schedule...’ again”.

Keep these steps together, and put other questions before or after them. Before booking, have the bot repeat the summary: service, staff member, date and time.

> Tech first, sales second: until the search fires reliably, don't add qualifying questions or objection handling. If the search starts before the client has named a day, AI will insert today's date — remove the extra steps before the search.

## How to test the dynamic database in Training AI

Open the test chat: “Training AI” → “Manual training” → “Start training” — and write as a client, naming a service and a day. When the trigger fires, a “Webhook: <trigger name>” block appears in the chat: the keyword, the “AI answer” for each parameter, the final link and the database answer.

Check the parameters against the directory. Not happy with the bot's reply after the block? “Fix” under it edits the “Dynamic webhook instruction”, not the main one. The answer stability check link repeats the request 10 times and shows whether dates and prices drift. Check the booking in the “Data write test” → “Test the data write”. Read more in “[How to train an AI voice bot](http://my.lptracker.ru/land/lk/faq/?a=voice-bot-training&format=md&lang=en)”.

> The “Data write test” sends a real request: delete the test booking in your system afterwards.

![Testing an AI voice bot database lookup in the test chat](http://my.lptracker.ru/land/n/multic/faq_media.php?f=2026-11/voice-bot-dynamic-database-2-en-559cd0.webp)

## How to review a call with a dynamic database

Did the bot name the wrong time on a real call? Open “Training AI” → “Find a call”, paste the ID from “Call details” or pick a call from the last 7 days → “Open the call”. The webhooks take their places in the conversation:

1. The init webhook block — what the bot knew before the conversation, such as the directory.
2. The dynamic database webhook block — the link, the AI sub-request parameters and the server response with its HTTP code. A wrong parameter means you should fix its prompt.
3. The smart answer block — what the bot said based on this data. Wrong slots — “Fix” under the bot's reply.
4. The write webhook block — your system's response. For example, AI wrote update instead of create, and the booking wasn't created: refine the prompt — new booking create, reschedule update, cancellation delete.

Compare against the server response saved in the call: a link opened again will already show different slots.

![Reviewing an AI voice bot call with database lookup](http://my.lptracker.ru/land/n/multic/faq_media.php?f=2026-11/voice-bot-dynamic-database-3-en-d2c877.webp)

## Common mistakes

- The trigger doesn't fire: it is turned off, or the keywords aren't in what the bot and the client actually say.
- The bot booked the wrong service: the loading webhook has no directory, or the bot didn't name the service as in the directory.
- Long silence on the line: the server responds slowly — speed up the search on your side.

## Frequently asked questions

### What is AI voice bot database lookup?
It's a search in your database during the call through the database search trigger: AI takes parameters from the conversation, and the bot answers only from what it finds.

### Do I need a developer for a dynamic database?
For your own database, yes: you need an endpoint that searches by parameters. Yclients has a ready-made wizard, and your own database can be connected turnkey — the button is at the end of the article.

### How much does AI voice bot database lookup cost?
There is no separate fee: a conversation minute costs $0.12 on average. AI gets the database data only when the trigger fires, so the minute doesn't get pricier the way it does with large loading webhooks.

### What format should the server use to answer the bot?
Plain text, JSON or XML with clear fields, kept short — up to three slots — and a phrase with a hint instead of an error.

### Can the bot search the database several times during one call?
Yes: a step in the “Conversation plan” tells the bot to say the search phrase again if the client wants another day or service.

**Read also:** [AI voice bot knowledge base](http://my.lptracker.ru/land/lk/faq/?a=voice-bot-knowledge&format=md&lang=en), [How to train an AI voice bot](http://my.lptracker.ru/land/lk/faq/?a=voice-bot-training&format=md&lang=en), [Turnkey AI voice bot](http://my.lptracker.ru/land/lk/faq/?a=voice-bot-turnkey&format=md&lang=en)