Skip to main content
The Conversation Tree Editor is a powerful tool that allows you to design and visualize conversation flows in a user-friendly, visual interface. Whether you’re creating customer surveys, support dialogues, or interactive voice responses, this editor helps you craft natural and personalized conversations.
Send Email action interface on light mode
Send Email action interface on dark mode

Overview

What is PearlVibe?

PearlVibe is an AI‑assisted flow editor for phone call agents. You build your Pearl as a decision tree made of nodes (dialogue, actions, integrations…) and transitions (what happens next depending on user intent, answers, or call outcome).
You can work in two complementary ways:
ModeDescription
Vibe coding (chat mode)You talk to the AI in natural language (e.g. “Add a post‑call SMS when the booking is confirmed”) and Pearl Vibe automatically creates or edits nodes and transitions for you.
Manual modeYou configure each node and its transitions yourself for full control. Every setting is visible and editable.

What can you build with PearlVibe?

With PearlVibe, you can design:
Flow TypeUse Cases
Inbound flowsSupport and customer care lines, order tracking, FAQs, triage, appointment management, etc.
Outbound campaignsSales campaigns, payment reminders, debt collection, upsell flows, satisfaction surveys, and more.

Key benefits

  • Build in minutes instead of days – Use the chat to describe what you want, then refine visually.
  • Safe versioning – Work in a Draft with autosave while your Published version continues to run in production.
  • Visual understanding of calls – Use test calls and live node highlighting to see exactly how calls traverse your flow.
  • Structured but flexible – Combine high‑level “vibes” (global instructions, personality) with precise node and transition logic.

How PearlVibe Is Structured

PearlVibe is composed of four main areas:
AreaDescription
The headerGlobal controls, versioning, model choice, integrations, tasks, and test calls.
The left sidebarChat (vibe coding) and manual configuration of the selected node.
The central canvasThe visual decision tree where nodes and transitions live.
Top navigation tabsSwitch between the main workspaces of your Pearl: Flow Editor, Pearl Settings, Knowledge Base, Analytics, and Campaign Settings (inbound / outbound).
Let’s dive into each area to understand how the editor comes together.

The header is always visible at the top of the editor. It centralizes the main controls related to your Pearl as a whole.
Send Email action interface on light mode
Send Email action interface on dark mode

Shows the current Pearl’s name and lets you rename it. This is the label you’ll reuse in the platform and in your workspace.
Send Email action interface on light mode
Send Email action interface on dark mode
Model selection defines the intelligence, speed, and cost profile of your Pearl. From the model picker in the header, you can choose between three NLPearl models:
Send Email action interface on light mode
Send Email action interface on dark mode
Available models
ModelQualitySpeedCost
Pearl ArrowBest QualityFastest+2 credits/min
Pearl TridentBest QualityStandardStandard Rate
Pearl OysterGood QualityStandard-2 credits/min
Best Quality · Fastest · +2 credits/min
Our high-intelligence model, offering the same depth as Pearl Trident but tuned for ultra-low latency.Use it when you need:
  • The snappiest real-time experience for callers.
  • Highly nuanced, human-like conversations.
  • VIP lines, complex sales calls, or high-stakes negotiations where every second of silence matters.

Choosing the right model for your PearlWhen selecting a model, consider three main dimensions:
DimensionRecommendation
SpeedIf the caller experience must feel instant (no awkward silences, rapid back-and-forth), prefer Pearl Arrow. For standard conversational latency, Pearl Trident and Pearl Oyster are usually enough.
Reasoning / intelligenceFor complex qualification, multi-step troubleshooting, or situations where the agent needs to “think”, choose Pearl Trident or Pearl Arrow. For simple flows with clear scripts and few edge cases, Pearl Oyster is more than sufficient.
CostPearl Arrow delivers top experience at a higher per-minute cost (+2 credits/min vs Trident). Pearl Trident offers best quality at a standard rate. Pearl Oyster is cheaper per minute (–2 credits/min vs Trident), ideal when cost per call is the main constraint.
You can use different models for different Pearls depending on their role, volume, and business impact (for example: Arrow for VIP inbound support, Trident for main support, Oyster for large reminder campaigns).

