# Telenow Documentation

> Telenow is a white-label voice & chat AI platform: teams build AI agents for phone, web, chat and WhatsApp on their own LLM, carrier and brand — with knowledge bases, integrations, outbound campaigns, analytics, white-label and a full REST API.

This file helps AI assistants and crawlers find Telenow's documentation. Each link points to the raw Markdown of a page.

## Getting started

- [Introduction](https://telenow.ai/docs-md/introduction.md): Telenow is a platform for building and operating AI voice agents. You design an agent in the dashboard (its model, voice, prompt, and knowledge), give it a phon
- [Quickstart](https://telenow.ai/docs-md/quickstart.md): This guide takes you from a fresh account to a working voice agent and your first API call.
- [Core concepts](https://telenow.ai/docs-md/core-concepts.md): A handful of objects show up across the dashboard and the API. Understanding them makes everything else straightforward.

## Product guide

- [Building agents](https://telenow.ai/docs-md/building-agents.md): An agent is the configured voice assistant that talks to your callers. You build one in the dashboard under Agents → New agent; the same configuration is also w
- [Flow agents (graph)](https://telenow.ai/docs-md/flow-agents.md): Most agents are single-context: one system prompt, one brain, one voice, answering whatever the caller asks. That's the standard builder, and it's the right cho
- [Context variables](https://telenow.ai/docs-md/context-variables.md): Context variables let one agent serve many callers with personalized prompts. You write {placeholder} tokens in the agent's context (its system prompt and its g
- [Agent versioning](https://telenow.ai/docs-md/agent-versioning.md): Every time you save an agent, Telenow keeps a complete, immutable snapshot of how it was configured at that moment. Tweak a prompt, swap a voice, add a tool — e
- [Agent templates](https://telenow.ai/docs-md/templates.md): A template is a reusable snapshot of an agent's whole setup — its system prompt, opener, model/voice/transcription stack, tools, pre-call lookups, knowledge wir
- [Knowledge bases (RAG)](https://telenow.ai/docs-md/knowledge-bases.md): A knowledge base lets an agent answer from your content — product docs, FAQs, policies, price lists — instead of relying only on the language model's training. 
- [Integrations & connectors](https://telenow.ai/docs-md/integrations.md): Telenow agents don't just talk — they act. An agent can append a row to your Google Sheet, create a CRM lead, send a WhatsApp confirmation, raise a Razorpay pay
- [WhatsApp](https://telenow.ai/docs-md/whatsapp.md): Telenow gives you two ways to use WhatsApp, and they work together:
- [Phone numbers](https://telenow.ai/docs-md/phone-numbers.md): To take or place real phone calls, an agent (or a team member) needs a phone number. Telenow gives you three ways to get one:
- [Telephony providers](https://telenow.ai/docs-md/telephony-providers.md): Telenow speaks to the phone network through six interchangeable carrier integrations. Every platform feature — inbound and outbound AI calls, the dialer, member
- [SIP trunking](https://telenow.ai/docs-md/sip-trunking.md): Connect your own SIP trunk — a telco gateway, wholesale carrier, or PBX — directly to Telenow. No CPaaS sits in between: signaling is native SIP over UDP and me
- [Telephony compliance](https://telenow.ai/docs-md/compliance.md): In many countries you can't just buy a phone number and start dialling — the carrier (and the local telecom regulator behind it) needs to know who is using the 
- [Making & receiving calls](https://telenow.ai/docs-md/making-calls.md): Telenow runs conversations three ways: AI‑agent calls (the agent talks autonomously), the human softphone dialer (a person on the line, the AI is out of the loo
- [Calls, recordings & insights](https://telenow.ai/docs-md/call-history.md): Every finished conversation — phone, softphone, or web — is stored as a call with its transcript, duration, outcome, quality metrics, and (optionally) a recordi
- [Post-call analysis](https://telenow.ai/docs-md/post-call-analysis.md): Post-call analysis turns every finished call into structured data — a summary, sentiment, an outcome (disposition), action items, objections, your own custom fi
- [Caller memory](https://telenow.ai/docs-md/caller-memory.md): Caller memory lets your agents remember the people they talk to across calls. When a known caller dials in again, the agent already knows who they are and what 
- [Outbound campaigns](https://telenow.ai/docs-md/campaigns.md): A campaign dials a list of contacts with one of your agents, at a concurrency you choose and within an optional calling window. Use campaigns for reminders, sur
- [Do-Not-Call (DNC)](https://telenow.ai/docs-md/do-not-call.md): The Do-Not-Call list is your organization's suppression list — phone numbers that Telenow must never dial. Add the people who opt out, complain, or otherwise ca
- [Analytics & wallboard](https://telenow.ai/docs-md/analytics.md): Telenow gives you three live windows into your call operations, all self-serve from the dashboard:
- [Audit log](https://telenow.ai/docs-md/audit-log.md): The Audit log is your organization's who‑did‑what trail. Every authenticated request that changes something — creating an agent, revoking an API key, allocating
- [Team & workplace](https://telenow.ai/docs-md/team-workplace.md): The Workplace area is where owners and admins manage the organization, the people in it, and how inbound calls are routed to those people. Everything on this pa
- [Publishing & embedding](https://telenow.ai/docs-md/publishing.md): Beyond phone numbers, you can put an agent in front of website visitors and end users in three ways — all configured by you from the dashboard, with no help fro
- [Usage & billing](https://telenow.ai/docs-md/billing-usage.md): Telenow meters every call, chat, and agent action per organization, settles each into a money charge, and shows you the running total in your chosen currency. T
- [White-label & branding](https://telenow.ai/docs-md/white-label.md): Telenow can present your brand instead of ours on the surfaces your customers and team see — the login page, the dashboard sidebar, and (via the embed) your own

## API reference

- [Overview & conventions](https://telenow.ai/docs-md/api-overview.md): The Telenow REST API lets you do everything the dashboard does — manage agents, place calls, stream events, run chats, and more. This page covers the convention
- [Authentication](https://telenow.ai/docs-md/authentication.md): Telenow supports two ways to authenticate API requests:
- [Agents](https://telenow.ai/docs-md/api-agents.md): Create and manage the AI voice agents that handle calls. See Building agents for the concepts.
- [Tools & function calling](https://telenow.ai/docs-md/api-tools.md): Tools let an agent take actions mid‑conversation — look up an order, book a slot, transfer the call, or hang up — by calling functions you define. Telenow expos
- [Custom LLM & API](https://telenow.ai/docs-md/custom-models.md): Beyond the built‑in providers in the catalog, Telenow can drive an agent with your own model in two ways:
- [Sessions & calls](https://telenow.ai/docs-md/api-sessions-calls.md): A session is a live conversation; a finished session becomes a call record. This page covers placing outbound calls, reading session state, transferring and mon
- [Web-call API & WebSocket](https://telenow.ai/docs-md/api-web-call.md): The web-call API runs a conversation in the browser over a WebSocket — the visitor's microphone streams to the agent and the agent's voice streams back, with no
- [Chat API](https://telenow.ai/docs-md/api-chat.md): The Chat API runs a text conversation with an agent over plain REST — same brain, knowledge bases (RAG) and tools as a voice call, no WebSocket, no audio. Build
- [Recordings](https://telenow.ai/docs-md/api-recordings.md): List call recordings and fetch time‑limited download URLs. All endpoints are organization‑scoped (API key or JWT + X-Org-Id) and return the dashboard envelope {
- [Phone numbers](https://telenow.ai/docs-md/api-numbers.md): Search, buy, assign, and manage phone numbers, plus the regulatory compliance flow. See Phone numbers for concepts.
- [Knowledge bases](https://telenow.ai/docs-md/api-knowledge.md): Manage knowledge bases, the documents an agent answers from, and the agent attachments that turn on RAG. See Knowledge bases for the concepts and API overview f
- [Catalog & providers](https://telenow.ai/docs-md/api-catalog.md): The catalog lists the LLM, speech-to-text, text-to-speech, and telephony providers (and their models, pricing, and capabilities) available to your agents. Use i
- [Publishing & widget](https://telenow.ai/docs-md/api-publish.md): These endpoints control an agent's public widget — the hosted page and embeddable button — and let an embedded widget start an anonymous session. See Publishing
- [Campaigns](https://telenow.ai/docs-md/api-campaigns.md): Create and run outbound dialing campaigns over HTTP. All endpoints are organization‑scoped under /api/orgs/{orgId}/campaigns.
- [Do-Not-Call (DNC)](https://telenow.ai/docs-md/api-dnc.md): The Do‑Not‑Call list is your suppression list: numbers on it are never dialed by campaigns (or one‑off outbound/transfer calls). Use it to honor opt‑outs and st
- [Carriers (BYOC)](https://telenow.ai/docs-md/api-carriers.md): Two ways to run calls over infrastructure you control:
- [Analytics & usage](https://telenow.ai/docs-md/api-reporting.md): Read-only reporting for your organization: call analytics and metered usage/quota. Both are organization-scoped (API key or JWT + X-Org-Id).
- [Audit log](https://telenow.ai/docs-md/api-audit.md): The audit log records every authenticated mutating request against your organization — who did what, against which endpoint, when, and with what result — for se
- [Organizations, team & API keys](https://telenow.ai/docs-md/api-organizations.md): Manage organizations (workspaces), their members, roles, departments, and API keys. See Team & workplace for the concepts. These are Dashboard API endpoints — t
- [Webhook management](https://telenow.ai/docs-md/api-webhooks.md): Register and manage the endpoints Telenow delivers events to. For the events themselves, payloads, and signature verification see Webhook events reference and t
- [Webhook events reference](https://telenow.ai/docs-md/webhook-events.md): Telenow delivers events to the endpoints you register as signed HTTP POSTs. This page covers the delivery format, signature verification, retries, and the full 

## SDKs

- [SDK overview](https://telenow.ai/docs-md/sdk-overview.md): Telenow ships official SDKs for the browser, React Native apps, and your backend. Install one package and the SDK handles everything below the UI: session init,
- [Web & React](https://telenow.ai/docs-md/sdk-web.md): Run agent voice calls in the browser with your own UI. @telenow/client is
- [React Native](https://telenow.ai/docs-md/sdk-mobile.md): Real-time AI voice agent calls inside your iOS & Android app with
- [Backend (Node & Python)](https://telenow.ai/docs-md/sdk-server.md): Drive Telenow from your own backend: place phone calls, mint browser/app

## Integration guides

- [Embed the widget](https://telenow.ai/docs-md/guide-embed-widget.md): Put a voice/chat agent on your website with a single script tag. The loader injects a floating button that opens the agent in an iframe pointing at Telenow's ho
- [Programmatic web calls](https://telenow.ai/docs-md/guide-web-call-api.md): This recipe runs an agent voice conversation in your own browser UI: your backend mints a session with an API key, hands the browser a short‑lived WebSocket URL
- [Build a custom chat experience](https://telenow.ai/docs-md/guide-chat-api.md): This recipe puts an agent's brain — its system prompt, knowledge bases (RAG) and tools — behind your own chat UI, over plain REST. You send text in, you get the
- [Programmatic phone calls](https://telenow.ai/docs-md/guide-phone-call.md): Place a real outbound PSTN phone call with any of your agents from your own backend. Telenow dials the number, the agent runs the full voice pipeline, and the c
- [Receive & verify webhooks](https://telenow.ai/docs-md/guide-webhooks.md): This guide shows how to build a secure webhook receiver — verifying signatures, de‑duplicating retries, and responding correctly. For the catalog of events and 
- [Zapier, Make, n8n & viaSocket](https://telenow.ai/docs-md/guide-automation-platforms.md): Automation platforms let you wire Telenow into workflows in two directions:

## Resources

- [FAQ & troubleshooting](https://telenow.ai/docs-md/faq.md): Quick answers to common questions. If something here doesn't resolve your issue, use the Feedback button at the bottom‑right of any dashboard page to report a b
- [Glossary](https://telenow.ai/docs-md/glossary.md): Key terms used throughout Telenow and this documentation.