Calls

Introduction

A call is a single phone conversation between an AI assistant and a lead. Kejue allows you to create calls programmatically for existing leads or create new leads on-the-fly.

What is a Call?

When you create a call, Kejue:

Connects an AI assistant to a lead's phone number
Handles the conversation using natural language processing
Records the call, generates transcripts and summaries
Triggers webhooks when the call completes
Optionally schedules callbacks if the lead doesn't answer

When to Use Individual Calls

Use individual calls when:

You need to call a single lead immediately
Each call requires unique configuration
You're responding to real-time events or user actions
You want precise control over call timing and settings

When to Use Campaigns Instead

If you need to call multiple leads (2-10,000) with similar settings, consider using campaigns instead. Campaigns allow you to batch process leads efficiently.

To configure your calls, you'll need to understand these concepts:

Assistants - Configure which AI assistant handles your calls
Call Scheduling - Control when calls are made
Day Selection - Choose which days calls can be made
Phone Assignment - Control which phone numbers are used
Callbacks - Set up automatic retry logic
Call Context - Provide additional information to assistants
Leads - Configure lead properties and information

API Reference

Create Call - Full API documentation for creating calls

Quick Start

Here's a simple example of creating a call:

{
  "lead_id": 123,
  "call": {
    "assistant_group_id": "grp_abc123",
    "call_start_hour": 9,
    "call_end_hour": 17,
    "phone_assignment_mode": "local"
  }
}

Or create a call with a new lead:

{
  "lead": {
    "phone_number": "+15551234567",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "country": "US",
    "language": "english"
  },
  "call": {
    "assistant_group_id": "grp_abc123",
    "schedule_at": "2024-01-15T14:30:00Z",
    "context": "Customer is interested in premium features"
  }
}

Next Steps

Learn about creating campaigns for batch processing
Set up webhooks to receive call completion notifications
Explore assistant configuration options

On this page