PearlVibe

PearlVibe is a powerful AI-assisted flow editor 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, PearlVibe helps you craft natural and personalized conversations.

Overview

What is PearlVibe?

PearlVibe is an AI‑assisted flow editor for building your agents - both voice (phone) and text 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 conversation outcome).

You can work in two complementary ways:

Mode	Description
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 mode	You 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 Type	Use Cases
Inbound flows	Support and customer care lines, order tracking, FAQs, triage, appointment management, etc.
Outbound campaigns	Sales 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:

Area	Description
The header	Global controls, versioning, model choice, integrations, tasks, and test calls.
The left sidebar	Chat (vibe coding) and manual configuration of the selected node.
The central canvas	The visual decision tree where nodes and transitions live.
Top navigation tabs	Switch 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

Pearl Name

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.

Model Selection

Model selection defines the intelligence, speed, and cost profile of your Pearl. The models available depend on your agent type: voice agents can choose from the four models below, while text agents run on Pearl Swan (see Text model).

Voice models

Model	Quality	Speed	Cost
Pearl Hydra	Highest Quality	Higher latency	+2 credits/min
Pearl Arrow	Best Quality	Fastest	+2 credits/min
Pearl Trident	Best Quality	Standard	Standard Rate
Pearl Oyster	Good Quality	Standard	-2 credits/min

Pearl Hydra
Pearl Arrow
Pearl Trident
Pearl Oyster

Highest Quality · Higher latency · +2 credits/min

Our smartest model, built for demanding use cases that require deeper reasoning, stronger understanding, and the highest-quality responses.Use it when you need:

The deepest reasoning for complex, multi-step conversations.
Maximum nuance and understanding on high-stakes or ambiguous calls.
The best possible answer quality, even if it means slightly higher latency.

Choosing the right model for your PearlWhen selecting a model, consider three main dimensions:

Dimension	Recommendation
Speed	If 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 / intelligence	For the most demanding use cases that need the deepest reasoning, choose Pearl Hydra. For complex qualification, multi-step troubleshooting, or situations where the agent needs to “think”, Pearl Trident or Pearl Arrow are strong choices. For simple flows with clear scripts and few edge cases, Pearl Oyster is more than sufficient.
Cost	Pearl 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: Hydra for the most complex high-stakes calls, Arrow for VIP inbound support, Trident for main support, Oyster for large reminder campaigns).

Impact on your PearlYour model choice directly affects:

Impact	Description
Answer quality	Nuance, empathy, and how well the Pearl handles ambiguous or messy input.
Latency	How quickly the Pearl responds after the caller finishes speaking.
Cost per call / per minute	The 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.

Text modelText agents run on a single model - Pearl Swan - so there’s no model picker to configure. It’s billed per message rather than per minute.

Pearl Swan - our standard model for chat agents, built to handle any text-based use case with reliable reasoning and natural responses.

Optional add-ons let your text agent understand richer inputs sent in the chat:

Add-on	Description
Vision	Read and understand images customers send, such as screenshots, documents, or photos.
Audio input	Understand voice notes and audio messages sent in the conversation.

Versioning, Drafts & Publishing

Pearl Vibe is built for safe iteration: you can experiment freely without breaking your live calls.Autosave Drafts

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)

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

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

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 & Variables

Integrations and variables are what connect your Pearl to the rest of your stack.

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.

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.

It lets you:

Add new integrations (e.g. Salesforce, HubSpot, ticketing tools, booking engines).
Configure authentication.

Task & Error Management

As your flows grow, PearlVibe helps you keep them valid, connected, and fully configured.

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:

Section	Content
Task & Error section	Lists all issues found in your nodes (e.g. “Missing API Endpoint”, “Missing Transition: Continue”).
Credentials section	Lists 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 & Debugging

Test calls are the safest way to validate your Pearl before and after publishing.Launching a Test Call

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

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

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.

The chat sidebar is the control panel for the current node. It combines two complementary views:

View	Description
Chat	Vibe coding with the PearlVibe AI.
Manual	Explicit 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).

Chat mode (Vibe Coding)
Manual mode (per node)

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:

Element	Description
Chat input	Enter 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.”
Send	Sends 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 upload	Attach 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 prompt	Takes 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 pill	When 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.