Impact on your PearlYour model choice directly affects:
ImpactDescription
Answer qualityNuance, empathy, and how well the Pearl handles ambiguous or messy input.
LatencyHow quickly the Pearl responds after the caller finishes speaking.
Cost per call / per minuteThe effective cost of each campaign or use case.
You can start with Pearl Trident as a balanced default, then use Analytics to compare performance and cost. If you need more speed or nuance, move to Pearl Arrow; if you need to optimize budget for simple flows, switch to Pearl Oyster.
Pearl Vibe is built for safe iteration: you can experiment freely without breaking your live calls.Autosave Drafts
Send Email action interface on light mode
Send Email action interface on dark mode
  • All changes in the editor are automatically saved into a Draft.
  • The Draft is independent from the live Published version.
  • You can close and come back later: the Draft is preserved.

Published Version (View Mode)
Send Email action interface on light mode
Send Email action interface on dark mode
  • The Published version is the one actually used to handle calls.
  • You can open it in view‑only mode to review what is currently live.
  • This helps align product, ops, and compliance teams on the exact live configuration.

Rollback to Published
Send Email action interface on light mode
Send Email action interface on dark mode
  • If your Draft becomes messy or contains changes you no longer want, you can rollback.
  • Rollback discards the current Draft and reloads the editor with the latest Published version.
This is useful to recover quickly after experimental edits or bad modifications.

Publishing a New Version
Send Email action interface on light mode
Send Email action interface on dark mode
  • When you are satisfied with your Draft and tests, click Publish.
  • The Draft becomes the new Published version and starts handling calls.
  • A new Draft session then begins for your next round of changes.
Integrations and variables are what connect your Pearl to the rest of your stack.
Send Email action interface on light mode
Send Email action interface on dark mode
Variable ManagerVariables can be managed using the Variable Manager, the Variable Manager allows you to create, edit, and organize variables used in your conversation flows.
Send Email action interface on light mode
Send Email action interface on dark mode
See the Variables documentation for more details.

Integration ManagerThe Integration Manager is where you connect external systems by adding credentials and configuration for each integration.
Send Email action interface on light mode
Send Email action interface on dark mode
It lets you:
  • Add new integrations (e.g. Salesforce, HubSpot, ticketing tools, booking engines).
  • Configure authentication.
As your flows grow, PearlVibe helps you keep them valid, connected, and fully configured.
Send Email action interface on light mode
Send Email action interface on dark mode
Error detectionPearl Vibe automatically scans your Pearl for common issues, such as:
  • Nodes without outgoing transitions.
  • Transitions not connected to any node.
  • Missing required fields (for example: API nodes without an endpoint or description).
  • Incomplete campaign or flow configuration.
When such issues are detected, the Tasks & Errors button in the header lights up to signal that something needs your attention.
Tasks & Errors sidebarClicking the Tasks & Errors button opens a right-hand sidebar that groups everything in one place:
SectionContent
Task & Error sectionLists all issues found in your nodes (e.g. “Missing API Endpoint”, “Missing Transition: Continue”).
Credentials sectionLists integrations that still need to be connected (e.g. Algolia, Calendly, etc.).
Each card in the Task & Error section shows:
  • A short description of what’s missing or misconfigured.
  • A “Fix with AI” action to let the agent propose and apply a fix.
  • An “Open in editor” action that jumps directly to the affected node in the Flow Editor.
You can either fix issues manually or let the AI draft and apply the corrected configuration for you.
Test calls are the safest way to validate your Pearl before and after publishing.Launching a Test Call
Send Email action interface on light mode
Send Email action interface on dark mode
To run a test call:
  • Open the Test Call panel from the header.
  • Enter the phone number you want to call (usually your own or a test device).
  • Start the test: the Pearl calls that number using the current Draft configuration (unless you choose otherwise).

Live Node Tracing
Send Email action interface on light mode
Send Email action interface on dark mode
During the test call:
  • Nodes in the canvas light up one after another as the conversation progresses.
  • You can visually follow the path the call is taking through your flow.
This helps you understand why a certain question was asked, see which transition was taken at each step, and debug misrouted calls or unexpected behaviors.

Post‑Call Views
Send Email action interface on light mode
Send Email action interface on dark mode
The Test Call panel also includes a tab for Post‑Calls:
  • See which Post‑Call nodes were executed after hang‑up.
  • Inspect the actions triggered (SMS, emails, CRM updates, webhooks…).
  • Use this view to verify that your back‑office automation is behaving as expected.
