Documentation Index
Fetch the complete documentation index at: https://developers.nlpearl.ai/llms.txt
Use this file to discover all available pages before exploring further.
What is Pearl Voice?
Pearl Voice lets you create AI voice agents that handle real phone conversations at scale. Built on a proprietary speech-to-speech architecture, Pearl delivers natural, low-latency, full-duplex voice interactions across 20+ languages - for both inbound support lines and outbound campaigns.New to NLPearl? The Quick Start walks you from sign-up to your first live call in minutes - with complimentary minutes to test, no subscription required.
How it works
Build your agent
Use PearlVibe to define your agent’s personality, knowledge base, conversation logic, and connected actions - all through a single prompt-driven interface.
Deploy on a phone line
Assign an NLPearl number, or connect Twilio or your own SIP-compatible VoIP provider to launch inbound lines or outbound campaigns. Your agent starts handling real calls immediately.
Use cases
Pearl Voice fits a wide range of scenarios across both inbound lines and outbound campaigns. Here are some of the most common.- Inbound
- Outbound
| Use case | What Pearl does |
|---|---|
| Customer Support | Answer incoming calls, resolve questions, and route to the right team - 24/7, at scale. |
| Technical Support | Guide customers through issue resolution step by step and escalate when needed. |
| Order Tracking | Give instant updates on orders, shipments, and delivery status. |
| Appointment Scheduling | Book, confirm, and reschedule appointments with real-time calendar integrations. |
| Complaints & Returns | Capture complaints, process returns and refunds, and log everything to your CRM. |
| Lead Intake & Qualification | Qualify inbound leads, collect their details, and schedule follow-ups. |
Models
Every Pearl runs on a voice model that defines how it reasons, how fast it responds, and how much it costs per minute. Pick the model that matches your use case - from deep reasoning for complex conversations to ultra-low cost for simple, high-volume flows.Pricing is relative to the Standard Rate (Pearl Trident). Credit adjustments apply per minute of conversation.
| Model | Description | Reasoning | Speed | Pricing |
|---|---|---|---|---|
| Pearl Hydra | Our smartest model, for demanding use cases that need deeper reasoning, stronger understanding, and higher-quality responses. | High | Higher latency | +2 credits/min |
| Pearl Arrow | Our fastest model - the same reasoning level as Trident, optimized for ultra-low latency. | Medium | Fastest | +2 credits/min |
| Pearl Trident | Our standard model, reliable for most everyday conversations - the recommended default. | Medium | Standard | Standard Rate |
| Pearl Oyster | Our most cost-effective model, for simple use cases where reducing cost matters more than reasoning or speed. | Low | Higher latency | -2 credits/min |
Good to know: the more your Pearl runs in production on your specific use case, the better it adapts and the faster it can generate responses over time.
Get Started
Agents
Your capacity to handle simultaneous calls. Each agent runs one call at a time - add more agents to scale up your concurrency.
Voices & Languages
Configure your agent’s name, language, and voice. Choose from 20+ languages and a wide range of natural-sounding accents.
Actions
Execute real-time actions mid-call: API requests, call transfers, emails, and SMS.
Post-Call
Access structured summaries, transcripts, recordings, and extracted variables for every call.
Inbound
Deploy agents on inbound lines to answer calls, resolve questions, and route to the right team - 24/7.
Outbound
Launch outbound campaigns to reach leads, qualify prospects, send reminders, and follow up at scale.
Phone Numbers & VoIP
Every voice activity needs a phone number. You can buy numbers directly from NLPearl, bring your own Twilio numbers, or connect your own SIP-compatible VoIP provider.Phone Numbers Overview
Understand why phone numbers are essential for your activities and which options are available to purchase or integrate them.
NLPearl Phone Numbers
Purchase phone numbers directly from the NLPearl platform and assign them to your inbound and outbound activities.
Twilio Integration
Connect your Twilio account to use your existing Twilio phone numbers with your Pearls.
Custom VoIP
Integrate your own SIP-compatible VoIP provider to route calls through your existing telephony infrastructure.
Next steps
Quick Start
Go from sign-up to your first live AI voice agent in minutes.
PearlVibe
Build and customize your agent’s logic, knowledge, and actions from a single prompt.
Variables
Collect, store, and reuse data during conversations - from user inputs to CRM lookups.
API Quick Start
Integrate Pearl Voice programmatically via the REST API.