Newbula Documentation

Everything you need to build powerful AI-driven communication solutions

View latest updates in our Changelog →

Overview

Newbula is a comprehensive AI platform that revolutionizes business communication through intelligent voice technology, advanced analytics, and automated workflows. Our platform combines cutting-edge AI capabilities with intuitive tools to help businesses scale their operations efficiently.

Key Capabilities

  • AI-powered voice calling with zero downtime
  • Intelligent lead qualification and scoring
  • Medical Loss Ratio (MLR) risk assessment
  • Cross-platform analytics and insights

Technology Stack

  • Next.js 14 with TypeScript
  • Prisma ORM with PostgreSQL
  • Vapi.ai for voice interactions
  • OpenAI for conversation intelligence

Getting Started

Quick Start Guide

# 1. Sign up for a Newbula account
# Visit newbula.ai and click "Sign Up"

# 2. Create your organization
# Set up your team and configure permissions

# 3. Create your first voice agent
# Navigate to Dashboard > Agents > New Agent

# 4. Configure your agent settings
{
  "name": "Sales Assistant",
  "type": "OUTBOUND",
  "purpose": "MARKETING",
  "phoneNumberId": "your-phone-id",
  "assistantId": "your-assistant-id"
}

# 5. Start making calls
# Upload contacts and initiate your campaign

Authentication

Newbula uses secure OAuth 2.0 authentication. You can sign in using Google or create an account with email and password.

Note: API keys are managed per voice agent for enhanced security. Each agent has its own Vapi API key.

Features

AI Voice Calling

Our AI voice calling system provides zero-downtime communication with intelligent conversation handling.

Outbound Calling

  • • Batch call processing with rate limiting
  • • Concurrent call management
  • • Automatic retry mechanisms
  • • Real-time call monitoring

Inbound Handling

  • • Intelligent call routing
  • • Natural language understanding
  • • Context-aware responses
  • • Call recording and transcription

Example: Starting a Batch Call Campaign

POST /api/voice-agent-actions/{agentId}/start-calls

{
  "phoneNumbers": [
    "+1234567890",
    "+0987654321"
  ],
  "concurrencyLimit": 10,
  "retryAttempts": 3
}

Response:
{
  "processId": "proc_123abc",
  "status": "ONGOING",
  "totalNumbers": 2,
  "message": "Outbound process started successfully"
}

Lead Qualification & Analysis

Automatically score and qualify leads based on AI-powered conversation analysis and engagement metrics.

Lead Scoring Criteria

Hot Leads (80-100)

High engagement, positive sentiment, clear buying intent

Warm Leads (50-79)

Moderate interest, needs nurturing, potential opportunity

Cold Leads (0-49)

Low engagement, no immediate interest, long-term prospect

Risk Assessment

Advanced Medical Loss Ratio (MLR) analysis for healthcare organizations with real-time risk scoring.

MLR Analysis Features

  • • Instant MLR calculation from Excel uploads
  • • Color-coded risk visualization
  • • Member-level cost breakdown
  • • Pharmacy and claims data integration
  • • Specialist capitation tracking

Risk Thresholds

0-50%: Low Risk
50-85%: Moderate Risk
85-100%: High Risk
100%+: Critical Risk

AI Analytics

Comprehensive analytics powered by AI to provide actionable insights across all platform operations.

Analytics Capabilities

  • • Call performance metrics and trends
  • • Conversion rate optimization
  • • Sentiment analysis across conversations
  • • Agent performance benchmarking
  • • Custom report generation
  • • Predictive analytics for outcomes
  • • Real-time dashboard updates
  • • Export capabilities for external analysis

API Reference

Voice Agent Endpoints

Create Voice Agent

POST
/api/voice-agents

Creates a new voice agent for your organization.

List Voice Agents

GET
/api/voice-agents

Retrieves all voice agents for your organization.

Start Outbound Calls

POST
/api/voice-agent-actions/{agentId}/start-calls

Initiates batch outbound calls for the specified agent.

Risk Management Endpoints

Upload Risk Assessment File

POST
/api/risk-management/upload

Uploads Excel files for MLR analysis and risk assessment.

Process MLR Data

POST
/api/risk-management/processing/aetna/process-excel

Processes uploaded Aetna Excel files to calculate MLR and generate insights.

Integration Guide

Webhook Configuration

Configure webhooks to receive real-time updates about call events and status changes.

// Webhook payload example
{
  "type": "call.ended",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "callId": "call_123abc",
    "agentId": "agent_456def",
    "phoneNumber": "+1234567890",
    "duration": 180,
    "status": "completed",
    "transcript": "Full conversation transcript...",
    "recordingUrl": "https://recordings.vapi.ai/..."
  }
}

Airtable Integration

Connect your Airtable base to automatically sync contacts and update records based on call outcomes.

Setup Steps:

  1. Create an Airtable API key in your account settings
  2. Identify your Base ID from the Airtable URL
  3. Configure the API key and Base ID in your voice agent settings
  4. Map Airtable fields to call data (phone number, name, etc.)
  5. Test the integration with a sample call

Use Cases

Sales & Marketing

Automate outbound sales calls, qualify leads, and schedule follow-ups based on conversation outcomes.

  • • Cold calling campaigns
  • • Lead nurturing sequences
  • • Appointment scheduling

Healthcare

Patient outreach, appointment reminders, and health plan risk assessment for better care management.

  • • Patient wellness checks
  • • Medication reminders
  • • Insurance verification

Customer Service

Handle inbound support calls, route to appropriate departments, and provide 24/7 assistance.

  • • First-line support
  • • FAQ handling
  • • Ticket creation

Market Research

Conduct automated surveys, gather customer feedback, and analyze sentiment at scale.

  • • Customer satisfaction surveys
  • • Product feedback collection
  • • Brand perception studies

Frequently Asked Questions

How many concurrent calls can I make?

The default concurrency limit is 10 calls per voice agent. This can be adjusted based on your plan and requirements. Enterprise customers can request higher limits by contacting support.

Are call recordings stored securely?

Yes, all call recordings are encrypted and stored securely using industry-standard encryption. Access is restricted based on user permissions and recordings are retained according to your configured retention policy.

Can I customize the AI assistant's voice and personality?

Absolutely! You can customize the voice, tone, speaking pace, and conversation style of your AI assistant. This is configured through the Vapi.ai assistant settings when creating or updating a voice agent.

What file formats are supported for risk assessment?

Currently, we support Excel files (.xlsx, .xls) for risk assessment uploads. The files should contain member data with columns for dates, medical costs, pharmacy costs, and member information.

How do I integrate with my existing CRM?

Newbula provides webhook endpoints that can be integrated with any CRM system. You can also use our Airtable integration as a bridge to sync data with other platforms. For custom integrations, our API documentation provides all necessary endpoints.

Ready to get started?

Transform your business communication with Newbula's AI platform today.

Start Free TrialContact Sales