To learn more about Post-Call, see the Post-Call documentation.

Chat Sidebar

The chat sidebar is the control panel for the current node. It combines two complementary views:
ViewDescription
ChatVibe coding with the PearlVibe AI.
ManualExplicit configuration of the selected node.
All actions in this sidebar always apply to the node currently selected in the flow editor (unless explicitly noted as global, like General Instructions).
Send Email action interface on light mode
Send Email action interface on dark mode
In Chat mode, you design and update the flow by describing changes in natural language. Pearl Vibe interprets your request and applies the corresponding modifications to the Draft.Typical operations you can perform:
  • Create or delete nodes.
  • Edit the content and behavior of a node.
  • Add, rename, or reconnect transitions.
  • Attach actions (API calls, SMS, email, transfers, etc.).
  • Configure post-call logic.
Key elements:
ElementDescription
Chat inputEnter instructions such as: “Split this node into three outcomes based on payment status.”, “After a successful payment, send a confirmation SMS and end the call.”, “Create a post-call node that logs the outcome to the CRM.”
SendSends your instruction to the AI and applies the resulting changes to the flow. The editor is updated in real time so you can immediately review what has changed.
File uploadAttach supporting material (FAQs, pricing sheets, policy docs, playbooks, etc.). These files enrich the Pearl’s knowledge and can be referenced in node prompts and call behavior.
Enhance promptTakes a rough or short instruction and rewrites it into a clearer, more structured request before execution. Use this when your initial prompt is ambiguous or incomplete and you want the AI to “clean it up” first.
Node context pillWhen a node is selected in the canvas, its name appears as a pill above the chat. Any instruction you send while this pill is active is interpreted in the context of that node (for example: “Change the greeting”, “Add a failure transition that transfers to support”, etc.).
Chat mode is the recommended entry point to quickly build or refactor a flow, especially for large or complex trees.

Central Canvas

The central canvas displays your flow as a graph of nodes and transitions.
Send Email action interface on light mode
Send Email action interface on dark mode
ElementDescription
NodesEach node represents a step in the call (a message, an action, or a set of actions).
TransitionsEach transition represents a possible path from one node to another based on intents, recognition results, or business logic.
From the canvas you can:
  • Select nodes to open them in the sidebar.
  • Drag nodes to reorganize the layout visually.
  • Follow transitions to understand how the call can move through the flow.
  • Hover nodes to see popovers with a quick summary of what they do (main actions, key conditions, etc.).
