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-08-02

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

FieldTypeDescription
limitintegerRows per page (max 500)
offsetinteger0-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

FieldTypeDescription
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

FieldTypeDescription
rows*array[{cells}] — the columns to insert. No address: an append has nothing to address.

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

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, and db.append — 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.

$2.99 free credit on signup

Connect PostgreSQL to your AI voice agent

Sign up free and get $2.99 in credit — no card required. Connect your number, pick a template, and go live in minutes.