# Thoughtly Docs

## Docs

- [CLAUDE](https://docs.thoughtly.com/CLAUDE.md)
- [Actions](https://docs.thoughtly.com/agents/actions.md): Trigger integrations mid-call so your agent can look up data, write records, and automate workflows
- [Deployment](https://docs.thoughtly.com/agents/deployment.md): Deploy your Voice Agents and start making calls
- [Migration Guide](https://docs.thoughtly.com/agents/migration-guide.md): Rebuild legacy v1 free-form agents using the v1.8 Agent Builder
- [Nodes and their Types](https://docs.thoughtly.com/agents/nodes.md): Understand the core building blocks of every Thoughtly agent flow
- [Outcomes](https://docs.thoughtly.com/agents/outcomes.md): Decide where the conversation goes after every caller response
- [Agent Builder Overview](https://docs.thoughtly.com/agents/overview.md): Design, test, and launch conversational agents with the Thoughtly Agent Builder
- [Settings](https://docs.thoughtly.com/agents/settings.md): Tune voice, behavior, and post-call workflows for each agent
- [Testing](https://docs.thoughtly.com/agents/testing.md): Validate your conversation logic and voice experience before going live
- [Tips & Tricks](https://docs.thoughtly.com/agents/tips-and-tricks.md): Best practices for building effective Voice Agents in Thoughtly
- [Agent Troubleshooting](https://docs.thoughtly.com/agents/troubleshooting.md): Common issues and solutions for voice agents
- [Variables](https://docs.thoughtly.com/agents/variables.md): Capture caller data and reuse it for branching, actions, and follow-up
- [Bring Your Own Key (BYOK)](https://docs.thoughtly.com/agents/voice-byok.md): Connect your own voice provider API keys to use your personal voices, usage limits, and pricing
- [Voice Cloning](https://docs.thoughtly.com/agents/voice-cloning.md): Create custom voices by recording or uploading audio directly from the Agent Builder
- [Voice Optimization](https://docs.thoughtly.com/agents/voice-optimization.md): Accents, languages, speed controls, and pronunciation tips
- [Agent Voices](https://docs.thoughtly.com/agents/voices.md): Choose, preview, and assign voices directly inside the Agent Builder
- [Get agents](https://docs.thoughtly.com/api-reference/agent/get-agents.md): This endpoint retrieves a list of **Agents** (formerly **Interviews**) available in your system. You can filter the list by status, search term, and sorting options.
- [Search calls](https://docs.thoughtly.com/api-reference/agent/search-calls.md): Find calls made by an **Agent** (formerly **Interview**). You can filter and search calls based on various criteria.
- [Call a contact](https://docs.thoughtly.com/api-reference/contact/call-a-contact.md): This endpoint allows you to initiate a call with a **Contact** using a specific **Agent**. The **Agent** will handle the conversation during the call.
- [Create contact](https://docs.thoughtly.com/api-reference/contact/create-contact.md): This endpoint allows you to create a new **Contact**. A contact represents a person with whom you can interact via a phone call or other communication.
- [Delete contact](https://docs.thoughtly.com/api-reference/contact/delete-contact.md): This endpoint allows you to delete a **Contact** by ID. Deleting a contact will remove it from the system permanently.
- [Get contact](https://docs.thoughtly.com/api-reference/contact/get-contact.md): Retrieve a single **Contact** by their unique ID. Returns the full contact record including name, phone number, email, tags, and any custom attributes associated with the contact.
- [Get contacts](https://docs.thoughtly.com/api-reference/contact/get-contacts.md): This endpoint retrieves a list of **Contacts**. You can filter contacts by various criteria, such as tags, phone numbers, and more. Use the query parameters to narrow down your results.
- [Update contact](https://docs.thoughtly.com/api-reference/contact/update-contact.md)
- [Get user details](https://docs.thoughtly.com/api-reference/user/get-user-details.md): Retrieve the details of the currently authenticated user. This includes information such as user ID, name, and email.
- [Get currently active webhooks](https://docs.thoughtly.com/api-reference/webhooks/get-currently-active-webhooks.md): Retrieve a list of all active webhooks for the authenticated user. This allows you to see which webhook events you are currently subscribed to.
- [Subscribe to webhook](https://docs.thoughtly.com/api-reference/webhooks/subscribe-to-webhook.md): This endpoint allows you to subscribe to a specific webhook event (e.g., new call responses or phone transfers). You must provide the event type and a callback URL.
- [Trigger automation with webhook](https://docs.thoughtly.com/api-reference/webhooks/trigger-automation-with-webhook.md): This endpoint triggers an [Automation](/automations/getting-started) with a [Webhook](/automations/triggers#webhook) as the trigger.
- [Unsubscribe from webhook](https://docs.thoughtly.com/api-reference/webhooks/unsubscribe-from-webhook.md): This endpoint allows you to unsubscribe from a previously subscribed webhook event. Provide the event type and the callback URL to unsubscribe.
- [Actions (Steps)](https://docs.thoughtly.com/automations/actions.md): Build branching logic, calls, scheduling, and integrations inside your automations
- [Attributes vs Metadata](https://docs.thoughtly.com/automations/attributes-vs-metadata.md): Decide what data lives per call and what persists on contacts
- [Getting Started with Automations](https://docs.thoughtly.com/automations/getting-started.md): Setup workflows to trigger your Voice Agents or perform actions after a call
- [Triggers](https://docs.thoughtly.com/automations/triggers.md): Choose when and why your automations run with Thoughtly and integration triggers
- [Automation Troubleshooting](https://docs.thoughtly.com/automations/troubleshooting.md): Common issues and solutions for automations
- [Developer Documentation](https://docs.thoughtly.com/developers.md): Integrate Thoughtly with your applications using our powerful API
- [Agent Binding](https://docs.thoughtly.com/genius/agent-binding.md): Connect your Genius knowledge base to Voice Agents
- [Genius Best Practices](https://docs.thoughtly.com/genius/best-practices.md): Tips and strategies for building a powerful knowledge base
- [Genius Knowledge Base](https://docs.thoughtly.com/genius/getting-started.md): Augment your voice agents with specialized knowledge through AI-powered RAG
- [Data Sources](https://docs.thoughtly.com/genius/sources.md): Add various types of data to your Genius knowledge base
- [Genius Troubleshooting](https://docs.thoughtly.com/genius/troubleshooting.md): Common issues and solutions for Genius knowledge base
- [Introduction](https://docs.thoughtly.com/getting-started/introduction.md): Welcome to Thoughtly - Build and deploy AI Voice Agents in minutes
- [Quick Start Guide](https://docs.thoughtly.com/getting-started/quick-start.md): Build your first voice agent in 15 minutes
- [Use Cases & Examples](https://docs.thoughtly.com/getting-started/use-cases.md): Explore detailed implementation examples for common voice agent scenarios
- [Thoughtly](https://docs.thoughtly.com/integrations/ai/thoughtly.md)
- [Make](https://docs.thoughtly.com/integrations/automations/make.md)
- [Zapier](https://docs.thoughtly.com/integrations/automations/zapier.md)
- [Gmail](https://docs.thoughtly.com/integrations/communication/gmail.md)
- [Slack](https://docs.thoughtly.com/integrations/communication/slack.md)
- [Attio](https://docs.thoughtly.com/integrations/crm/attio.md)
- [Fence Flow](https://docs.thoughtly.com/integrations/crm/fence-flow.md)
- [GoHighLevel](https://docs.thoughtly.com/integrations/crm/highlevel.md)
- [HubSpot](https://docs.thoughtly.com/integrations/crm/hubspot.md)
- [Keap](https://docs.thoughtly.com/integrations/crm/keap.md)
- [Pipedrive](https://docs.thoughtly.com/integrations/crm/pipedrive.md)
- [Salesforce](https://docs.thoughtly.com/integrations/crm/salesforce.md)
- [Salesforce Sandbox](https://docs.thoughtly.com/integrations/crm/salesforce-sandbox.md)
- [Zoho CRM](https://docs.thoughtly.com/integrations/crm/zoho.md)
- [Shopify](https://docs.thoughtly.com/integrations/e-commerce/shopify.md)
- [Getting Started with Integrations](https://docs.thoughtly.com/integrations/getting-started.md): Power your Voice Agents with integrations to other software systems
- [Airtable](https://docs.thoughtly.com/integrations/productivity/airtable.md)
- [Google Sheets](https://docs.thoughtly.com/integrations/productivity/google-sheets.md)
- [Smartsheet](https://docs.thoughtly.com/integrations/productivity/smartsheet.md)
- [Trello](https://docs.thoughtly.com/integrations/productivity/trello.md)
- [Typeform](https://docs.thoughtly.com/integrations/productivity/typeform.md)
- [Zoom](https://docs.thoughtly.com/integrations/productivity/zoom.md)
- [Acuity](https://docs.thoughtly.com/integrations/scheduling/acuity.md)
- [Acuity Enterprise](https://docs.thoughtly.com/integrations/scheduling/acuity-enterprise.md)
- [Cal.com](https://docs.thoughtly.com/integrations/scheduling/cal-com.md)
- [Calendly](https://docs.thoughtly.com/integrations/scheduling/calendly.md)
- [Mindbody](https://docs.thoughtly.com/integrations/scheduling/mindbody.md)
- [Zoho Bookings](https://docs.thoughtly.com/integrations/scheduling/zoho-bookings.md)
- [Zendesk](https://docs.thoughtly.com/integrations/ticketing/zendesk.md)
- [Integration Troubleshooting](https://docs.thoughtly.com/integrations/troubleshooting.md): Common issues and solutions for integrations
- [Webhooks Configuration](https://docs.thoughtly.com/integrations/webhooks.md): Set up custom webhooks to integrate Thoughtly with any external system
- [Phone Number Billing & Credits](https://docs.thoughtly.com/phone-number/billing-credits.md): Understand the costs associated with phone numbers on Thoughtly
- [Bring Your Own Carrier (BYOC)](https://docs.thoughtly.com/phone-number/byoc.md): Purchase phone numbers through Thoughtly or import numbers from your existing carrier
- [Configuration and Assignment](https://docs.thoughtly.com/phone-number/configuration.md): Configure phone number assignments to agents and optimize regional settings
- [Phone Number Management](https://docs.thoughtly.com/phone-number/getting-started.md): Acquire, manage, and assign phone numbers to your voice agents
- [Phone Number Troubleshooting](https://docs.thoughtly.com/phone-number/troubleshooting.md): Common issues and solutions for phone numbers
- [Audiences](https://docs.thoughtly.com/platform/audiences.md): Manage your contacts, segments, and CRM data
- [Billing](https://docs.thoughtly.com/platform/billing.md): Learn how billing works on Thoughtly
- [History](https://docs.thoughtly.com/platform/history.md): View and filter all interactions across your agents
- [Platform Overview](https://docs.thoughtly.com/platform/overview.md): Understand how the Thoughtly platform is organized
- [Audiences Settings](https://docs.thoughtly.com/platform/settings/audiences.md): Configure audience controls for your workspace
- [Audit Log](https://docs.thoughtly.com/platform/settings/audit-log.md): Track all changes made in your workspace
- [Developer](https://docs.thoughtly.com/platform/settings/developer.md): Manage API tokens, webhooks, and experimental features
- [General Settings](https://docs.thoughtly.com/platform/settings/general.md): Manage your workspace name, icon, members, and other general settings
- [Phone Numbers Settings](https://docs.thoughtly.com/platform/settings/phone-numbers.md): Manage, buy, and configure phone numbers for your workspace
- [Subscription](https://docs.thoughtly.com/platform/settings/subscription.md): Manage your plan, billing cycle, and credits
- [Usage](https://docs.thoughtly.com/platform/settings/usage.md): Monitor credit consumption and usage across your workspace
- [Voices Settings](https://docs.thoughtly.com/platform/settings/voices.md): Manage and clone voices for your workspace
- [Workspaces](https://docs.thoughtly.com/platform/teams/overview.md): Manage workspace members and collaborate on Voice Agents
- [User Menu](https://docs.thoughtly.com/platform/user-menu.md): Access your profile, credits, and quick links
- [Workspace Switcher](https://docs.thoughtly.com/platform/workspace-switcher.md): Switch between workspaces and create new ones
- [Thoughtly Promptbooks | Automated calling via Salesforce](https://docs.thoughtly.com/promptbooks/automated-calling-via-salesforce.md): Automatically call leads from Salesforce and log call outcomes back to the CRM.
- [Thoughtly Promptbooks | Resources to help you build powerful Voice Agents](https://docs.thoughtly.com/promptbooks/browse.md): Resources to help you build powerful Voice Agents
- [Thoughtly Promptbooks | Building an Agent with Conditional Navigation](https://docs.thoughtly.com/promptbooks/building-an-agent-with-conditional-navigation.md): Learn how to use Thoughtly's new conditional navigation feature for dynamic conversations.
- [Thoughtly Promptbooks | Building your first Voice Agent](https://docs.thoughtly.com/promptbooks/building-your-first-voice-agent.md): Learn how to build your first Voice Agent in just a few steps.
- [Thoughtly Promptbooks | Bulk Upload and Bulk Calls](https://docs.thoughtly.com/promptbooks/bulk-upload-and-bulk-calls.md): Learn how to upload a CSV into Thoughtly and bulk call on Thoughtly
- [Thoughtly Promptbooks | Connect to different inbound agents based on hours](https://docs.thoughtly.com/promptbooks/connect-to-different-inbound-agents-based-on-hours.md): Learn how to find what time it is and direct to different agents accordingly
- [Thoughtly Promptbooks | Connect to different outbound agents based on hours](https://docs.thoughtly.com/promptbooks/connect-to-different-outbound-agents-based-on-hours.md): Learn how to find what time it is and direct to different outbound agents accordingly
- [Thoughtly Promptbooks | Creating a basic transfer triage agent](https://docs.thoughtly.com/promptbooks/creating-a-basic-transfer-triage-agent.md): Learn how to make an agent whos sole responsibility is to transfer to the correct person
- [Thoughtly Promptbooks | Creating multilingual interactions](https://docs.thoughtly.com/promptbooks/creating-multilingual-interactions.md): Learn how to make your agent able to speak with someone from any language
- [Thoughtly Promptbooks | How to deal with "call me later" requests](https://docs.thoughtly.com/promptbooks/how-to-deal-with-call-me-later-requests.md): Learn how to have your agent call a contact back based on the time they requested
- [Thoughtly Promptbooks | Identifying the callers state based on phone number](https://docs.thoughtly.com/promptbooks/identifying-the-callers-state-based-on-phone-number.md): Learn how to teach your inbound agent the state of the caller thats calling into your phone number
- [Thoughtly Promptbooks | Instant voice cloning](https://docs.thoughtly.com/promptbooks/instant-voice-cloning.md): In just a few steps, learn how to clone your voice to power your Voice Agents on phone calls– all powered by Cartesia's sonic model.
- [Thoughtly Promptbooks | Inviting new team members](https://docs.thoughtly.com/promptbooks/inviting-new-team-members.md): Learn how to invite people to your account
- [Thoughtly Promptbooks | Joining the Thoughtly affiliate program](https://docs.thoughtly.com/promptbooks/joining-the-thoughtly-affiliate-program.md): Learn about the affiliate portal
- [Thoughtly Promptbooks | Looking up your prospects website mid-call](https://docs.thoughtly.com/promptbooks/looking-up-your-prospects-website-mid-call.md): Learn how to search for your callers website and pitch them in a personalized way
- [Thoughtly Promptbooks | Purchasing a Phone Number](https://docs.thoughtly.com/promptbooks/purchasing-a-phone-number.md): Learn how to purchase a U.S. and Non-U.S. phone numbers
- [Thoughtly Promptbooks | Scoring calls inside of Thoughtly automations](https://docs.thoughtly.com/promptbooks/scoring-calls-inside-of-thoughtly-automations.md): Learn how to create a basic automation that allows you to score your calls based on what matters to you
- [Thoughtly Promptbooks | Sending data back to GoHighLevel](https://docs.thoughtly.com/promptbooks/sending-data-back-to-gohighlevel.md): Learn how to collect data from a call and send it back to GoHighLevel
- [Thoughtly Promptbooks | Sending data back to HubSpot](https://docs.thoughtly.com/promptbooks/sending-data-back-to-hubspot.md): Learn how to collect data from a call and send it back to HubSpot
- [Thoughtly Promptbooks | Sending mid-call text messages](https://docs.thoughtly.com/promptbooks/sending-mid-call-text-messages.md): Learn how to send the caller a text message mid-call
- [Thoughtly Promptbooks | Setting up Advanced Settings](https://docs.thoughtly.com/promptbooks/setting-up-advanced-settings.md): A short display for Advanced Settings inside the Thoughtly builder
- [Thoughtly Promptbooks | Triggering calls from GoHighLevel](https://docs.thoughtly.com/promptbooks/triggering-calls-from-gohighlevel.md): Learn how to call contacts based on criteria inside of GoHighLevel
- [Thoughtly Promptbooks | Triggering calls from HubSpot](https://docs.thoughtly.com/promptbooks/triggering-calls-from-hubspot.md): Learn how to call contacts based on criteria inside of GoHighLevel
- [Thoughtly Promptbooks | Two ways of tagging conversations](https://docs.thoughtly.com/promptbooks/two-ways-of-tagging-conversations.md): Learn the two best ways to tag your conversations with the appropriate tags
- [Thoughtly Promptbooks | Updating the genius automatically on each call](https://docs.thoughtly.com/promptbooks/updating-the-genius-automatically-on-each-call.md): Learn how to teach your agent new information on each call
- [Scheduling Guide](https://docs.thoughtly.com/resources/agent-scheduling.md): Production patterns for mid-call scheduling with Actions and Automations
- [FAQ](https://docs.thoughtly.com/resources/faq.md): Frequently asked questions about Thoughtly
- [AI Voice](https://docs.thoughtly.com/resources/glossary/ai-voice.md): Artificially generated speech that sounds natural and human-like
- [Carrier](https://docs.thoughtly.com/resources/glossary/carrier.md): A telecommunications company that provides phone services
- [CRM](https://docs.thoughtly.com/resources/glossary/crm.md): Customer Relationship Management software for managing customer interactions
- [Dead End](https://docs.thoughtly.com/resources/glossary/dead-end.md): When a conversation flow reaches a node with no valid outcomes or next steps
- [Decision Tree](https://docs.thoughtly.com/resources/glossary/decision-tree.md): A flowchart-like structure representing a series of decisions and their consequences
- [Hallucination](https://docs.thoughtly.com/resources/glossary/hallucination.md): When a language model generates plausible but incorrect information
- [Happy Path](https://docs.thoughtly.com/resources/glossary/happy-path.md): The ideal sequence of events that leads to a successful outcome
- [Large Language Model](https://docs.thoughtly.com/resources/glossary/large-language-model.md): A type of machine learning model trained on massive text data
- [OAuth](https://docs.thoughtly.com/resources/glossary/oauth.md): An authentication standard for secure access to third-party services
- [Glossary](https://docs.thoughtly.com/resources/glossary/overview.md): Definitions of key terms used in the Thoughtly documentation
- [PII](https://docs.thoughtly.com/resources/glossary/pii.md): Personally Identifiable Information that could identify a specific individual
- [RAG (Retrieval-Augmented Generation)](https://docs.thoughtly.com/resources/glossary/rag.md): An AI framework combining information retrieval with generative language models
- [Screen Pop](https://docs.thoughtly.com/resources/glossary/screen-pop.md): Automatic display of relevant information when a call is received
- [STT](https://docs.thoughtly.com/resources/glossary/stt.md): Speech-to-Text technology that converts spoken words into written text
- [Telnyx](https://docs.thoughtly.com/resources/glossary/telnyx.md): A telecommunications provider offering voice and messaging services
- [Transcript](https://docs.thoughtly.com/resources/glossary/transcript.md): A text record of a voice conversation
- [TTS](https://docs.thoughtly.com/resources/glossary/tts.md): Text-to-Speech technology that converts written text into spoken words
- [Twilio](https://docs.thoughtly.com/resources/glossary/twilio.md): A cloud communications platform providing voice and messaging APIs
- [Variable](https://docs.thoughtly.com/resources/glossary/variable.md): A named value that stores information during a conversation or automation
- [Voice Agent](https://docs.thoughtly.com/resources/glossary/voice-agent.md): A conversational interface that interacts with customers over the phone
- [Workflow](https://docs.thoughtly.com/resources/glossary/workflow.md): A series of automated steps that accomplish a specific task or process
- [Call Tagged Contacts](https://docs.thoughtly.com/resources/outbound-automation-tagged-contacts.md): Learn how to automatically call contacts that match specific tags using Automations.
- [Video Library](https://docs.thoughtly.com/resources/video-library.md): Watch a selection of videos to learn how to build and manage your Voice Agents
- [So, You Want to Start an AI Agency?](https://docs.thoughtly.com/resources/whitepapers/agency-guide.md): A comprehensive guide to building and scaling a successful AI agency using Thoughtly's industry-leading voice AI platform.
- [Breaking Free from Intent-Based Dialog Design: The Power of Thoughtly's Conversational AI](https://docs.thoughtly.com/resources/whitepapers/conversational-ai.md): Learn how Thoughtly stands out from traditional intent-based dialog design and delivers a more natural, engaging customer experience on the cutting edge of AI.
- [Overview](https://docs.thoughtly.com/resources/whitepapers/overview.md)
- [Changelog](https://docs.thoughtly.com/support/changelog.md): Stay up to date with the latest changes at Thoughtly
- [Support](https://docs.thoughtly.com/support/getting-help.md): Thoughtly's team is here to help.
- [Thoughtly Referral Program](https://docs.thoughtly.com/support/referral-program.md): Earn rewards by referring new customers to Thoughtly.

## OpenAPI Specs

- [openapi](https://docs.thoughtly.com/api-reference/openapi.json)
- [package](https://docs.thoughtly.com/package.json)

## Optional

- [Book a Demo](https://thoughtly.com/demo)
- [Platform Status](https://status.thoughtly.com)
- [Contact Support](mailto:support@thoughtly.com)