Integration

DatabaseConnect with an API key

PostgreSQL voice AI integration

The PostgreSQL integration connects your AI voice and chat agents to PostgreSQL, so they can db.query 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.

PostgreSQL API docs

Last updated 2026-09-15

What your agent can do with PostgreSQL

db.queryquery db

Read a page of rows from a PostgreSQL database using the configured SELECT. For filling a call list — not for looking a record up mid-call.

Inputs

Field	Type	Description
limit	integer	Rows per page (max 500)
offset	integer	0-based row offset of this page

db.updateupdate db

Write call outcomes back onto the rows they were read from — the campaign write-back path for PostgreSQL.

Inputs

Field	Type	Description
rows*	array	[{row_number, cells}] — address plus the columns to set

db.appendappend db

Append a row for every call — the destination path for PostgreSQL. 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 up a recordfind db

Look a record up in the connected PostgreSQL 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 recordcreate db

Create a new record in the connected PostgreSQL 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.

Update a recordmodify db

Change a record in the connected PostgreSQL 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 PostgreSQL

Connect with an API key. In Telenow, open Integrations → PostgreSQL and provide:

Password — Use a role with SELECT only. This connector never writes, but a read-only role is what makes that true rather than promised.
Host — Must be reachable from the public internet and allowlisted to our egress IP. A private or VPC-internal address is refused.
Port — 5432
Database
User
TLS mode — verify-full (default), verify-ca, or require. Certificate verification is also what stops a hostname being re-pointed at an internal address between the safety check and the connection, so lowering it weakens more than encryption. `disable` is refused.

Other Database integrations

MySQL / MariaDB

Read call targets straight out of a MySQL or MariaDB database with a SELECT you write.

SQL Server

Read call targets straight out of a Microsoft SQL Server or Azure SQL database with a SELECT you write.

MongoDB

Read call targets straight out of a MongoDB collection with a filter or aggregation pipeline you write.

Frequently asked questions

What can an AI voice agent do with PostgreSQL?+

During a live call or chat, a Telenow agent can db.query, db.update, 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 PostgreSQL in real time without a human.

How do you connect PostgreSQL to Telenow?+

In Telenow, open Integrations, pick PostgreSQL, and you paste a PostgreSQL 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 PostgreSQL in a ready-made agent?+

Yes — add PostgreSQL to any Telenow agent, or start from a template and attach it as a tool.

Does PostgreSQL work on phone calls and WhatsApp?+

Yes. Telenow agents run on phone, web, chat and WhatsApp, and PostgreSQL works the same across every channel — the agent calls it whenever the conversation needs it.

How much does the PostgreSQL integration cost?+

Connecting PostgreSQL is included — you only pay Telenow's transparent per-minute and per-component usage, and new accounts get free signup credit to try it.

$1.00 free credit on signup

What your agent can do with PostgreSQL

What you'll need to connect PostgreSQL

Other Database integrations

Frequently asked questions

Connect PostgreSQL to your AI voice agent