# Dialgem

> Dialgem is a programmable voice AI platform. You configure an agent (prompt, voice, model) and Dialgem runs the real-time speech-to-text, language model and text-to-speech loop over a phone call or a web call.

## Account & team
- [Alerts](https://docs.dialgem.com/account/alerts): Be told by email, Slack or a signed webhook when call failures, latency, spend, credit or a campaign cross a limit you set.
- [API key scopes](https://docs.dialgem.com/account/api-key-scopes): Limit an API key to the parts of the API it needs, the addresses it may be used from, and a date it stops working.
- [Billing and pricing](https://docs.dialgem.com/account/billing): How calls are priced, how prepaid credit works, how to add funds, and how to read your usage.
- [Exports](https://docs.dialgem.com/account/exports): Download your calls as a CSV or JSON Lines file, prepared in the background and fetched through a short-lived signed link.
- [Account and team](https://docs.dialgem.com/account): Members and roles, API keys, sign-in, integrations, billing, alerts and exports for your organization.
- [Integrations](https://docs.dialgem.com/account/integrations): Save a Cal.com key or connect a Google account once, then let any agent's calendar functions use it without pasting a secret into each one.
- [Members and invitations](https://docs.dialgem.com/account/members): Invite people to your organization, choose their role, and change or remove them later. Who can do what, and what an invite link does.
- [Your profile and sign-in](https://docs.dialgem.com/account/profile): Change your name and password, reset a forgotten password, confirm your email, link Google or GitHub, switch organizations, and request account deletion.
- [Single sign-on](https://docs.dialgem.com/account/single-sign-on): Let your people sign in with your own identity provider over OpenID Connect or SAML, and require it for your email domains.
- [Two-step verification](https://docs.dialgem.com/account/two-factor): Ask for a second step after the password (an authenticator app, a passkey, or an emailed or texted code), and require it of everyone in your organization.

## Build agents
- [Analytics](https://docs.dialgem.com/agents/analytics): Totals, trends and breakdowns over your calls, how each number is counted, and the drop-off funnel for flow agents.
- [Text chat](https://docs.dialgem.com/agents/chat): Talk to an agent in text over the API. Start a chat, send messages, read the transcript and end it, with no phone call.
- [Flow agents](https://docs.dialgem.com/agents/flow-agents): Design a conversation as a graph of nodes when the call has to follow steps.
- [Organize, copy and move agents](https://docs.dialgem.com/agents/folders): Group agents into folders, duplicate an agent, and export one to a file to import into another organization.
- [Functions and tools](https://docs.dialgem.com/agents/functions): Let an agent call your API, a calendar, an MCP server, or control the call itself.
- [Agent Types](https://docs.dialgem.com/agents/how-agents-work): LLM-driven agents versus flow-driven agents, and how an agent handles a single turn.
- [Build agents](https://docs.dialgem.com/agents): Choose how your agent behaves, give it a voice, a model and tools, then test it before callers do.
- [Knowledge base](https://docs.dialgem.com/agents/knowledge-base): Give an agent documents to answer from, instead of putting every fact in the prompt.
- [Live sessions](https://docs.dialgem.com/agents/live-sessions): See the calls your organization has in progress right now, and change an agent's prompt or variables mid-call without touching the agent.
- [Choosing a model](https://docs.dialgem.com/agents/llms): Pick the language model for an agent, set a fallback, and save settings to reuse.
- [Mr. Gem, the built-in assistant](https://docs.dialgem.com/agents/mr-gem): Ask questions, look up your calls and agents, and build agents with Mr. Gem. What it can change, how proposals work, and how credits are counted.
- [Multi-prompt agents](https://docs.dialgem.com/agents/multi-prompt): Split a long prompt into named states, each with its own instructions, tools and exits, so the agent only sees what the current step needs.
- [Post-call analysis](https://docs.dialgem.com/agents/post-call-analysis): What Dialgem extracts after every call, how to add your own fields, choose the model, read the result and re-run it on older calls.
- [Prompt agents](https://docs.dialgem.com/agents/prompt-agents): Build an agent from a system prompt, a voice and a model, then tune how it listens and speaks.
- [Prompting guide](https://docs.dialgem.com/agents/prompting-guide): How to write a system prompt for a voice agent that holds up on a real phone call, with two full examples and a rewrite.
- [Testing agents](https://docs.dialgem.com/agents/simulations): Save conversations as test cases, run them against your agent in text, and check what it said and did, before a change reaches a caller.
- [Speech recognition and caller input](https://docs.dialgem.com/agents/speech-and-input): Choose how the agent hears callers: language, recognition engine, noise removal, medical vocabulary, keypad input and what personal data is redacted.
- [Agent templates](https://docs.dialgem.com/agents/templates): Browse the built-in prompt and flow templates, fetch one, and use it as the starting point for a new agent.
- [Agent versions](https://docs.dialgem.com/agents/versions): Publish frozen versions of an agent, pin calls and phone numbers to one, and roll back by pointing at an earlier version.
- [Voice cloning](https://docs.dialgem.com/agents/voice-cloning): Clone a voice from audio you upload, use it on an agent, and list or delete it. Covers the upload fields, limits and errors.
- [Voices](https://docs.dialgem.com/agents/voices): Browse the voice catalog, preview a voice, clone your own and set a fallback.

## Get started
- [Create an account](https://docs.dialgem.com/get-started/account): Sign up, create your organization, confirm your email and invite your team with the right roles.
- [Get your API keys](https://docs.dialgem.com/get-started/api-keys): Create an API key, limit what it can do, check it, and rotate it without downtime.
- [Core concepts](https://docs.dialgem.com/get-started/concepts): The handful of objects everything else in Dialgem is built from, and how they fit.
- [Go-live checklist](https://docs.dialgem.com/get-started/go-live): A checklist for taking a voice agent from testing to real customer traffic, with a link to the page that explains each check.
- [Get started](https://docs.dialgem.com/get-started): Create a Dialgem account, then learn how to build, test and launch voice agents.
- [Quickstart, web call](https://docs.dialgem.com/get-started/quickstart): Create an agent and talk to it from a web page. You need an account and an API key.

## Developer resources
- [API conventions](https://docs.dialgem.com/resources/api-conventions): Authentication, errors, pagination, timestamps and the other rules that every endpoint shares.
- [Changelog](https://docs.dialgem.com/resources/changelog): What changed in the Dialgem SDKs and docs, and where product updates are listed.
- [Developer resources](https://docs.dialgem.com/resources): How the Dialgem API behaves (errors, pagination, limits) and where to find the libraries.
- [Troubleshooting](https://docs.dialgem.com/resources/troubleshooting): Find the symptom, then the usual cause and what to do about it, for calls and the API.
- [Browser SDK](https://docs.dialgem.com/sdks/browser): @dialgem/client: microphone, playback and live events for a web call, with a React hook.
- [Command-line tool](https://docs.dialgem.com/sdks/cli): @dialgem/cli: manage agents, phone numbers and calls from your terminal, and test a prompt with a text chat instead of a phone call.
- [SDKs](https://docs.dialgem.com/sdks): Official Dialgem libraries for your server and web page, plus a command-line tool and an MCP server for AI assistants.
- [MCP server](https://docs.dialgem.com/sdks/mcp): @dialgem/mcp: let Claude, Cursor and other AI assistants manage your voice agents, calls and phone numbers, with spending tools off by default.
- [Python SDK](https://docs.dialgem.com/sdks/python): dialgem: sync and asyncio clients for your backend, with typed responses and webhook verification.
- [TypeScript SDK](https://docs.dialgem.com/sdks/typescript): @dialgem/sdk: a typed client for your backend, with webhook verification.

## Security
- [Audit log](https://docs.dialgem.com/security/audit-log): A tamper-resistant record of what your team and your API keys did in your organization, with filters and CSV export.
- [Data retention and erasure](https://docs.dialgem.com/security/data-retention): Set how long call content, contacts and finished campaign entries are kept, and erase everything held about one person.
- [Security](https://docs.dialgem.com/security): How Dialgem protects access to your organization, what it records, and how you control the data your agents handle.

## Telephony
- [Calls](https://docs.dialgem.com/telephony/calls): Place outbound calls, then list and read call records with their transcript, recording, cost, status and end reason.
- [Campaigns](https://docs.dialgem.com/telephony/campaigns): Have an agent call a list of contacts on a schedule, retry the ones who do not answer, and stop on its own when something goes wrong.
- [Contacts](https://docs.dialgem.com/telephony/contacts): Keep the people your agents call, import them from a CSV, group them in lists, and see how do-not-call applies.
- [Do-not-call list](https://docs.dialgem.com/telephony/do-not-call): Numbers your organization will not dial. Add or remove them, let agents add people who ask to stop, and where the list is enforced.
- [Inbound routing](https://docs.dialgem.com/telephony/inbound-routing): Decide, per call, which agent answers a phone number, or turn the call away, by answering a signed request from Dialgem.
- [Telephony](https://docs.dialgem.com/telephony): Phone numbers, inbound routing, your own SIP carrier, contacts and outbound campaigns.
- [Phone numbers](https://docs.dialgem.com/telephony/phone-numbers): Buy a number on Dialgem or connect one you already own, then choose which agent answers it.
- [Connect a SIP Trunk (BYOT)](https://docs.dialgem.com/telephony/sip-trunks): Route calls from your own carrier straight to your Dialgem voice agent — your number, your trunk, Dialgem's AI.
- [Voicemail and call transfer](https://docs.dialgem.com/telephony/voicemail-and-transfer): Decide what an agent does when it reaches a machine, and how to hand a call to a person.

## Web calls
- [Errors and troubleshooting](https://docs.dialgem.com/web-calls/errors): Every error a web call page can receive, what causes it and how to fix it, plus dropped calls and browser requirements.
- [Web calls](https://docs.dialgem.com/web-calls): Let a visitor talk to one of your agents from your own web page, without your API key ever reaching the browser.
- [Pass data to the agent](https://docs.dialgem.com/web-calls/pass-data): Fill the agent's prompt with the visitor's details, tag the call with your own ids, pick an agent version and read the result.
- [Build a voice button](https://docs.dialgem.com/web-calls/quickstart): Add a Talk to us button to your website, with a small server endpoint that creates calls, in plain JavaScript or React.
- [Tokens and allowed websites](https://docs.dialgem.com/web-calls/tokens-and-origins): How the one-use call token works, how to allow your websites, and the limits that apply to web calls.

## Webhooks
- [Webhook delivery and retries](https://docs.dialgem.com/webhooks/delivery): The retry schedule, what to build your receiver against, and how to inspect, replay and debug deliveries.
- [Set up a webhook endpoint](https://docs.dialgem.com/webhooks/endpoints): Add an endpoint, choose its events, keep the signing secret, send a test and write a receiver that answers quickly.
- [Event reference](https://docs.dialgem.com/webhooks/events): The body of every webhook event, the call record it carries, and how to handle ordering.
- [Webhooks](https://docs.dialgem.com/webhooks): How Dialgem notifies your servers about calls, which events exist, and where to find setup, verification and retry details.
- [Verify webhook signatures](https://docs.dialgem.com/webhooks/verify): Check that a request came from Dialgem and was not replayed, with the SDK or a few lines of your own, and rotate secrets safely.

## API reference
- [Agents](https://docs.dialgem.com/api-reference/agents): 22 endpoints
- [Calls](https://docs.dialgem.com/api-reference/calls): 8 endpoints
- [Web calls](https://docs.dialgem.com/api-reference/web-calls): 3 endpoints
- [Chats](https://docs.dialgem.com/api-reference/chats): 8 endpoints
- [Flows](https://docs.dialgem.com/api-reference/flows): 5 endpoints
- [LLMs](https://docs.dialgem.com/api-reference/llms): 5 endpoints
- [Phone numbers](https://docs.dialgem.com/api-reference/phone-numbers): 10 endpoints
- [Voices](https://docs.dialgem.com/api-reference/voices): 3 endpoints
- [Contacts](https://docs.dialgem.com/api-reference/contacts): 21 endpoints
- [Simulations](https://docs.dialgem.com/api-reference/simulations): 12 endpoints
- [Live sessions](https://docs.dialgem.com/api-reference/live-sessions): 4 endpoints
- [Templates and models](https://docs.dialgem.com/api-reference/templates): 5 endpoints
- [API key](https://docs.dialgem.com/api-reference/api-key): 1 endpoints