Integration
MongoDB voice AI integration
The MongoDB integration connects your AI voice and chat agents to MongoDB, so they can db.update on a live call. It's a database connector that runs as a tool the agent calls mid-conversation — you connect with an api key, attach it to an agent, and it acts in real time without a human in the loop.
Last updated 2026-09-16
What your agent can do with MongoDB
Write call outcomes back onto the rows they were read from — the campaign write-back path for MongoDB.
Inputs
| Field | Type | Description |
|---|---|---|
| rows* | array | [{row_number, cells}] — address plus the columns to set |
Read a page of documents from a MongoDB collection using the configured filter or pipeline. For filling a call list — not for looking a record up mid-call.
Inputs
| Field | Type | Description |
|---|---|---|
| limit | integer | Documents per page (max 500) |
| offset | integer | 0-based offset of this page |
Append a row for every call — the destination path for MongoDB. Unlike write-back this INSERTS, because a call is often about somebody who was never in the table.
Inputs
| Field | Type | Description |
|---|---|---|
| rows* | array | [{cells}] — the columns to insert. No address: an append has nothing to address. |
Look a record up in the connected MongoDB during the call — e.g. find the caller's account, order or booking by phone number, email or reference. Returns only the fields this tool was set up to read.
Inputs
| Field | Type | Description |
|---|---|---|
| limit | integer | Most records to return (1-20, default 5). |
| search_column | string | Which field to look in. Omit when the tool has only one searchable field. |
| search_value* | string | The value to look for — e.g. the caller's phone number or a booking reference. |
Create a new record in the connected MongoDB during the call — a ticket, a lead, a booking. Only the fields this tool was set up with can be filled.
Inputs
| Field | Type | Description |
|---|---|---|
| cells | object | Field → value for the new record. |
Change a record in the connected MongoDB during the call. Look the record up first, then pass the id it returned along with only the fields that changed.
Inputs
| Field | Type | Description |
|---|---|---|
| cells | object | Field → new value, for just the fields that changed. |
| record_id* | string | Identifies the record to change — take it from the look-up tool's result. |
What you'll need to connect MongoDB
Connect with an API key. In Telenow, open Integrations → MongoDB and provide:
- Password — Use a user with a read-only role (`read` on this database). MongoDB has no read-only transaction, so on this engine the user's role is the strongest guarantee available.
- Host(s) — One host, or the comma-separated list from your driver connection string — the part between `@` and `/`. NOT a mongodb+srv:// name: that resolves through an SRV record rather than to an address, so it cannot be checked before we connect. On Atlas, use the standard connection string, or run: dig +short SRV _mongodb._tcp.<cluster>.mongodb.net . Every host must be publicly reachable and allowlisted to our egress IP.
- Port — 27017
- Database
- User
- Auth database — Where the user is defined, which is often not the database being read. Atlas keeps users in `admin` — the default here.
- TLS mode — verify-full (default) validates the certificate. `require` still encrypts but skips validation, which also gives up the guard against a host name being re-pointed at an internal address. `disable` is refused.
- Replica set — Set this to follow a failover instead of breaking on one — strongly recommended for any hosted cluster. On Atlas it is in the TXT record: dig +short TXT <cluster>.mongodb.net . Leave blank to pin a single host, which is stricter but does not survive the primary moving.
Other Database integrations
Frequently asked questions
What can an AI voice agent do with MongoDB?+
During a live call or chat, a Telenow agent can db.update, db.query, db.append, look up a record, create a record, and update a record — each runs as a tool the agent calls mid-conversation, so it acts on MongoDB in real time without a human.
How do you connect MongoDB to Telenow?+
In Telenow, open Integrations, pick MongoDB, and you paste a MongoDB API key into the connection, then bind it to your agent. Then add its database tool to your agent (or install a template that already includes it) and you're live.
Can I use MongoDB in a ready-made agent?+
Yes — add MongoDB to any Telenow agent, or start from a template and attach it as a tool.
Does MongoDB work on phone calls and WhatsApp?+
Yes. Telenow agents run on phone, web, chat and WhatsApp, and MongoDB works the same across every channel — the agent calls it whenever the conversation needs it.
How much does the MongoDB integration cost?+
Connecting MongoDB is included — you only pay Telenow's transparent per-minute and per-component usage, and new accounts get free signup credit to try it.
Connect MongoDB to your AI voice agent
Sign up free and get $1.00 in credit — no card required. Connect your number, pick a template, and go live in minutes.