Pearl Vibe supports several node types:
Node TypeDescription
Start nodeEntry point of the flow.
In‑Call nodesActions that occur while the caller is on the line.
Integration nodesInteractions with external systems (CRM, ticketing, booking…).
End Call nodeThe node that ends the conversation.
Post‑Call nodesActions executed after the call has ended.
Understanding Node Types: Pre-Call, In-Call & Post-CallYour Pearl flow is built around three categories of nodes, each designed for a specific moment in the call lifecycle. Knowing the difference is essential to avoid misusing an action or expecting behavior that can’t happen at that stage.1. Pre-Call Nodes — Before the call startsThese nodes run prior to dialing or answering. They’re ideal for preparing context: fetching customer data, checking availability, validating an ID, loading account information. They cannot interact with the caller and cannot create or import leads.2. In-Call Nodes — During the conversationThese nodes control everything that happens while the caller and the agent are connected. Dialogue, decision logic, sending SMS/emails, API calls, CRM updates — all real-time actions happen here. This is the core of your conversational flow.3. Post-Call Nodes — After the call endsOnce the call is finished, these nodes handle asynchronous tasks: writing CRM logs, creating leads, triggering webhooks, updating databases, or launching follow-up workflows. They cannot affect what happened during the call, only what happens after.
Every flow begins with a Start node. It controls how the conversation is initiated.
Send Email action interface on light mode
Send Email action interface on dark mode
You can configure it in two ways:
ConfigurationDescription
Opening sentenceA standard greeting and first question, for example: “Hi, you’ve reached [Company]. How can I help you today?”
Pre‑Call APIBefore the Pearl speaks, it can call an external API (for example to fetch order details, check account status, or pre‑qualify the caller). The API response can then change the opening sentence, route the caller toward different branches, or preload variables and context.
The Pre-Call API cannot be used to import leads into your Pearl. Its purpose is strictly to enrich or prepare contextual data before the call starts
In‑Call nodes represent actions and dialogues during the call. Typical types include:
Send Email action interface on light mode
Send Email action interface on dark mode
Node TypeDescription
DialogueThe Pearl speaks, listens, and interprets the caller’s response according to your instructions.
Send SMSSend a text message to the caller during the call (e.g. a confirmation code, a link, or a summary).
Send emailTrigger an email to the caller or your team.
APICall an external API (e.g. update a record, check availability, create a ticket).
Transfer callTransfer the caller to a human agent or another phone number. You can control what happens before and after transfer.
Integration nodes allow your Pearl to interact directly with external tools and services without writing any API code yourself. They serve as pre-configured action blocks that handle authentication, request formatting, and data mapping automatically.
Send Email action interface on light mode
Send Email action interface on dark mode
Integration node variants:
VariantDescription
In-Call Integration NodesExecuted while the caller is still on the line (e.g. checking a CRM record before answering).
Post-Call Integration NodesExecuted after the call ends (e.g. logging call results into a ticketing system).
What Integration Nodes DoIntegration nodes encapsulate tasks such as:
CategoryExamplesTasks
CRM operationsSalesforce, HubSpot, Pipedrive…Create or update records, attach call results, sync contact data.
Helpdesk platformsZendesk, Freshdesk…Create tickets, update statuses, push conversation summaries.
Booking enginesCalendly, Cloudbeds, Shore…Check availability, create reservations, cancel or modify bookings.
Search & data servicesAlgolia, Elasticsearch…Query product/catalog data, validate inputs, or retrieve structured info.
Payments & billingStripe, Paystack…Check payment status, initiate a payment link workflow, validate customer identity.
Custom IntegrationsAny configured integrationAny integration you configure in the Integration Manager becomes available here as a dedicated node.
How They Work
FeatureDescription
Secure CredentialsThe Integration Manager stores credentials securely (API keys, tokens, IDs…).
Available as NodeOnce connected, each service becomes available as a node in the flow.
Simple ConfigurationThe node exposes only the required parameters—no API documentation or coding needed.
Data MappingReturned data can be mapped to variables and used later in the conversation.
Available Integrations
ActiveCampaign
Airtable
Algolia
Anthropic
AssemblyAI
Backblaze
Baserow
Bitly
Brevo
Cal.com
Calendly
Clearbit
ClickUp
Cloudflare
Cohere
Contentful
Convertkit
Customer.io
Datadog
DeepL
DigitalOcean
Discord
Elasticsearch
Freshdesk
Ghost
Google Calendar
Google Docs
Google Sheets
Grafana
Groq
Hetzner
HubSpot
HuggingFace
Hunter
InfluxDB
JotForm
Lemlist
Magento
MailerLite
Mailgun
Mailjet
Mandrill
Matrix
Mattermost
MessageBird
Metabase
Microsoft Outlook
MinIO
Mistral AI
Mocean
MongoDB
MQTT
MSG91
MySQL
Netlify
New Relic
NocoDB
OpenAI
OpenRouter
OpenWeatherMap
Pabbly
Paddle
PagerDuty
Perplexity
Pinecone
Plivo
PostHog
PostgreSQL
Postmark
Pushover
Qdrant
RabbitMQ
Redis
Replicate
Rocketchat
Salesforce
SendGrid
Sendy
Sentry
Serp
SIGNL4
SparkPost
Square
Stability AI
Strapi
Supabase
Telegram
Together AI
Twilio
Typeform
Vercel
Vonage
Wasabi
Weaviate
WooCommerce
WordPress
Wufoo
Yourls
Zulip
End Call nodeThis node closes the conversation gracefully (e.g. “Thanks for your time, goodbye.”). It is typically the last in‑call node.
Send Email action interface on light mode
Send Email action interface on dark mode
Post‑Call nodesAfter the End Call node, you can add Post‑Call nodes via transitions. These nodes execute actions after the call has ended, such as:
  • Sending a summary SMS.
  • Writing a detailed log into your CRM.
  • Triggering a webhook.
  • Sending internal notifications to your team.
