Skip to main content
This guide walks you through the full path: create an account, build your first agent, test it, and go live.
This guide focuses on building a voice agent. The flow is the same for text agents - you just connect your messaging channels (SMS, WhatsApp, email, chat) instead of a phone number. See Pearl Text to get started with text.

1. Sign Up

Create your account at platform.nlpearl.ai. You’ll get complimentary minutes to test calls - no subscription required to start.
NLPearl sign-up screen
During the trial phase, you can create agents and run test calls. To unlock full inbound and outbound campaigns, you’ll need to subscribe to a plan.

2. Create Your Agent with PearlVibe

PearlVibe is how you build your AI agents - voice or text. Describe what you need in a single prompt - PearlVibe generates the agent’s personality, conversation flow, knowledge base, and connected actions.
NLPearl dashboard with the PearlVibe chat
1

Write your prompt

When you land on the platform, the PearlVibe chat is right in front of you. Describe what your agent should do - be specific about the tone, language, and actions you need. Here are a few examples you can use as a starting point:
2

Review and refine

PearlVibe generates a complete agent configuration. Review the conversation flow, variables, and actions. Adjust anything that needs fine-tuning.

PearlVibe Documentation

Full guide on creating and customizing agents with PearlVibe.

3. Test Your Agent

Once your agent is ready, run test calls directly from the platform to hear how it sounds, verify the conversation flow, and confirm that actions (API calls, transfers, emails) fire correctly.
Run a test call from the platform
Use your complimentary minutes for testing. Iterate on the prompt, variables, and actions until the agent handles your scenarios cleanly.

4. Tweak and Optimize

Based on your test calls:
  • Adjust the conversation flow - refine how the agent responds to edge cases or unexpected inputs.
  • Configure variables - make sure data collection (names, emails, IDs) works as expected. See Variables.
  • Set up actions - connect API calls, call transfers, email or SMS triggers. See API Node.

5. Publish Your Agent

When you’re satisfied with the agent’s performance, publish it. This locks in your configuration and makes the agent available for live campaigns.

6. Connect a Phone Number

Assign a phone number to your agent. All plans include at least one US number. You can purchase additional numbers or port existing ones from the Phone Numbers settings.
Building a text agent instead? Connect your messaging channels (SMS, WhatsApp, email, chat) rather than a phone number. See Pearl Text.

7. Go Live

Launch your campaign:
  • Inbound - Route incoming calls to your agent. See Inbound.
  • Outbound - Upload contacts and let your agent initiate calls. See Outbound.
Monitor performance in real time from the Call Analytics dashboard.

Billing & Credits

Once you subscribe to a plan, you get access to agents, phone numbers, and call minutes. Each call minute is deducted from your plan’s included minutes - once exhausted, your credits are used.
Subscription plans in Subscriptions & Payments

Full Access to Activities

Engage in both inbound and outbound activities with no restrictions.

Included Agents & Phone Numbers

Concurrent agents and at least one US phone number included in every plan.
Auto-Recharge - We recommend activating auto-recharge to automatically top up your credits when they fall below a threshold, ensuring uninterrupted service.
Credit limits - When credits drop below zero, your concurrent agents per activity are reduced to one. If your debt reaches 10% of your monthly subscription price, all activities are suspended until you recharge.

What’s Next

PearlVibe

Deep dive into agent creation and customization.

Call Analytics

Track and optimize your agent’s performance.

Billing & Credits

Manage your subscription, credits, and auto-recharge.

API Quick Start

Integrate NLPearl programmatically via the REST API.

Subscription Plans

Compare plans and choose the best one for your needs.