Element	Description
Nodes	Each node represents a step in the call (a message, an action, or a set of actions).
Transitions	Each 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.).

Node Types Overview

Pearl Vibe supports several node types:

Node Type	Description
Start node	Entry point of the flow.
In‑Call nodes	Actions that occur while the caller is on the line.
Integration nodes	Interactions with external systems (CRM, ticketing, booking…).
End Call node	The node that ends the conversation.
Post‑Call nodes	Actions 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, and CRM updates all happen here in real time. 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.

Start Node

Every flow begins with a Start node. It controls how the conversation is initiated.

You can configure it in two ways:

Configuration	Description
Opening sentence	A standard greeting and first question, for example: “Hi, you’ve reached [Company]. How can I help you today?”
Pre‑Call API	Before 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

In‑Call nodes represent actions and dialogues during the call. Typical types include:

Node Type	Description
Dialogue	The Pearl speaks, listens, and interprets the caller’s response according to your instructions.
Send SMS	Send a text message to the caller during the call (e.g. a confirmation code, a link, or a summary).
Send email	Trigger an email to the caller or your team.
API	Call an external API (e.g. update a record, check availability, create a ticket).
Transfer call	Transfer the caller to a human agent or another phone number. You can control what happens before and after transfer.

Integration Nodes

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.

Integration node variants:

Variant	Description
In-Call Integration Nodes	Executed while the caller is still on the line (e.g. checking a CRM record before answering).
Post-Call Integration Nodes	Executed after the call ends (e.g. logging call results into a ticketing system).

What Integration Nodes DoIntegration nodes encapsulate tasks such as:

Category	Examples	Tasks
CRM operations	Salesforce, HubSpot, Pipedrive…	Create or update records, attach call results, sync contact data.
Helpdesk platforms	Zendesk, Freshdesk…	Create tickets, update statuses, push conversation summaries.
Booking engines	Calendly, Cloudbeds, Shore…	Check availability, create reservations, cancel or modify bookings.
Search & data services	Algolia, Elasticsearch…	Query product/catalog data, validate inputs, or retrieve structured info.
Payments & billing	Stripe, Paystack…	Check payment status, initiate a payment link workflow, validate customer identity.
Custom Integrations	Any configured integration	Any integration you configure in the Integration Manager becomes available here as a dedicated node.

How They Work

Feature	Description
Secure Credentials	The Integration Manager stores credentials securely (API keys, tokens, IDs…).
Available as Node	Once connected, each service becomes available as a node in the flow.
Simple Configuration	The node exposes only the required parameters, no API documentation or coding needed.
Data Mapping	Returned 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

Together AI

Twilio

Typeform

Vercel

Vonage

Wasabi

Weaviate

WooCommerce

WordPress

Wufoo

Yourls

Zulip

End Call & Post‑Call Nodes

End Call nodeThis node closes the conversation gracefully (e.g. “Thanks for your time, goodbye.”). It is typically the last in‑call node.

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.

Node Structure

Each node shares a common structure:

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.

Bottom tools

At the bottom of the canva you’ll find:

Tool	Description
Add node buttons	Create new nodes manually (Pre-Call, In-Call, or Post-Call nodes), browse and search node types, and insert nodes directly into the flow.
General Instructions	Opens 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.
Search	Search across all nodes by name or content and jump directly to the node you need.

Configure your Pearl’s identity, knowledge, and behavior settings.

Agent Customization

Set your agent’s name, language, voice, personality, and timezone.

Agent Knowledge Base

Give Pearl the company context and knowledge it needs to answer accurately.

Analytics

Define success, apply indicator tags, and track your Pearl’s performance.

Overview

What is PearlVibe?

What can you build with PearlVibe?

Key benefits

How PearlVibe Is Structured

Header

Chat Sidebar

Central Canvas

Top Navigation tabs

Agent Customization

Agent Knowledge Base

Analytics

​Overview

​What is PearlVibe?

​What can you build with PearlVibe?

​Key benefits

​How PearlVibe Is Structured

​Header

​Chat Sidebar

​Central Canvas

​Top Navigation tabs

Agent Customization

Agent Knowledge Base

Analytics

Overview

What is PearlVibe?

What can you build with PearlVibe?

Key benefits

How PearlVibe Is Structured

Header

Chat Sidebar

Central Canvas

Top Navigation tabs