Post‑Call nodes support many of the same actions as In‑Call nodes but are not constrained by real‑time conversation.
Send Email action interface on light mode
Send Email action interface on dark mode
Each node shares a common structure:
Send Email action interface on light mode
Send Email action interface on dark mode
Header
  • Icon representing the type of node.
  • Node name, editable to reflect its role (“Payment check”, “Qualification”, “Post‑call CRM update”…).
Transitions listUnder the header, you see the list of transitions for this node (e.g. “Success”, “Failure”, “No match”, “Ask for human”). From here you can:
  • See which node each transition points to.
  • Click to navigate along the transition.
  • Disconnect or reconnect transitions to reshape the flow.
Hover popoverWhen you hover a node in the canvas, a popover shows a short summary:
  • Main instruction or script.
  • Key actions (SMS, API, transfer…).
  • Critical transitions or tags.
At the bottom of the canva you’ll find:
ToolDescription
Add node buttonsCreate new nodes manually (Pre-Call, In-Call, or Post-Call nodes), browse and search node types, and insert nodes directly into the flow.
General InstructionsOpens a popup where you define global instructions for the entire flow (tone, strategy, guardrails, constraints). These act as a “meta prompt” on top of individual nodes.
SearchSearch across all nodes by name or content and jump directly to the node you need.
Send Email action interface on light mode
Send Email action interface on dark mode

Top Navigation tabs

Configure your Pearl’s identity, knowledge, and behavior settings.
Send Email action interface on light mode
Send Email action interface on dark mode

In this step, you can customize your voice agent’s identity and behavior by setting its name, language, voice, personality, and timezone.

Agent Names, Languages & VoicesTo define your agent’s identity:
  • (1) Agent Name – Give your agent a name (e.g., Joa, Victoria). This name helps humanize the interaction and reflect your brand identity.
  • (2) Language – Select the default language your agent will speak. This ensures accurate pronunciation and localized expressions.
  • (3) Voice – Choose the voice that will represent your agent. You can preview voices and select the one that fits your tone.
Send Email action interface on light mode
Send Email action interface on dark mode

Multilingual Agent Configuration:You can set up your Pearl to support multiple languages by creating several agent configurations — each with a specific name, language, and voice.
  • To add a new language configuration, click on the ”+” button (2). This allows you to define additional agents who can handle conversations in other languages.
  • Each configuration should include a name (used during calls), a language, and a corresponding voice.
When a caller requests to switch to another language during the conversation, Pearl will automatically reroute the call to the agent associated with that language — ensuring a smooth and localized experience.
  • The first agent you create is automatically marked as the Default Agent (1). This agent will always initiate the conversation when a call begins, unless another language is requested by the caller.
You can define as many language configurations as needed — perfect for global audiences or multilingual teams.
Send Email action interface on light mode
Send Email action interface on dark mode
Explore Voice and Language to view all the language options available.

PersonalityYour AI agent can take on a wide range of personalities — from natural and professional to wild, fictional, or downright iconic.
Personality NameDescription (vibe / reference)
NaturalNeutral and balanced — default tone.
Friendly ConsultantWarm, helpful, and a touch conversational.
Aggressive CloserDirect, assertive, always aiming for a “yes.”
Donald TrumpBold, confident, and controversial.
Joe BidenSoft-spoken, empathetic, with a hint of grandpa energy.
Wolf of Wall StreetEnergetic, persuasive, and money-focused.
Elon MuskVisionary, quirky, and matter-of-fact.
Kevin HartFast-talking and hilarious.
The RockCharismatic and full of hype.
Jar Jar BinksClumsy comic relief with a chaotic syntax.
YodaWise, reversed sentence order, it has.
Tommy ShelbyCold, calculated, Peaky Blinders style.
Saul GoodmanSlick, legal hustler energy.
Heisenberg (Walter White)Dark, serious, calculated — “I am the danger.”
Jesse PinkmanStreet-smart, informal, frequent “yo.”
Optimus PrimeHeroic, formal, and noble.
MegatronVillainous and authoritarian.
Son GokuCheerful and battle-ready.
Daenerys TargaryenRegal, determined, breaker of chains.
Hermione GrangerBook-smart, precise, articulate.
MulanBrave, focused, honorable.
Lady GagaGlamorous and creatively intense.
Tony Stark (Iron Man)Witty, tech-savvy, and full of sarcasm.
Elsa (Frozen)Calm, regal, with an icy edge.
Michael Scott (The Office)Awkward, unpredictable, tries to be funny.
MoanaAdventurous, optimistic, and kind.
Frida KahloArtistic, deep, and passionate.
Jack SparrowEccentric and unpredictable.
Indiana JonesAdventurous and confident.
BeyoncéEmpowered, elegant, and commanding.
Sherlock HolmesAnalytical, detached, brilliant.
Tiana (The Princess & Frog)Driven, grounded, and focused.
Charlie ChaplinSilent-era charm with expressive tone.
Katniss EverdeenStoic, focused, and fiercely independent.
GrootRepetitive but expressive (“I am Groot”).
DeadpoolChaotic, irreverent, 4th-wall-breaking.
The JokerUnhinged, theatrical, and darkly funny.
LokiMischievous, cunning, and charismatic.
Bugs BunnyWitty, cheeky, and playful.
Pee-wee HermanEccentric and unpredictable.
Dr. EvilSatirical villain, comically ambitious.
Borat SagdiyevNaive, awkward, hilariously inappropriate.
Albert EinsteinBrilliant, theoretical, with quirky logic.
Dorothy GaleInnocent, curious, with wonder in her tone.
Send Email action interface on light mode
Send Email action interface on dark mode
Choose wisely — your agent’s personality will shape how it sounds and behaves in every interaction.

