Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.thoughtly.com/llms.txt

Use this file to discover all available pages before exploring further.

Email domains let your workspace send and receive email through addresses connected to Thoughtly agents. Use them for confirmations, follow-ups, longer-form customer replies, and omnichannel workflows that should continue outside voice or SMS.

Add a domain

  1. Go to Settings → Email Domains.
  2. Click Add Domain.
  3. Enter the domain you want to send from, such as example.com.
  4. Add the required DNS records at your DNS provider.
  5. Return to Thoughtly and click Verify DNS.

DNS provider tips

Thoughtly shows records in the format expected by common DNS providers.
ProviderTip
CloudflareSet email-related MX and CNAME records to DNS only. Do not proxy them.
NamecheapUse Custom MX for MX records. Enter only the host prefix when Namecheap appends your domain automatically.
GoDaddyUse @ for the root domain and only the prefix for subdomains when GoDaddy appends your domain.
Route 53Use fully qualified record names with a trailing dot where required.
OtherUse the full record name and value shown in Thoughtly.
DNS verification can take time. Some records appear within minutes, while others may take longer because of DNS propagation and provider caching.

Domain statuses

StatusMeaning
PendingDNS records have not been verified yet or are still propagating.
VerifyingThoughtly is checking the DNS records.
ActiveThe domain is verified and ready to send.
FailedVerification failed. Review the error, update DNS, and try again.

Create email addresses

After a domain is verified, create one or more email addresses and link them to agents. Examples:
  • sales@example.com → inbound sales qualification agent
  • support@example.com → support triage agent
  • appointments@example.com → scheduling agent

Global vs agent email settings

Workspaces can define global email behavior, while individual agents may override settings for specific workflows. Use agent-level settings when an agent needs unique reply behavior, sender identity, or channel-specific instructions.

Reply routing

Incoming replies are routed based on the connected email address and conversation context. When an address is linked to an agent, replies can continue through that agent instead of starting a disconnected thread.

Email prompts

Write email prompts for email. Do not reuse voice scripts without editing. Good email instruction:
Write a concise email reply that answers the customer's question, includes the booking link if they want to schedule, and signs off as the Acme Support team.
Poor email instruction:
Say: Hi, is this Brian?

Troubleshooting

DNS records stay pending

  • Confirm the provider-specific formatting is correct.
  • Check for extra spaces or duplicated domain names.
  • Make sure Cloudflare records are not proxied.
  • Wait for propagation, then try verification again.

Replies are not reaching the agent

  • Confirm the email address is linked to the correct agent.
  • Check that the domain is active.
  • Verify the reply was sent to a connected address.

Verification failed

Read the error message, update the DNS records, and click Verify DNS again. Failed domains return to a retryable state so you can fix configuration without creating a new domain.