# telli Documentation

> telli is the AI voice platform for agents that sell, support, and operate across millions of calls. These docs cover the telli platform, building and deploying agents, CRM and calendar integrations, cookbooks, and the REST API.

## Docs

- [Add contacts & schedule calls](https://docs.telli.com/add-contacts-and-schedule-calls.md): Add contacts to telli from your CRM or other systems and schedule calls with them
- [Connect your calendar](https://docs.telli.com/calendar-integrations.md): Choose the right calendar integration for your telli agents and configure booking workflows for Calendly, Zeeg, Cal.com, HubSpot Meetings, or a custom calendar API.
- [Changelog](https://docs.telli.com/changelog.md): We're constantly shipping new features and improvements. Here's what's new in telli.
- [Contact lookup webhook](https://docs.telli.com/contact-lookup-webhook.md): Identify unknown callers by looking up their phone number in your system before the call starts
- [Auto-dialer & Calling Strategy](https://docs.telli.com/cookbooks/auto-dialer/overview.md): Reach out to contacts automatically. Pick a strategy, retry intensity, and dialer windows that fit your campaign.
- [Connect your calendar](https://docs.telli.com/cookbooks/calendar-integration/overview.md): Connect a calendar provider so your telli agent can check availability and book appointments during calls.
- [Call Outcomes](https://docs.telli.com/cookbooks/call-outcomes/overview.md): Automatically extract structured information from every call your telli agent handles.
- [Call Transfers](https://docs.telli.com/cookbooks/call-transfers/overview.md): Hand off live calls to a human team member. Cold transfers, warm transfers, and context-based routing.
- [Charlie](https://docs.telli.com/cookbooks/charlie/overview.md): Edit your agent's prompt with help from Charlie, telli's built-in AI assistant in the Agent Builder.
- [Collect Data](https://docs.telli.com/cookbooks/collect-data/overview.md): Let your agent gather specific information from callers with built-in validation and confirmation.
- [Context & Customer Data & Tool Calls](https://docs.telli.com/cookbooks/how-to-prompt/prompt-structure/context-customer-data-tool-calls.md)
- [Global Rules & Behavior](https://docs.telli.com/cookbooks/how-to-prompt/prompt-structure/global-rules-behavior.md)
- [Identity & Core Task](https://docs.telli.com/cookbooks/how-to-prompt/prompt-structure/identity-core-task.md)
- [Main Conversation Script](https://docs.telli.com/cookbooks/how-to-prompt/prompt-structure/main-conversation-script.md)
- [Pronunciation & Formatting](https://docs.telli.com/cookbooks/how-to-prompt/prompt-structure/pronunciation-formatting.md)
- [Special Situations / FAQs](https://docs.telli.com/cookbooks/how-to-prompt/prompt-structure/special-situations-faqs.md)
- [What cannot be prompted](https://docs.telli.com/cookbooks/how-to-prompt/what-cannot-be-influenced.md)
- [Knowledge Base](https://docs.telli.com/cookbooks/knowledgebase/overview.md): Give your telli agent access to your own documents so it can answer questions using your specific information during calls.
- [Cookbooks Overview](https://docs.telli.com/cookbooks/overview.md): Practical guides and examples for building with telli.
- [Tool Calls](https://docs.telli.com/cookbooks/tool-calls/overview.md): Let your agent perform specific actions during a call using tool calls.
- [Variables](https://docs.telli.com/cookbooks/variables/overview.md): Learn how to use variables to personalize your agent's prompts dynamically.
- [Professional Voice Cloning](https://docs.telli.com/cookbooks/voice-cloning/overview.md): How to create a high-quality professional voice clone for use with your telli agent.
- [Integrate with your CRM](https://docs.telli.com/crm-integration.md): Integrate telli with your CRM to sync contacts and call data. This enables you to automate contact management, schedule calls, and sync call outcomes with your CRM or other systems.
- [Custom HTTP Tools](https://docs.telli.com/custom-tools.md): Enable your AI agents to call external APIs during conversations
- [Agent Builder](https://docs.telli.com/deep-dives/agent-builder.md): Build, refine, and publish your agents from one cockpit
- [Auto-Dialer](https://docs.telli.com/deep-dives/auto-dialer.md): Automated contact outreach system
- [Call Analysis](https://docs.telli.com/deep-dives/call-analysis.md): Understand conversation insights and outcomes
- [Call Transfer](https://docs.telli.com/deep-dives/call-transfer.md): Transfer calls to human agents with cold or warm transfer options
- [Data Collection](https://docs.telli.com/deep-dives/collected-data.md): Actively collect and validate structured data from callers during a call
- [Feedback System](https://docs.telli.com/deep-dives/feedback-system.md): Improve your agent through iterative feedback
- [Get Started](https://docs.telli.com/en/get-started.md): Follow this checklist to achieve results with your first telli agent
- [Agent Editor Charlie](https://docs.telli.com/en/get-started/agent-editor-charlie.md): Use Charlie to review and improve your agent
- [Create an Agent](https://docs.telli.com/en/get-started/create-a-new-agent.md): Create your first AI voice agent
- [Agent Creation Overview](https://docs.telli.com/en/get-started/introduction.md): Set up your first agent from scratch
- [Knowledge Bases](https://docs.telli.com/en/get-started/knowledge-bases.md): Give your agent access to your own documents during calls
- [Publish your Agent](https://docs.telli.com/en/get-started/publish-your-agent.md): Make your draft changes go live for new calls
- [Refine your Agent](https://docs.telli.com/en/get-started/refine-your-agent.md): Improve your agent based on real call data
- [The telli Agent Interface](https://docs.telli.com/en/get-started/review-and-personalize.md): Customize how your agent sounds, how it handles calls, and what it captures from every conversation.
- [Test Your Agent](https://docs.telli.com/en/get-started/test-your-agent.md): Test your agent with a live call
- [Tool Calls](https://docs.telli.com/en/get-started/tool-calls.md): Let your agent take action during a call
- [Voice Cloning](https://docs.telli.com/en/get-started/voice-cloning.md): Give your agent a custom voice
- [Workflows](https://docs.telli.com/en/get-started/workflows.md): Automate actions that fire after every call
- [Working with Variables](https://docs.telli.com/en/get-started/working-with-variables.md): Personalize every call with contact info, dates, and details that change per contact
- [The EU's disclosure requirements](https://docs.telli.com/eu-ai-act-transparency.md)
- [Get notified about calls](https://docs.telli.com/get-notified-about-calls.md): Get notified about calls and their analysis using webhooks to automatically update your CRM
- [Get started with telli](https://docs.telli.com/get-started-with-telli.md): This tutorial demonstrates how to use any integration platform to automate adding contacts, scheduling calls, and updating CRM contact status based on call outcomes.
- [Overview](https://docs.telli.com/integrations-overview.md): Learn how to integrate telli with your existing tools and workflows. This enables you to automate contact management, schedule calls, and sync call outcomes with your CRM or other systems.
- [bookingtime](https://docs.telli.com/integrations/bookingtime.md): Connect bookingtime to telli so agents can check availability and book appointments into your bookingtime calendar during calls.
- [Cal.com](https://docs.telli.com/integrations/cal-com.md): Connect Cal.com to telli so agents can book meetings against your Cal.com availability during calls.
- [Calendly](https://docs.telli.com/integrations/calendly.md): Connect Calendly to telli so agents can check availability, book meetings, and fill Calendly booking questions during calls.
- [Custom calendar](https://docs.telli.com/integrations/custom-calendar.md): Connect your own calendar or scheduling API to telli so agents can fetch availability and book appointments through custom endpoints.
- [HubSpot](https://docs.telli.com/integrations/hubspot.md): Connect HubSpot to telli to sync Contacts into your workspace and map HubSpot properties to telli contact properties.
- [HubSpot Meetings](https://docs.telli.com/integrations/hubspot-meetings.md): Connect HubSpot Meetings to telli so agents can book appointments through HubSpot meeting links during calls.
- [Make](https://docs.telli.com/integrations/make.md): This tutorial demonstrates how to use the verified telli integration in [Make.com](https://www.make.com) to automate adding contacts, scheduling calls, and getting call data.
- [MCP](https://docs.telli.com/integrations/mcp.md): Connect Claude, ChatGPT, and other AI tools to Charlie through the telli MCP server.
- [Microsoft Teams](https://docs.telli.com/integrations/microsoft-teams.md): Connect Charlie to your Microsoft 365 tenant so your team can message it in Microsoft Teams.
- [n8n](https://docs.telli.com/integrations/n8n.md): This tutorial demonstrates how to use the verified telli node in [n8n](https://n8n.io) to automate adding contacts, scheduling calls, and updating CRM contact status based on call outcomes.
- [Salesforce](https://docs.telli.com/integrations/salesforce.md): Connect Salesforce to telli to sync Contacts and Leads into your workspace and map CRM fields to telli contact properties.
- [Slack](https://docs.telli.com/integrations/slack.md): Install Charlie in your Slack workspace so your team can ask about agents and calls by mentioning it in a channel.
- [WhatsApp Business](https://docs.telli.com/integrations/whatsapp.md): Send WhatsApp template messages from agents and workflows in telli
- [Zapier](https://docs.telli.com/integrations/zapier.md): This tutorial demonstrates how to use [Zapier](https://www.zapier.com) to automate adding contacts, scheduling calls, and updating CRM contact status based on call outcomes.
- [Zeeg](https://docs.telli.com/integrations/zeeg.md): Connect Zeeg to telli so agents can check availability, book meetings, and fill Zeeg scheduling page questions during calls.
- [Introduction](https://docs.telli.com/introduction.md): Overview of the telli platform and what you can build with it
- [Agents](https://docs.telli.com/platform/agents.md): Manage and configure your AI Voice agents
- [Conversation History](https://docs.telli.com/platform/call-history.md): Comprehensive view of all call interactions and analysis
- [Contact Properties](https://docs.telli.com/platform/contact-properties.md): Define a structured schema for your contacts with typed custom properties that you can use across the telli platform
- [Contacts](https://docs.telli.com/platform/contacts.md): Full visibility into your contact outreach
- [Knowledge Base](https://docs.telli.com/platform/knowledge-base.md): Enrich your AI agent with the expertise and context it needs by including all of your knowledge sources
- [Live Monitoring](https://docs.telli.com/platform/live-monitoring.md): Real-time call overview of your contacts
- [Performance Dashboard](https://docs.telli.com/platform/performance-dashboard.md): Real-time performance metrics for your telli Agent
- [Phone Numbers](https://docs.telli.com/platform/phone-numbers.md): Buy and manage phone numbers directly in telli
- [Settings](https://docs.telli.com/platform/settings.md): Manage your telli account settings and preferences
- [SMS](https://docs.telli.com/platform/sms.md): Send SMS messages from agents and workflows in telli
- [Workflows](https://docs.telli.com/platform/workflows.md): Automate actions across calls, contacts, and integrations with visual workflows in telli
- [Prompt Best Practices](https://docs.telli.com/prompt-best-practices.md): Learn how to write effective prompts for your voice agents
- [Receive call data](https://docs.telli.com/receive-call-data.md): Receive call data and their analysis using webhooks to automatically update your CRM
- [SIP numbers](https://docs.telli.com/sip-numbers.md): Connect your existing SIP providers to telli
- [Add Contact](https://docs.telli.com/v1/endpoint/add-contact.md): Adds a new contact to the system
- [Add Contacts (Batch)](https://docs.telli.com/v1/endpoint/add-contacts-batch.md): Adds multiple contacts in a single request. Limited to 1000 contacts per request.
- [Delete Contact](https://docs.telli.com/v1/endpoint/delete-contact.md): Permanently deletes a contact and any PII data associated with it from the system. This action cannot be undone. If you want to stop calling a contact, use the `v1/remove-from-auto-dialer` endpoint instead.
- [Delete Phone Number](https://docs.telli.com/v1/endpoint/delete-phone-number.md): Schedules a phone number for deletion. The number remains active for callbacks for 30 days and can be restored during this period.
- [Get Call](https://docs.telli.com/v1/endpoint/get-call.md): Retrieves detailed information about a specific call by its ID, including call metadata, transcript, analysis, and the associated contact.
- [Get Contact](https://docs.telli.com/v1/endpoint/get-contact.md): Retrieves detailed contact information including current call status and history
- [Get Contact by External ID](https://docs.telli.com/v1/endpoint/get-contact-by-external-id.md): Retrieves detailed contact information including current call status and history using external contact id as an identifier
- [Get Contacts (Batch)](https://docs.telli.com/v1/endpoint/get-contacts-batch.md): Gets multiple contacts in a single request. Limited to 1000 contacts per request.
- [Import Phone Number](https://docs.telli.com/v1/endpoint/import-phone-number.md): Imports a phone number from your own SIP trunk provider. This allows you to use existing phone numbers with telli by configuring custom SIP termination settings.
- [Initiate Call](https://docs.telli.com/v1/endpoint/initiate-call.md): [Not recommended] Initiates an immediate call to a contact. Will call even outside business hours, which is why we recommend using schedule-call instead. If contact cannot be reached and Auto Dialer is enabled, telli will continue trying according to Auto Dialer settings.
- [List Calls](https://docs.telli.com/v1/endpoint/list-calls.md): Returns a paginated list of calls for the authenticated account, ordered by `triggered_at` descending. Optionally filter by `contact_id` to return only calls for a single contact, or by `agent_id` to return only calls for a single agent. `contact_id` and `agent_id` cannot be used together. Each item…
- [List Phone Numbers](https://docs.telli.com/v1/endpoint/list-phone-numbers.md): Retrieves all active phone numbers associated with the account
- [Remove from Auto Dialer](https://docs.telli.com/v1/endpoint/remove-from-dialer.md): Removes a contact from the auto dialer queue
- [Remove from Auto Dialer (Batch)](https://docs.telli.com/v1/endpoint/remove-from-dialer-batch.md): Removes multiple contacts from the auto dialer queue. Limited to 50 contacts per request.
- [Replace Phone Number](https://docs.telli.com/v1/endpoint/replace-phone-number.md): Replaces an existing phone number with a new one with the same configuration. The old number is scheduled for deletion but remains active for callbacks for 30 days.
- [Schedule Call](https://docs.telli.com/v1/endpoint/schedule-call.md): Schedules a call at the earliest opportunity within the dialer window. May occur immediately or on the next business day depending on settings. Requires the auto dialer to be enabled.
- [Schedule Calls (Batch)](https://docs.telli.com/v1/endpoint/schedule-calls-batch.md): Schedules multiple calls in a single request. Limited to 50 contacts per request.
- [Update Contact](https://docs.telli.com/v1/endpoint/update-contact.md): Updates an existing contact. Only provided fields will be updated, others remain unchanged.
- [Update Contacts (Batch)](https://docs.telli.com/v1/endpoint/update-contacts-batch.md): Updates multiple contacts in a single request. Limited to 1000 contacts per request. Only provided fields will be updated, others remain unchanged.
- [Migration Guide](https://docs.telli.com/v2-migration-guide.md): Migrate from the deprecated contact endpoints to the current API for contacts and contact properties
- [Create Contact](https://docs.telli.com/v2/endpoint/create-contact.md): Creates a new contact. Properties are validated against the account's property schema.
- [Create Contact Property](https://docs.telli.com/v2/endpoint/create-contact-property.md): Creates a new contact property for the authenticated account.
- [Delete Contact](https://docs.telli.com/v2/endpoint/delete-contact.md): Deletes a contact and anonymizes all personal data.
- [Get Agent](https://docs.telli.com/v2/endpoint/get-agent.md): Returns a single agent by ID.
- [Get Contact](https://docs.telli.com/v2/endpoint/get-contact.md): Returns a single contact by ID.
- [Get Contact by External ID](https://docs.telli.com/v2/endpoint/get-contact-by-external-id.md): Returns a single contact by its external ID.
- [Get Contact Property](https://docs.telli.com/v2/endpoint/get-contact-property.md): Returns a single contact property by key.
- [List Agents](https://docs.telli.com/v2/endpoint/list-agents.md): Returns a paginated list of agents for the authenticated account.
- [List Contact Properties](https://docs.telli.com/v2/endpoint/list-contact-properties.md): Returns all contact properties for the authenticated account.
- [List Contacts](https://docs.telli.com/v2/endpoint/list-contacts.md): Returns a paginated list of contacts for the authenticated account.
- [Update Contact](https://docs.telli.com/v2/endpoint/update-contact.md): Updates an existing contact. Properties are merged with existing ones after validation.
- [Update Contact Property](https://docs.telli.com/v2/endpoint/update-contact-property.md): Updates an existing contact property by key.
- [Replace Contact](https://docs.telli.com/v2/endpoint/update-contact-put.md): Fully replaces an existing contact. All omitted optional fields are reset to their default values (null). Properties are replaced entirely rather than merged.
- [Webhooks](https://docs.telli.com/webhook.md): Reference for the webhook events telli sends when calls and contact states change.

## OpenAPI Specs

- [openapi](https://docs.telli.com/openapi.json)
- [openapi-v2](https://docs.telli.com/openapi-v2.json)
- [package](https://docs.telli.com/package.json)
- [package-lock](https://docs.telli.com/package-lock.json)