TimezoneDefine the timezone of the agent. This influences time-related actions, such as booking meetings.
Send Email action interface on light mode
Send Email action interface on dark mode
Before your Pearl can answer questions accurately, it needs context. This step helps define the essential background information your agent will rely on during conversations.

Company NameGive your Pearl the name of the company it represents. This name may be used when Pearl introduces itself or provides company-related information.
Send Email action interface on light mode
Send Email action interface on dark mode


Company DescriptionAdd a brief company description including your industry, mission, or key services. This allows Pearl to answer questions with more contextual relevance.
Send Email action interface on light mode
Send Email action interface on dark mode


Pearl Knowledge BaseThis is where you teach Pearl what it needs to know to respond with relevance and accuracy. Add detailed information about your services, pricing, opening hours, locations, and any key operational data.
You can either write this content manually or upload a reference file.
Multiple documents can be added if needed — supported formats: .doc, .docx, .txt.
Whether you’re describing how your subscription plans work, listing available services, or clarifying your business hours, this section allows Pearl to access structured information that supports more precise answers.
Send Email action interface on light mode
Send Email action interface on dark mode


MemoryWhen enabled, Pearl remembers the user or lead, allowing it to seamlessly continue conversations from where they left off.
This feature is particularly useful for:
  • Multi-step processes
  • Follow-ups
  • Any scenario where continuity matters

Example use case: Hospitality

Let’s say a guest checks into a hotel. Pearl can:
  • Remember their room number
  • Greet them by name
  • Recall their preferences (like “extra towels” or “no wake-up call”)
  • Offer a smooth, personalized experience every time they call
Resetting MemoryNeed a fresh start? Pearl’s memory can be reset via API.This is especially important in contexts like hospitality, where once a guest checks out, Pearl clears the slate — ensuring the next visitor starts with a clean experience.
Send Email action interface on light mode
Send Email action interface on dark mode


Speech Recognition KeywordsSome words are just… not in the dictionary. Whether you’re using brand-specific terms, creative product names, or industry jargon, teaching Pearl how to recognize them makes all the difference.Use this feature to define:
  • Keywords: The unique word or name you want Pearl to catch
  • Pronunciations: Variations of how users might say it (spoken form)

Example

Let’s say your bakery sells a pastry called FluffoBun.Here’s how you’d define it:
  • Keyword: FluffoBun
  • Pronunciations: fluh-foh-bun, floof-oh-bun, fluff-bunb
    (Separate each pronunciation with a comma)
This helps Pearl match even creatively named terms to real user input — no matter how it’s pronounced.
Send Email action interface on light mode
Send Email action interface on dark mode

Use this section to track, evaluate, and act on your Pearl’s performance. Define what success looks like, apply custom tags to key conversation moments, and set up notifications to stay on top of important calls.

Define the Success of Your PearlSpecify what constitutes a successful call for your Pearl — such as booking a meeting, confirming interest, or qualifying a lead. This success definition will be reflected in your campaign analytics and lead statuses, helping you sort and follow up efficiently.
If you don’t define success for your Pearl, all answered calls will be marked as Completed by default.

By using this feature, you’ll unlock two possible outcomes instead: Call Successful and Call Unsuccessful, giving you more control over lead qualification.
Send Email action interface on light mode
Send Email action interface on dark mode


Indicator TagsUse Indicator Tags to label and categorize key moments in a conversation.

They help you structure your data, identify important insights, and filter your leads with precision.
Each tag includes:
  • Name — A clear label (e.g. "Interested", "Mentioned Competitor")
  • Color — Used for visual sorting in your interface
  • Assignment rule — A short description of when the tag should be applied
Tags are assigned automatically during the call, based on the conditions you define.

Example

You’re asking leads what they usually drink in the morning. You might define:
  • Tag: Coffee
    • Color: Brown
    • When to assign: If the lead mentions drinking coffee
  • Tag: Tea
    • Color: Green
    • When to assign: If the lead mentions drinking tea
These tags will then appear in your lead data and call logs, making it easy to segment and analyze responses.
Indicator Tags are not just for display — they’re functional. You can filter campaigns by tag, trigger notifications, or use them to define success in analytics.
Send Email action interface on light mode
Send Email action interface on dark mode

Configure your campaign settings for inbound or outbound calls.
What are Inbound Activities?Inbound Activities refer to the capability of your conversational AI to handle incoming calls. This feature allows you to engage with callers immediately and effectively, using the conversational flows defined in your Pearl.
Steps to Create an Inbound Activity
1

Purchase a Phone Number

You first need to acquire a phone number from our platform. This number will be dedicated to your Inbound Activity and can receive calls from anywhere at any time.
Send Email action interface on light mode
Send Email action interface on dark mode
2

Assign the Phone Number to Your Campaign

Link the purchased phone number to the Pearl you want to use for handling inbound calls. This connects your conversational flow to real-world interactions.
Send Email action interface on light mode
Send Email action interface on dark mode
3

Configure Inbound Setting

Set up your inbound call parameters, such as:
  • Number of Agents: Specify the number of agents that will handle calls simultaneously.
Send Email action interface on light mode
Send Email action interface on dark mode

  • Waiting Queue Message: Define the sentence that will be said to callers if they enter the waiting queue.
Send Email action interface on light mode
Send Email action interface on dark mode

  • Queue Music: Choose the song that will be played while callers wait in the queue.
Send Email action interface on light mode
Send Email action interface on dark mode

  • Recording Option: If recording is enabled, this conversation will be recorded and saved for future access. If recording is disabled, the conversation will not be recorded and no audio will be available.
  • Recording After Transfer Call: Boolean - If enabled, the call will continue to be recorded after being transferred. Note: “Pearl & End-user” must be selected; otherwise, it will be automatically disabled. This setting is important for maintaining logs in multi-agent interactions.
Send Email action interface on light mode
Send Email action interface on dark mode

  • Transcript Masking: (Post-Call) When enabled, sensitive information in conversation transcripts is automatically masked after the call while preserving essential context. This is especially useful for post-call analysis, compliance, and data security, ensuring that private details like: Credit card numbers Social Security numbers Personal identifiers are redacted while keeping the conversation readable.
Send Email action interface on light mode
Send Email action interface on dark mode

For example, if a customer says: “My credit card number is 1234-5678-9012-3456.” The transcript might store it as: “My credit card number is —**-3456.” This helps businesses review interactions safely without exposing sensitive data.
4
  • Call Webhook: A call webhook is triggered at key points during the call lifecycle, such as when the call is initiated and when it ends. You receive an object similar to the one returned by the Get Calls Endpoint, including details like call duration, outcome, and any data collected during the call. This is useful for tracking call performance and automation.
Send Email action interface on light mode
Send Email action interface on dark mode



Managing Call Volume with QueuesIf your Inbound Activity experiences high call volumes, callers will not be turned away. Instead, they will enter a waiting queue where they can listen to customizable messages and music until an AI agent becomes available.

Call Queue Configuration

Customize the waiting message and background music to keep your callers engaged while they wait. This feature helps in maintaining a professional and pleasant waiting experience.

Monitoring and Adjusting Your Inbound Activities

While basic monitoring of call logs and activity reports can be done via our API, any modifications to the activity setup or features like voice changes and language settings need to be handled directly on the platform.