# Cal.com Appointment Scheduling Source: https://docs.kalimna.ai/ai-assistants/cal-com-scheduling Learn how to enable your AI assistant to schedule appointments using Cal.com integration Enable your AI assistant to seamlessly schedule meetings and appointments using Cal.com integration. This powerful feature allows your AI to check availability and book meetings directly during calls. Do not make any new fields required in your Cal.com event settings. The integration only supports default fields and the optional phone field. Adding required custom fields will cause the integration to fail. ## Prerequisites Before setting up Cal.com integration, you'll need: * A Cal.com account (either hosted or self-hosted) * An event type configured in Cal.com * An API key from Cal.com ## Setup Process ### 1. Cal.com Configuration 1. Sign up or log in to your [Cal.com](https://cal.com/) account 2. Create a new event type specifically for AI assistant bookings * Give it a clear name like "Meeting with AI Assistant" * Configure duration, availability, and other settings 3. Once created, note down the event ID from the URL 4. Generate an API key: * Go to Cal.com settings * Navigate to Developer Settings * Create a new API key * Copy and securely store the API key ### 2. Customer Contact Information #### Email Configuration To send calendar invites to customers: 1. Define `email` in your assistant's input variables 2. Pass the customer's email as the `email` variable when creating the lead 3. The system will automatically use this email for calendar invitations #### Phone Number in Calendar Events To include the caller's phone number in calendar events: 1. Go to your event settings in Cal.com 2. Click on "Add a question" 3. Configure the field with these exact values: * Identifier: `phone` (this must be exact) 4. Save your changes ### 3. Adding Cal.com to Your Assistant 1. In your AI assistant settings, locate the Tools section 2. Add the Cal.com integration 3. Configure the tool with: * Your Cal.com API key * The event type ID ## Best Practices * Create dedicated event types for AI bookings to track their usage * Set clear buffer times between meetings * Configure appropriate meeting durations * Use descriptive event names that make sense to your customers * Keep only default fields and the phone field optional * Always include customer email in lead creation for calendar invites ## Testing After setup, we recommend: 1. Making a test call to your AI assistant 2. Requesting to schedule a meeting 3. Verifying the booking appears in your Cal.com dashboard 4. Checking that the phone number appears in the calendar event 5. Verifying the customer receives the calendar invitation email 6. Checking the confirmation emails are received ## Troubleshooting If you encounter issues: * Verify your API key is active and has the correct permissions * Ensure the event type ID is correct * Check that your Cal.com availability is properly configured * Confirm no required custom fields are added * Verify the phone field identifier is exactly "phone" * Confirm the `email` variable is properly set in assistant settings * Check that customer email is being passed correctly in leads * Confirm your timezone settings are correct # Creating and Editing an AI Assistant Source: https://docs.kalimna.ai/ai-assistants/creating-and-editing Step-by-step guide on how to create, configure, and modify your AI assistants for both inbound and outbound calls Ready to set up your first AI assistant? Follow these steps: ## 1. Go to "Assistants" In your Kalimna.ai dashboard, find the **Assistants** page (sometimes labeled "AI Assistants" or similar). ## 2. Click "Create New Assistant" * Choose **Inbound** if you want it to answer incoming calls. * Choose **Outbound** if it's for campaigns calling out to leads/customers. ## 3. Fill Out Basic Info * **Assistant Name**: Internal label, e.g. "Support Bot" or "Sales Bot." * **System Prompt**: Outline the assistant's role, tone, and key instructions. * **Initial Message**: The first line the AI will speak (inbound calls usually need a quick greeting). ## 4. Language & Voice * Select a **Voice** from the built-in library, or pick a cloned voice if you've created one. * (Optional) Configure speech speed, filler usage, or "voice activity detection" if you need specialized settings. ## 5. Tools & Functions * Add or remove items like **transfer call**, **end call**, or **appointment scheduling** (more in [Tools & Functions](/ai-assistants/tools-and-functions)). ## 6. Save & Test * Click **Save** and your assistant is ready! * For inbound, you'll need to assign a phone number. * For outbound, attach the assistant to a campaign or test with your own phone number. ## Editing an Assistant * Return to **Assistants** in the dashboard. * Click on the assistant name. * Adjust prompts, voice, or add new tools—then **Save**. *** **Tip:** Always test your changes by calling the assistant or running a small outbound campaign to confirm it behaves as expected. # Filler Audio Source: https://docs.kalimna.ai/ai-assistants/filler-audio Learn how to use filler audio to create more natural conversations with your AI assistant Filler audio adds natural conversation sounds (like "hmm" or "one moment") while your AI assistant processes responses. This creates a more human-like interaction by eliminating awkward silences. ## How It Works When enabled, your AI assistant will: * Use short audio fillers during processing time * Maintain engagement while formulating responses * Signal active listening to the caller ## Benefits 1. **Improved Conversation Flow** * Eliminates dead air * Keeps callers engaged * Reduces hang-ups * Creates natural dialogue rhythm 2. **Enhanced User Experience** * More human-like interaction * Less awkward waiting * Better caller retention * Increased trust ## Setup 1. Go to your AI assistant settings 2. Find the "Filler Audio" option 3. Toggle it on 4. Save your changes ## Best Practices ### Combine with Fast Engine * Use filler audio with the Fast Engine setting * Creates the most natural conversation flow * Minimizes perceived response time ### Use Cases * **Sales Calls**: Keep prospects engaged * **Customer Service**: Show active listening * **Lead Qualification**: Maintain natural flow ## Testing After enabling filler audio: 1. Make a test call 2. Listen for natural transition sounds 3. Verify timing and appropriateness 4. Adjust if needed *** **Tip:** Start with filler audio enabled - you can always disable it if it doesn't suit your use case. # Initial Message & Audio Source: https://docs.kalimna.ai/ai-assistants/initial-message Learn how to create effective initial messages and use custom audio files for the best first impression The first few seconds of a call are crucial - they determine whether the customer stays on the line. You have two options for your assistant's first greeting: text-based initial message or custom initial audio. ## Initial Message This is the first thing your AI assistant says when starting a call. The message is read exactly as written, so: ### Best Practices 1. **Keep it Short** * Aim for 5-10 seconds * Get to the point quickly * Avoid long company introductions 2. **Write Exactly as Needed** * Include proper diacritics (é, ñ, ü, etc.) * Use punctuation for proper pausing * Write numbers as they should be spoken 3. **Example Formats** ``` Good: "Hi! This is Sarah from ABC Company. How can I help you today?" Better with pausing: "Hi! This is Sarah from ABC Company... How can I help you today?" With diacritics: "¡Hola! Soy María de ABC Company. ¿Cómo puedo ayudarte?" ``` ## Initial Audio For the best first impression, you can use a pre-recorded audio file: ### Benefits * Professional quality * Perfect pronunciation * Human warmth * Consistent delivery * Higher customer retention ### Setup Process 1. Record your greeting with a professional voice actor 2. Upload the audio file in assistant settings 3. Clone the same voice for the rest of the conversation 4. Enable initial audio playback ### Best Practices 1. **Recording Quality** * Use professional equipment * Record in a quiet environment * Maintain consistent volume * Save in high quality format 2. **Voice Matching** * Use the same voice actor for cloning * Maintain consistent tone and style * Match energy levels 3. **Content Guidelines** * Keep under 10 seconds * Include company name * State purpose clearly * Sound welcoming ### Example Script Structure ``` [Greeting] + [Company Name] + [Purpose/Question] "Hello! This is ABC Company calling about your recent inquiry. How are you today?" ``` ## Combining Both Methods You can set up both: * Initial audio as primary greeting * Initial message as backup * System will use audio when available ## Testing Before going live: 1. Call your assistant 2. Listen for: * Clear pronunciation * Natural pauses * Proper volume * Smooth transition to AI conversation ## Language Considerations * Each language needs its own initial message/audio * Use native speakers for recordings * Consider regional accents * Test with target audience *** **Pro Tip:** Record several versions of your initial audio and test which one gets better response rates. # System Prompts Source: https://docs.kalimna.ai/ai-assistants/system-prompt Learn how to create effective system prompts - the core intelligence of your AI assistant The system prompt is the most crucial component of your AI assistant. It defines your assistant's personality, behavior, knowledge, and capabilities. Think of it as the "brain" and "training manual" combined. ## Quick Start with Templates To get started quickly: 1. Go to your assistant settings 2. Find the system prompt field 3. Click the "Templates" button nearby 4. Choose a template that matches your use case 5. Customize it for your needs ## Language Support Your system prompt can be written in any language, regardless of the spoken language setting: * Write the prompt in your preferred language * Set the spoken language separately in assistant settings * The AI will follow the prompt's instructions while speaking in the selected language For example: * System prompt in English, spoken language set to Spanish * System prompt in German, spoken language set to French * System prompt in Chinese, spoken language set to English ## Why They Matter Your system prompt: * Shapes how the AI thinks and responds * Defines conversation boundaries * Provides essential knowledge * Controls behavior and tone * Determines handling of edge cases ## Key Components A good system prompt should include: ### 1. Role & Identity ``` You are a professional sales representative for [Company]. You specialize in [Product/Service] and have extensive knowledge of our offerings. ``` ### 2. Conversation Style ``` Maintain a friendly, professional tone. Use clear, concise language. Avoid technical jargon unless specifically asked. ``` ### 3. Key Information ``` Our main products are: - Product A ($X/month): [features] - Product B ($Y/month): [features] Current promotion: 20% off first 3 months ``` ### 4. Behavioral Guidelines ``` - Always verify customer information before discussing account details - Transfer to a human agent if the customer seems frustrated - Don't make promises about delivery dates ``` ### 5. Response Framework ``` When asked about pricing: 1. First understand their needs 2. Present relevant package options 3. Explain the value proposition 4. Share any applicable discounts ``` ## Best Practices 1. **Be Specific** * Clear instructions get better results * Include examples of good responses * Define what NOT to do 2. **Structure Matters** * Organize information logically * Use bullet points and sections * Keep related information together 3. **Test and Iterate** * Start with a basic prompt * Test various scenarios * Refine based on call recordings * Add handling for edge cases ## Common Mistakes * **Too Vague**: "Be helpful and professional" (Not specific enough) * **Too Rigid**: Scripting every possible response (Reduces natural flow) * **Information Overload**: Including unnecessary details * **Missing Guidelines**: Not specifying how to handle common situations ## Example Structure ``` # Role and Purpose [Define who the AI is and its main goals] # Core Knowledge [Essential information about products/services] # Conversation Guidelines [How to interact with customers] # Response Patterns [How to handle specific situations] # Limitations and Boundaries [What the AI should NOT do] ``` ## Testing Your Prompt 1. Make test calls covering: * Common scenarios * Edge cases * Difficult situations * Various customer personalities 2. Review and adjust: * Listen to call recordings * Check response accuracy * Verify tone consistency * Test knowledge retention ## Optimization Tips * Start with Fast Engine for quick iterations * Use call recordings to identify gaps * Add examples of good/bad responses * Include handling for unexpected questions *** **Pro Tip:** Your system prompt is a living document - regularly update it based on actual call experiences and customer interactions. # Testing Your Assistant Source: https://docs.kalimna.ai/ai-assistants/testing Learn how to quickly test your AI assistant for both inbound and outbound calls There are two ways to test your AI assistant, depending on whether you want to test inbound or outbound functionality. ## Testing Outbound Calls The fastest way to test your assistant's outbound capabilities: 1. Go to your assistant's settings 2. Find the "Make test call" purple button 3. Enter your phone number 4. Click to initiate the test 5. You'll receive a call from your AI assistant immediately ## Testing Inbound Calls To test how your assistant handles incoming calls: 1. Make sure you have a phone number assigned to your assistant 2. Call that number from any phone 3. Your AI assistant will answer and handle the call *** **Tip:** Save your AI's phone number in your contacts to easily make inbound test calls whenever needed. # Tools & Functions Source: https://docs.kalimna.ai/ai-assistants/tools-and-functions Explore the built-in tools and functions that enhance your AI assistant's capabilities during calls Kalimna.ai offers built-in "tools" that your AI assistant can use during a call. These help you shape the conversation flow and automate actions like transferring calls or scheduling appointments. ## 1. End Call Tool * **Purpose**: Tells the AI to politely wrap up the conversation. * **How It Works**: You can specify in the system prompt or logic, for instance: "If the user says `goodbye`, end the call." * **Configuration**: In the assistant's settings, you can define any conditions that should trigger the end call. ## 2. Transfer Tool * **Purpose**: Moves the caller from the AI assistant to a human agent or external phone number. * **Use Cases**: Warm leads on a sales call, escalations on a support call, etc. * **Settings**: In the assistant's config, add the phone number or department the call should go to, and optionally a short hold message. ## 3. Appointment Scheduler * **Purpose**: Lets the AI check your calendar availability (e.g. via Cal.com or Google Calendar) and book an appointment. * **Typical Flow**: 1. AI offers scheduling. 2. Caller selects date/time. 3. AI confirms and sends a confirmation (using email or SMS if configured). ## 4. No-Code Automation Platform * **Purpose**: After or during calls, the AI can trigger actions in the automation platform (like updating a CRM, sending an email, or logging results in Google Sheets). * **Setup**: Link your assistant with the "Automation" tab, choose triggers ("Call Ended," "Customer Agrees," etc.), and pick the action (send a Slack notification or add a row in Sheets). *** **Note:** Tools can be combined. For instance, the AI can schedule an appointment, then if the caller wants more info, it can transfer them to a human agent. # Voice Selection & Voice Cloning Source: https://docs.kalimna.ai/ai-assistants/voice-selection Learn how to select built-in voices or clone your own voice for your AI assistants Your AI assistant can speak with **built-in voices** or a **custom cloned voice**. Natural, realistic voices increase customer trust and engagement. ## 1. Built-In Voice Library * **Powered by**: ElevenLabs. * **Selection**: Choose male/female, accent, or language from our default list. * **Customization**: Adjust pitch, speed, or filler usage if desired. ## 2. Cloning Your Own Voice * **Why Clone?**: For brand consistency or a familiar voice to your audience. * **Audio Sample Requirements**: Provide a clear audio recording (usually 1–5 minutes). * **Process**: 1. Record yourself reading a script (no background noise). 2. Upload it in the "Clone Voice" section. 3. Wait for training to complete (could be minutes or hours). 4. Test the new voice with small sample texts. ## 3. Best Practices 1. **High-Quality Audio**: The clearer your sample, the better the cloned result. 2. **Steady Delivery**: Speak in a natural tone, avoid abrupt changes. 3. **Check for Legal**: Ensure you have permission to clone any voice if it's not yours. *** **Tip:** After selecting or cloning a voice, always do a quick test call to confirm it sounds as expected. # What is an AI Assistant? Source: https://docs.kalimna.ai/ai-assistants/what-is-ai-assistant Understand what an AI Assistant is, its key components, and how it can help automate your phone interactions An **AI Assistant** (sometimes called an agent) is your configurable bot that speaks with customers or leads over the phone—either when they call you (**inbound**) or when your system calls them (**outbound**). ## Why Use an AI Assistant? * **Automate Common Interactions**: Answer FAQs, book appointments, or qualify leads 24/7. * **Reduce Workload**: Free your human team from repetitive tasks like verifying contact info or taking messages. * **Scalable**: One assistant can handle many calls in parallel, allowing you to grow without adding more agents. ## Key Components 1. **System Prompt**: The core instructions guiding how your assistant behaves. 2. **Initial Message**: The very first phrase the AI says (especially critical for inbound calls). 3. **Voice Settings**: Choose a built-in voice or clone your own. 4. **Tools** (Optional): Transfer, end call, scheduling, and more. *** **Next Steps** * Learn how to [Create and Edit an AI Assistant](/ai-assistants/creating-and-editing). * Explore the various [Tools & Functions](/ai-assistants/tools-and-functions) you can add to your assistant. # Authentication Source: https://docs.kalimna.ai/api-reference/authentication Learn how to authenticate your API requests The Kalimna API uses API keys to authenticate requests. You need to include your API key in the header of each request you make to the API. ## Obtaining an API Key To obtain an API key: 1. Log in to your Kalimna account at [https://app.kalimna.ai](https://app.kalimna.ai) 2. Navigate to the "API Keys" page 3. Click on the "Create new API Key" button 4. Copy your new API key and store it securely Keep your API key confidential and secure. Do not share it publicly or commit it to version control systems. ## Using the API Key Include your API key in the `Authorization` header of each request: ``` Authorization: Bearer YOUR_API_KEY ``` Replace `YOUR_API_KEY` with your actual API key. ## Example Request Here's an example of how to include the API key in a cURL request: ```bash theme={null} curl -X GET "https://api.kalimna.ai/api/user/campaigns" \ -H "Authorization: Bearer YOUR_API_KEY" ``` Replace `YOUR_API_KEY` with your actual API key when making requests. # List campaigns Source: https://docs.kalimna.ai/api-reference/campaigns/index GET /user/campaigns List all campaigns This endpoint allows you to list all campaigns. ### Response fields The id of the campaign The name of the campaign The created at date of the campaign The updated at date of the campaign The status of the campaign # Introduction Source: https://docs.kalimna.ai/api-reference/introduction Welcome to the Kalimna.ai API Welcome to the Kalimna API documentation. Our API allows you to programmatically interact with the Kalimna platform, enabling you to create and manage leads, schedule calls, and more. ## Base URL All API requests should be made to the following base URL: ``` https://app.kalimna.ai/api ``` # Create lead Source: https://docs.kalimna.ai/api-reference/leads/create POST /user/lead Create a new lead in the Kalimna system This endpoint allows you to create a new lead in the Kalimna system. ### Request body The phone number of the lead in E.164 format (e.g. +1234567890) The ID of the campaign to create the lead for The variables to pass to the lead Whether to allow duplicate leads in a campaign. ### Response fields The message of the response The data of the response The id of the lead ```json Request theme={null} { "phone_number": "+1234567890", "campaign_id": 1, "variables": [ { "customer_name": "John Doe", "email": "john.doe@example.com" } ], "allow_dupplicate": false } ``` ```json 200 Response theme={null} { "message": "Lead created successfully", "data": { "id": "1234569" } } ``` # Building Flows Source: https://docs.kalimna.ai/automation-platform/building-flows Flow consists of two parts, trigger and actions ## Trigger The flow's starting point determines its frequency of execution. There are various types of triggers available, such as Schedule Trigger, Webhook Trigger, or Event Trigger based on specific service. ## Action Actions come after the flow and control what occurs when the flow is activated, like running code or communicating with other services. In real-life scenario: Flow Parts # Common Integrations Source: https://docs.kalimna.ai/automation-platform/calls-related/common-integrations Explore popular integrations with Google Sheets, calendars, CRMs, and notification tools Below are some popular tools you can connect to Kalimna.ai using the built-in no-code platform or direct integrations: ## 1. Google Sheets * **Import Leads**: Poll a sheet of phone numbers for an outbound campaign. * **Log Call Results**: Append transcripts or call summaries to a "Call History" sheet. ## 2. Calendars (Cal.com, Google Calendar, etc.) * **Appointment Scheduling**: The AI can suggest free slots, then create events. * **Reminders**: If a call is about an upcoming appointment, the AI can confirm or reschedule. ## 3. HubSpot / CRMs * **Lead Data**: Post-call info can be saved to a contact record. * **Status Updates**: Change lead status to "Interested" or "Requires Follow-Up" automatically. ## 4. Slack / Email Notifications * **Immediate Alerts**: If a user says "I want to cancel" or "I want to buy," trigger a Slack ping. * **Daily Summary**: Email your team a daily summary of calls, outcomes, and new leads. ## 5. Others (Facebook Leads, etc.) * Some advanced users integrate with Facebook Lead Ads or other marketing platforms to feed real-time leads into an Kalimna.ai outbound campaign. *** **Tip:** In the Kalimna.ai automation editor, you'll see pre-built blocks for many popular tools. If something's missing, you can often use **Webhooks** or the **API** to connect. # Sending SMS Source: https://docs.kalimna.ai/automation-platform/calls-related/sms-capabilities Learn how to send SMS messages using the automation platform and SMS-capable numbers If your rented or custom-provisioned number supports SMS capabilities, you can leverage the automation platform to send text messages: ## 1. SMS Actions * Send confirmation messages after calls * Deliver follow-up information or links * Send appointment reminders * Provide quick updates or notifications ## 2. Configuration 1. Ensure your phone number is SMS-capable 2. Use the "Send SMS" action in your automation flow 3. Configure message template and variables 4. Set up triggers (e.g., after call completion) ## 3. Best Practices * Keep messages concise and professional * Include opt-out instructions if required by local laws * Test SMS delivery before large campaigns * Monitor delivery rates and costs *** **Note:** SMS capability depends on your phone number's region and type. Contact support to confirm if your number supports texting. # Debugging Runs Source: https://docs.kalimna.ai/automation-platform/debugging-runs Ensuring your business automations are running properly You can monitor each run that results from an enabled flow: 1. Go to the Dashboard, click on **Runs**. 2. Find the run that you're looking for, and click on it. 3. You will see the builder in a view-only mode, each step will show a ✅ or a ❌ to indicate its execution status. 4. Click on any of these steps, you will see the **input** and **output** in the **Run Details** panel. The debugging experience looks like this: Debugging Business Automations # Introduction Source: https://docs.kalimna.ai/automation-platform/introduction Learn How to Automate Your AI Call Workflows with Kalimna # Automation Platform The Kalimna Automation Platform helps you create powerful AI call automation workflows without coding. Build flows that enhance your AI calling system by processing variables before calls, handling post-call actions, and creating seamless integrations with your existing tools. Flow Builder ## Key Features ### AI Call-Based Triggers 1. **Call Ended Trigger** * Activates immediately when an AI call completes * Access full conversation transcript and AI responses * Use call duration, status, and detailed metadata * Perfect for post-call automation like CRM updates * Trigger follow-up actions based on call outcomes 2. **Inbound Call Variable Injection** * Triggers before AI assistant picks up the call * Enriches AI context with real-time customer data * Customizes AI behavior based on caller information * Returns variables that get injected into AI prompts * Enables personalized conversation flows ### Essential Actions 1. **Hubspot Integration** * Update contact records with call outcomes * Create new contacts from inbound calls * Sync conversation insights to CRM * Track AI interaction history * Automate lead qualification 2. **Campaign Management** * Add qualified leads to AI calling campaigns * Schedule AI follow-up calls * Manage call priorities based on outcomes * Track conversion rates per campaign * Automate campaign assignments 3. **External Systems** * Send post-call summary emails * Update spreadsheets with call data * Trigger webhooks for custom integrations * Connect with your business tools * Automate multi-step workflows ## How It Works 1. **Choose Your Call Trigger** * "Call Ended" for post-conversation automation * "Inbound Call" for real-time AI context injection 2. **Configure Call Variables** * Map AI conversation data and transcripts * Access caller details and history * Define AI routing logic * Set up custom conversation variables 3. **Add Smart Actions** * Update CRM with call outcomes * Send automated notifications * Schedule follow-up activities * Return enriched context to AI ## Example Use Cases ### Intelligent CRM Update ```javascript theme={null} Trigger: AI Call Ended ↓ Process Conversation Insights ↓ Update Hubspot Contact ↓ Schedule Next AI Interaction ``` ### Smart Inbound Call Handling ```javascript theme={null} Trigger: Inbound Call to AI ↓ Lookup Customer in Hubspot ↓ Return Enriched Context ↓ AI Assistant Personalizes Conversation ``` # Technical limits Source: https://docs.kalimna.ai/automation-platform/known-limits Technical limits for flows execution ### Overview ### Flow Limits * **Execution Time**: Each flow has a maximum execution time of **600 seconds (10 minutes)**. Flows exceeding this limit will be marked as a timeout. * **Memory Usage**: During execution, a flow should not use more than **128 MB of RAM**. ### File Storage Limits * **Maximum File Size**: 10 MB ### Data Storage Limits Some pieces utilize the built-in key store, such as the Store Piece and Queue Piece. The storage limits are as follows: * **Maximum Key Length**: 128 characters * **Maximum Value Size**: 512 KB # Passing Data Source: https://docs.kalimna.ai/automation-platform/passing-data Using data from previous steps in the current one ## Data flow Any flow is a vertical diagram that **starts with a trigger step** followed by **any number of action steps**. Steps are connected vertically. Data flows from parent steps to the children. Children steps have access to the output data of the parent steps. ## Example Steps This flow has 3 steps, they can access data as follows: * **Step 1** is the main data producer to be used in the next steps. Data produced by Step 1 will be accessible in Steps 2 and 3. Some triggers don't produce data though, like Schedules. * **Step 2** can access data produced by Step 1. After execution, this step will also produce data to be used in the next step(s). * **Step 3** can access data produced by Steps 1 and 2 as they're its parent steps. This step can produce data but since it's the last step in the flow, it can't be used by other ones. ## Data to Insert Panel In order to use data from a previous step in your current step, place your cursor in any input, the **Data to Insert** panel will pop up. This panel shows the accessible steps and their data. You can expand the data items to view their content, and you can click the items to insert them in your current settings input. If an item in this panel has a caret (⌄) to the right, it means you can click on the item to expand its child properties. You can select the parent item or its properties as you need. When you insert data from this panel, it gets inserted at the cursor's position in the input. This means you can combine static text and dynamic data in any field. We generally recommend that you expand the items before inserting them to understand the type of data they contain and whether they're the right fit to the input you're filling. ## Testing Steps to Generate Data We require you to test steps before accessing their data. This approach protects you from selecting the wrong data and breaking your flows after publishing them. If a step is not tested and you try to access its data, you will see the following message: To fix this, go to the step and use the Generate Sample Data panel to test it. Steps use different approaches for testing. These are the common ones: * **Load Data:** Some triggers will let you load data from your connected account without having to perform any action in that account. * **Test Trigger:** Some triggers will require you to head to your connected account and fire the trigger in order to generate sample data. * **Send Data:** Webhooks require you to send a sample request to the webhook URL to generate sample data. * **Test Action:** Action steps will let you run the action in order to generate sample data. Follow the instructions in the Generate Sample Data panel to know how your step should be tested. Some triggers will also let you Use Mock Data, which will generate static sample data from the piece. We recommend that you test the step instead of using mock data. This is an example for generating sample data for a trigger using the **Load Data** button: ## Advanced Tips ### Switching to Dynamic Values Dropdowns and some other input types don't let you select data from previous steps. If you'd like to bypass this and use data from previous steps instead, switch the input into a dynamic one using this button: ### Accessing data by path If you can't find the data you're looking for in the **Data to Insert** panel but you'd like to use it, you can write a JSON path instead. Use the following syntax to write JSON paths: `{{step_slug.path.to.property}}` The `step_slug` can be found by moving your cursor over any of your flow steps, it will show to the right of the step. # Publishing Flows Source: https://docs.kalimna.ai/automation-platform/publishing-flows Make your flow work by publishing your updates The changes you make won't work right away to avoid disrupting the flow that's already published. To enable your changes, simply click on the publish button once you're done with your changes. Flow Parts # Inbound Call Context Injection Source: https://docs.kalimna.ai/automation-platform/tutorials/inbound-context-injection Learn how to enrich your AI assistant with real-time customer data # Inbound Call Context Injection This tutorial demonstrates how to enhance your AI assistant's conversations by injecting real-time context before the call connects. ## What You'll Learn * Setting up the Inbound Call trigger * Fetching lates product data from WooCommerce * Structuring context for the AI ## Prerequisites * Kalimna account with inbound numbers * WooCommerce integration * AI assistant configured for context injection # Outbound Call on Form Submission Source: https://docs.kalimna.ai/automation-platform/tutorials/outbound-form-call Learn how to trigger AI calls when customers submit a form # Version History Source: https://docs.kalimna.ai/automation-platform/versioning Learn how flow versioning works in Kalimna.ai Kalimna.ai keeps track of all published flows and their versions. Here’s how it works: 1. You can edit a flow as many times as you want in **draft** mode. 2. Once you're done with your changes, you can publish it. 3. The published flow will be **immutable** and cannot be edited. 4. If you try to edit a published flow, Kalimna.ai will create a new **draft** if there is none and copy the **published** version to the new version. This means you can always go back to a previous version and edit the flow in draft mode without affecting the published version. Flow History As you can see in the following screenshot, the yellow dot refers to DRAFT and the green dot refers to PUBLISHED. # Overview of No-Code Automation Source: https://docs.kalimna.ai/automation/overview Learn about Kalimna.ai's built-in automation engine for creating workflows without coding This is a brief overview of our automation capabilities. For in-depth documentation, tutorials, and advanced features, visit our dedicated [Automation Platform Documentation](/automation-platform/introduction). Kalimna.ai includes an internal automation engine (similar to Zapier or Make) that lets you build flows—no coding required. For instance: 1. **Trigger**: A call ends. 2. **Action**: A Slack notification is sent with call outcome and transcript. ## Key Concepts * **Triggers**: Events inside Kalimna.ai (e.g., "call ended," "inbound call context injection"). * **Actions**: Steps that happen in response (e.g., "send email," "update Google Sheets," "webhook to CRM"). ## Common Use Cases * **Post-Call Data Handling**: Log transcripts in a database or notify your team of new leads. * **Lead Import**: Automatically fetch new leads from a Google Sheet or CRM into an outbound campaign. * **Appointment Scheduling**: Once a caller confirms a time with the AI, you create or update a calendar event. ## Setting Up a Workflow 1. Go to **Automations** in your dashboard. 2. Click **Create Workflow**. 3. Pick a **trigger** (like "Call Ended") and select the **assistant**. 4. Add **actions** (like "Send Email to Team," "Add Row in Sheets," etc.). 5. Test and monitor logs to ensure everything runs smoothly. *** **Tip:** Keep your workflows simple at first. Complex logic is possible, but it's best to start with a single trigger → single action until you get comfortable. **Want to learn more?** Check out our [detailed automation documentation](/automation-platform/introduction) for advanced features, tutorials, and best practices. # Webhook & API Source: https://docs.kalimna.ai/automation/webhook-api Learn how to use webhooks and the REST API for custom integrations and automation If you want deeper customization beyond no-code blocks, Kalimna.ai supports **webhooks** and a **REST API**. ## 1. Webhooks * **When to Use**: Trigger events in external systems the moment something happens in Kalimna.ai (e.g., "Call Ended,"). * **Configuration**: Set a webhook URL in your assistant/campaign settings or the automation platform. * **Payload**: Typically includes call ID, transcript, call outcome, or any user data collected. ## 2. REST API * **Key Functions**: 1. **Create/Update Leads** 2. **Manage Campaigns** * **Auth & Rate Limits**: Usually uses API tokens. Check [API docs](/api-reference/introduction) for details on endpoints and usage quotas. ## 3. Example Use Cases * **Real-Time CRM Sync**: For each new call, post data to your CRM's endpoint. * **Custom Dashboards**: Pull call data into your own analytics dashboard. *** **Note:** You'll find the official API reference in a dedicated docs section or via your Kalimna.ai dashboard. Always secure your tokens and test endpoints in a dev environment. # Handling Interruptions & Speech Sensitivity Source: https://docs.kalimna.ai/conversation-design/interruptions Configure how your AI assistant handles interruptions, voice activity detection, and speech patterns Phone conversations can be messy—callers may interrupt the AI or have background noise. Kalimna.ai provides **voice activity detection** and **speech settings** to handle these situations. ## 1. Voice Activity Detection (VAD) * **What It Is**: A setting that helps the AI wait for the user to finish talking before responding. * **Configuration**: In the assistant's advanced settings, you can enable or disable VAD. * *High Sensitivity*: AI might interrupt less, but could lead to awkward pauses. * *Low Sensitivity*: AI might talk over the user if they pause mid-sentence. ## 2. Speech Speed & Filler Usage * **Speech Speed**: Some voices allow you to slow down or speed up how quickly the AI talks. * **Filler Usage**: Decide if the AI uses "umm," "uhh," or short "mhm" acknowledgments to sound more natural. ## 3. Interruptions * If a user starts speaking while the AI is talking, the AI can attempt to stop and listen. However, perfect interruption handling can't be guaranteed due to phone audio overlap. * Encourage shorter AI responses in your prompt to reduce collision with the caller's speech. *** **Tip:** Conduct test calls to find the right balance of sensitivity and speed. Overly fast responses or overly long monologues can frustrate callers. # Inserting Knowledge Bases Source: https://docs.kalimna.ai/conversation-design/knowledge-bases Learn how to provide your AI assistant with access to FAQs, documents, and other knowledge sources For more advanced usage, you may want the AI to reference detailed FAQs or documents. Below are current approaches: ## 1. Copy-Paste into Prompt * **Pros**: Quick to set up. * **Cons**: Large texts can slow down responses or risk partial "hallucination." * **Usage**: Useful for short references, like top 10 FAQs. ## 2. Knowledge-Base Feature * Kalimna.ai plans to introduce a dedicated "Knowledge Base" or doc upload feature. * This would let you store PDFs or text docs that the AI can query on demand. * This feature is currently in development and will be available soon. **However, you can contact our support team and send us your documents to manually embed them.** ## 3. Best Practices * Keep info concise, use bullet points. * Separate topics with clear headings so the AI can parse more effectively. * Monitor call transcripts to confirm the AI references your data correctly. *** **Note:** If you have an urgent need for large doc integration, contact our support about possible custom solutions or partial "manual" embeddings. # Language & Accent Support Source: https://docs.kalimna.ai/conversation-design/language-support Explore available languages and accents for your AI assistant, and learn how to request new ones Kalimna.ai offers multiple languages and accents for your AI assistant. Choose from built-in sets or request new ones if needed. ## 1. Available Languages * Arabic * English (various accents: US, UK, Australian, etc.) * Spanish (Latin American, Spain accent) * French, German, Italian * **Others**: +40 languages supported, [play samples here](https://autocalls.ai/#languages-available) ## 2. Requesting a New Language * If your language is missing, contact support. We may add it if feasible. Some might require a one-time fee for model training or verification. ## 3. Accent Tuning * Within a language, you can pick certain accents (like US English vs. British English). * Speed and pitch settings can further localize the sound. ## 4. Testing & Verification * Always run sample calls in your chosen language to ensure recognition is solid. * AI recognition quality can vary; watch transcripts for repeated errors and refine your prompt or speech speed. *** **Note:** Additional fees or wait times might apply for lesser-known languages or custom accent requests. # Prompt Writing Basics Source: https://docs.kalimna.ai/conversation-design/prompt-basics Learn how to write effective system prompts and initial messages for your AI assistants Kalimna.ai uses a **System Prompt** to guide how your AI assistant interacts with callers. Crafting an effective prompt is key to smoother, more accurate phone conversations. ## 1. System Prompt vs. Initial Message * **System Prompt**: Overall instructions and context. Example:\ *"You are the Support Bot for TechMasters Inc. Greet politely, ask for a name, handle basic troubleshooting, and transfer the call if the issue is complex."* * **Initial Message**: The first thing the AI says, especially for inbound. Example:\ *"Thank you for calling TechMasters! How can I assist you today?"* ## 2. Clarity & Structure * **Be Specific**: Outline the main purpose, tone, and steps you want the AI to follow. * **Use Examples**: Show sample dialogues. *"If the user says they have a billing question, ask them for their invoice number."* ## 3. Handling "Unknown" Cases * If a user asks about something off-topic, decide whether the AI should: * Provide a default response: *"I'm not sure, let me transfer you…"* * Gather more details. ## 4. Keep It Short & Focused * A short prompt often works best; too-long instructions can make the AI slower or prone to "hallucination." * If you have lengthy content, consider a knowledge-base or chunk your text with headings. *** **Tip:** Periodically review your transcripts to see where the AI might need more or fewer instructions. # Core Concepts Source: https://docs.kalimna.ai/getting-started/core-concepts Learn the fundamental building blocks of Kalimna.ai, including system prompts, voices, and AI assistants Welcome to the fundamentals of Kalimna.ai. Here, we explore the essential building blocks that you need to understand before configuring your AI assistant and calls. ## 1. System Prompt & Initial Message **System Prompt** * The "brain" of your AI assistant. You write a short (or long) set of instructions that guide the assistant's behavior and tone of voice. * This includes any important business info, disclaimers, or how you want the AI to handle edge cases. * For example: *"You are a helpful phone assistant for XYZ Company, you greet in a friendly manner, confirm the caller's info, etc."* **Initial Message** * The very first thing the AI says. * Typically short, like "Hello, thanks for calling XYZ Company!" ## 2. Voices * Kalimna.ai integrates with **ElevenLabs** voices for natural-sounding speech. * You can **clone** your own voice by providing audio samples or pick from built-in voices. * Each voice can have adjustable parameters like speech speed, filler usage, or accent (if available). ## 3. Putting It All Together * An **AI Assistant** is built by combining a system prompt, an initial message, and a chosen voice. * Optionally, you add tools (like "transfer call" or "end call"). * Once the assistant is set, you assign it to a phone number (for inbound) or a campaign (for outbound). **Next Steps** * Learn how [call minutes and billing](/getting-started/understanding-billing) work to plan your usage. * Or, jump to [AI Assistants Overview](/ai-assistants/what-is-an-ai-assistant) to start building your first assistant. # Understanding Call Minutes & Billing Source: https://docs.kalimna.ai/getting-started/understanding-billing Learn how Kalimna.ai billing works, including call minutes calculation, phone number rentals, and usage monitoring Kalimna.ai operates on a **usage-based** model. You pay primarily for two things: 1. The **minutes** your AI spends in calls. 2. Any **dedicated phone number** rentals. ## 1. Included Minutes vs. Pay-as-You-Go * **Included Minutes**: Some plans may come with a set of monthly minutes. These are consumed first. * **Pay-as-You-Go**: If you exceed included minutes (or if you're on a usage-based plan), you pay for each additional minute used. ## 2. How We Calculate Minutes * **Per-Second Billing**: Typically, Kalimna.ai bills by the second (converted to minutes). For example, a 90-second call is 1.5 minutes. * **Rounding**: Make sure you check your plan's rounding rules. Some might round up to the nearest 30 seconds, while others do pure per-second. ## 3. Monthly Usage & Purchasing Extra * **Monthly Reset**: If your plan includes minutes, those reset monthly on your billing date. * **Buying Add-Ons**: You can purchase extra minute bundles if you expect a spike in call volume. ## 4. Additional Costs * **Phone Number Rental**: A monthly fee for each dedicated inbound/outbound number you rent (varies by region). * **Possible Carrier Surcharges**: Some countries may have unique taxes or surcharges—check the [Costs & Pricing](../../costs-and-pricing/cost-overview.md) section for more details. ## 5. Monitoring Usage * **Dashboard**: The platform displays your current usage, how many minutes are left, and your estimated cost so far. * **Notifications**: You can set up alerts (e.g., "Email me when I hit 80% of monthly minutes") using the no-code automation platform. **Next Steps** * Check out our [Costs & Pricing](../../costs-and-pricing/cost-overview.md) section for a deeper breakdown of number rentals, international rates, inbound vs. outbound cost differences, and more. * Or proceed to [AI Assistants Overview](../../ai-assistants-overview/what-is-an-ai-assistant.md) to build your first agent. # Configuring the Inbound Assistant Source: https://docs.kalimna.ai/inbound-calls/configuring Set up your inbound AI assistant with prompts, voices, and tools for handling incoming calls An "Inbound Assistant" is simply an AI assistant set to **inbound** mode. Key steps: 1. **Prompt & Voice** * Provide a clear system prompt. Example:\ *"You are the Support Bot for Acme Inc. Greet politely, ask for the customer's need, and attempt to answer basic FAQs."* * Choose a voice from the built-in library or a cloned voice. 2. **Initial Message** * The first line of dialogue once the AI picks up. * Example: *"Hi, thank you for calling Acme Inc. How may I help you?"* 3. **Add Tools (Optional)** * **Transfer**: If the caller needs a human agent. * **End Call**: Condition to end the call politely. * **Appointment Scheduler**: If you want them to book a slot on your calendar. 4. **Call Flow** * In the system prompt, mention potential dialogues, e.g., "If they mention billing, ask for their invoice number." 5. **Save & Test** * Dial the inbound number from your cell phone. * Confirm the AI greets and responds according to your instructions. *** **Tip:** Revisit your assistant's settings regularly to improve the conversation flow—especially if you see frequent hang-ups or missed info. # Inbound Call Insights Source: https://docs.kalimna.ai/inbound-calls/insights Access and analyze inbound call data, including transcripts, recordings, and automation triggers After an inbound call, Kalimna.ai provides transcripts, analytics, and possible automation triggers. ## 1. Recording & Transcription * **Recording**: Typically saved in the call logs, so you can replay. * **Transcription**: The AI's recognized text, which is used to generate its responses. ## 2. Post-Call Data (Summary & Extracted Variables) * The AI can store or forward call info (e.g., name, reason for calling) to a connected CRM or spreadsheet. * Summaries may include "intent" or "call outcome." ## 3. Automation Triggers * Using the built-in no-code platform, you can do things like: 1. **Email or Slack** the transcript to your team. 2. **Log** the call outcome in Google Sheets. 3. **Notify** a human agent if follow-up is needed. ## 4. Viewing Insights * In your Kalimna.ai dashboard, go to **Calls** or **History**. * Filter by inbound calls. * Click a specific call to see the transcript, recording, or final notes. *** **Note:** For advanced analytics (like call sentiment or deeper classification), watch out for upcoming features or use the webhook/API to feed transcripts into external tools. # Inbound Calls Overview Source: https://docs.kalimna.ai/inbound-calls/overview Learn how AI assistants handle incoming calls, from answering to call completion and analytics When someone dials your dedicated (or SIP-integrated) number, Kalimna.ai can answer automatically through an AI Assistant. This section covers the big-picture flow of inbound calling: 1. **Caller Dials Your Number** * A local, international, or toll-free line assigned to your AI assistant. 2. **AI Assistant Answers** * Greets the caller using your configured voice and initial message. * Follows the **system prompt** to handle inquiries or gather information. 3. **Optional Actions** * Transfer to a human operator (if configured). * Schedule appointments, check order statuses, or collect data for later use. 4. **Call Completion** * AI ends the call politely or transfers to a queue/agent if needed. * You get transcripts and call analytics afterward. *** **Tip:** Start by renting or provisioning a phone number and linking it to an inbound-type AI Assistant. # Provisioning & Managing Phone Numbers Source: https://docs.kalimna.ai/inbound-calls/provisioning Learn how to provision, assign, and manage phone numbers for inbound AI calls If you haven't already, check out our [Phone Numbers](../../phone-numbers/types-of-phone-numbers.md) section to learn how to obtain or integrate a number. Once you have a number: 1. **Assign It to Your AI Assistant** * Go to **Assistants** > **(Your Inbound Assistant)**. * Under **Phone Number**, pick the number you want to use. 2. **Verify Functionality** * Test by calling the number from an external phone. * The AI should answer with your configured greeting. 3. **Monitoring Inbound Lines** * In the **Phone Numbers** page, you can see active lines, monthly cost, and usage. * Release lines you no longer need to avoid extra rental fees. ## Handling Country-Specific Requirements Some regions may require: * **Local address or business registration** * **ID documents** for toll-free or special lines If so, you'll be prompted to upload documents for **custom provisioning** before your number is activated. # How It Works (Quick Overview) Source: https://docs.kalimna.ai/introduction/how-it-works Understand the technical flow of how Kalimna.ai processes and handles phone conversations using AI Kalimna.ai blends **AI voice recognition** with **LLM-based replies** to conduct live phone conversations. Below is a simplified flow: 1. **Caller or Lead is Dialed** * **Inbound**: A customer dials your assigned phone number. * **Outbound**: Kalimna.ai's system calls a list of phone numbers from your campaign. 2. **Speech Recognition**\ The AI listens to what the person says and transcribes it into text in real time. 3. **LLM Decision**\ Kalimna.ai uses a large language model (LLM) and your configured "system prompt" to craft a reply or decide the next action (like transferring the call). 4. **Voice Output**\ The AI's response is converted to natural-sounding speech via our voice engine (ElevenLabs voices). 5. **Result & Actions** * For **Inbound**: The AI may answer questions, verify info, or take a message. * For **Outbound**: The AI can pitch a product, qualify leads, or transfer interested callers to a human agent. 6. **Data & Reporting**\ You get transcripts, call recordings, call outcomes (like "no answer" or "success"), and the ability to automate follow-up actions. ## Distinctions: Inbound vs. Outbound * **Inbound** * Caller dials a number you rented or integrated. * AI picks up, greets, and handles queries or routes the caller if needed. * **Outbound** * You upload or sync leads. * AI dials each number, follows your call script, possibly transfers if the lead is interested. ## Next Steps * Learn about [**Key Terminology**](/terminology) (like "AI Assistant," "Campaign," etc.). * Jump into [**Getting Started**](/getting-started) to set up your first AI assistant. # Key Terminology Source: https://docs.kalimna.ai/introduction/key-terminology Essential terms and concepts you need to know to use Kalimna.ai effectively Understanding these terms will help you navigate Kalimna.ai more easily: ## [AI Assistant / Agent](/ai-assistants/voice-selection) A customizable bot you configure to handle inbound or outbound calls. Defines conversation style, voice, and behavior via a "system prompt." ## [Campaign (Outbound)](/outbound-calls/campaigns) A sequence or batch of calls to a list of contacts or leads. You can upload a CSV, connect Google Sheets, or integrate your CRM to launch these calls. ## [Inbound Number](/phone-numbers/types) A dedicated phone number that customers dial to reach your AI assistant. You can get one from the platform or integrate via SIP/PBX. ## [Outbound Caller ID](/outbound-calls/caller-id) The number displayed on the customer's phone when your AI calls them. You can rent one or verify an existing number to use as Caller ID. ## [No-Code Automation Platform](/automation-platform/sms-capabilities) Kalimna.ai's built-in workflow platform, similar to Zapier/Make. It lets you connect triggers (like "call ended") to actions (like "send an email" or "update a Google Sheet") without writing code. [Learn more about automating your workflows](/automation). ## [Tools / Integrations](/getting-started/core-concepts) Refers to the specialized features your AI assistant can use, like transferring a call, ending a call, scheduling an appointment, or webhooks to external apps. *** **Tip:** Keep these definitions in mind as you proceed through the docs. They'll pop up in various setup steps or feature explanations. # Caller ID & Handling Source: https://docs.kalimna.ai/outbound-calls/caller-id Learn how to configure and manage caller ID for outbound campaigns When you launch an outbound campaign, you can choose which number appears on recipients' phones. ## 1. Dedicated Number * If you've rented a local or toll-free number, you can select it as the "Phone number" in the assistant settings. * Good for brand consistency or if you also accept inbound calls on the same line. * **No OTP verification needed** for numbers rented through Kalimna.ai. ## 2. Verified Existing Number (Caller ID Only) * If you want your personal or company phone line to appear, verify it with an **OTP** or short call. * This won't handle inbound calls for the AI, but the lead sees that recognized number on caller ID. * **Note**: OTP verification is ONLY required when using your own existing number as Caller ID. ## 3. SIP Integration * If you use a PBX or VOIP platform, you might pass a custom caller ID from your existing system. * Make sure your trunk or provider is set to allow a specific outbound Caller ID. ## 4. Country-Specific Rules * Some regions prevent using numbers you don't own as Caller ID. * Always ensure you have the right to present that number to avoid spam or legal issues. *** **Tip:** Test by calling your own phone or a friendly colleague to confirm the correct caller ID is displayed before launching a big campaign. # Creating & Managing Campaigns Source: https://docs.kalimna.ai/outbound-calls/campaigns Step-by-step guide to creating and managing outbound call campaigns, including lead imports and monitoring An outbound "campaign" determines when, how, and to whom calls are made. ## 1. Setup a Campaign 1. **Go to Outbound / Campaigns** in your dashboard. 2. Click **Create New Campaign**: * **Name**: e.g. "January Promo," "Payment Reminder," etc. * **Assistant**: which AI assistant will handle these calls? * **Window**: choose the time window for the campaign ## 2. Importing Leads * **CSV File**: Upload phone numbers (plus any extra columns, like name or account number). * **Google Sheets**: Connect via the no-code platform or direct integration to pull leads. * **CRM**: Some CRMs (HubSpot, GHL, etc.) can send leads directly to Kalimna.ai via API or automation. ## 3. Call Retries & Scheduling * **Max Retries**: e.g., attempt each lead up to 2 times if they don't answer. * **Retry Interval**: minutes/hours between retries. * **Time Window**: e.g., only call between 9 AM and 6 PM local time to avoid inconveniencing leads. ## 4. Monitoring & Pausing * Once the campaign is live, calls happen automatically during the allowed hours. * You can **pause** or **stop** the campaign anytime to revise your script or leads list. ## 5. Analyzing Results * Visit **Campaign Reports** to see: * How many calls were answered vs. no-answer. * Number of successful vs. failed calls. * Average call duration, etc. *** **Note:** Large campaigns with thousands of leads can run concurrently, as AI can handle parallel calls. Watch your minute usage to avoid unexpected costs. # Mass/Parallel Dialing Source: https://docs.kalimna.ai/outbound-calls/mass-dialing Learn how to manage high-volume outbound campaigns with parallel dialing while maintaining compliance One advantage of AI-driven outbound is that you can dial large batches of leads simultaneously without hiring more human agents. ## 1. Handling High-Volume Campaigns * **Upload Thousands of Contacts**: * If your plan or usage limit allows, you can import big lists from CSV or integrate with your CRM. * **Parallel Calls**: * A single phone number can handle multiple concurrent calls, but watch for compliance (some regions have rules against excessive cold calls). ## 2. Preventing Spam Flags * **Reasonable Call Pace**: * Don't launch 10,000 calls instantly. Stagger them with short intervals to avoid spam detection or network blocks. * **Caller ID Rotation** (Optional): * Some advanced users rotate caller IDs, but ensure they're all verified and within legal guidelines. ## 3. Real-Time Monitoring * **Dashboard**: * See how many calls are active, success/no-answer rates, average call durations, etc. * **Campaign Pause**: * If you spot unusual patterns (like high "no answer" or negative responses), pause the campaign to refine your script or lead quality. *** **Note:** High-volume dialing may ramp up your minute usage quickly. Keep an eye on [Costs & Pricing](../../costs-and-pricing/cost-overview.md) to avoid surprises. # Outbound Calls Overview Source: https://docs.kalimna.ai/outbound-calls/overview Learn about outbound call campaigns, including sales calls, reminders, and follow-ups using AI assistants Kalimna.ai supports outbound call campaigns where the AI calls leads or customers automatically. Ideal for: * **Sales/Marketing**: Reaching out to potential clients, offering promotions. * **Collections/Reminders**: Checking overdue payments or reminding appointments. * **Customer Follow-Ups**: Post-purchase check-ins, feedback surveys, etc. ## Key Elements 1. **Leads List**\ Usually a list of phone numbers (with optional data like names or IDs). 2. **Campaign**\ A structured way to manage who gets called, how many times, and in which time window. 3. **AI Assistant**\ Handles the conversation, guided by your system prompt and call script. 4. **Caller ID**\ The number shown on recipients' phones. Could be a dedicated number or your verified existing line. *** **Tip:** Each campaign references an AI assistant. If your script changes drastically, you might create a new assistant or edit the existing one. # Scripts & Prompts for Sales or Collections Source: https://docs.kalimna.ai/outbound-calls/scripts-and-prompts Learn how to write effective system prompts and scripts for outbound sales and collection calls The power of outbound calling lies in having a clear, well-structured conversation flow. Here's how to craft an effective script. ## 1. System Prompt Best Practices * **Introduce Your Company**: *"You are the Sales Bot for Ace Marketing…"* * **Purpose**: *"…you offer a 20% discount if the user is interested, or schedule a callback if uncertain."* * **Objection Handling**: *"…if they say 'no budget', attempt to collect a reason or set a reminder for next month."* ## 2. Example (Sales Prompt) ```plaintext theme={null} "You are the Sales Bot for ACME Corp. Greet politely, mention the new product launch, and offer a 10% discount if the lead is interested. If they ask for more info, invite them to schedule a call with a human agent. If they refuse or express disinterest, politely end the call." ``` ## 3. Example (Collections Prompt) ```plaintext theme={null} "You are the Collections Bot for ABC Finance. Greet the user, verify their name and last payment date. If they confirm a willingness to pay, gather payment details or schedule a callback. If they refuse, politely note the reason and end the call." ``` ## 4. Handling Yes/No/Maybe * **Yes**: Provide details or transfer to a human for finalizing. * **No**: Respectfully close, mark lead as not interested. * **Maybe**: Offer to schedule a follow-up call or provide more info. *** **Tip:** Keep your script short and direct. The AI can adapt, but a concise prompt helps keep calls focused and efficient. # Voicemail Handling Source: https://docs.kalimna.ai/outbound-calls/voicemail-handling Learn how your AI assistant handles voicemail detection in outbound calls When making outbound calls, the AI assistant can automatically detect if it has reached a voicemail or answering machine: ## Voicemail Detection * The AI uses advanced detection to identify voicemail systems * When voicemail is detected, the call is automatically ended * This helps avoid wasting resources and ensures efficient call handling ## Benefits of Auto-Drop * Saves time and call minutes * Prevents awkward or incomplete interactions * Allows for automatic retry scheduling * Maintains professional communication standards ## Best Practices * Monitor call logs to track voicemail rates * Consider time zones when scheduling calls * Plan retries during different hours * Target business hours when people are more likely to answer ## Reporting You can track voicemail detection in your campaign analytics: * Number of detected voicemails * Time of day patterns * Success rates for different calling times *** **Tip:** If you're getting too many voicemails, try adjusting your campaign's calling hours to when people are more likely to answer. # Assigning Numbers to Assistants Source: https://docs.kalimna.ai/phone-numbers/assigning-to-assistants Learn how to connect your phone numbers to AI assistants for both inbound and outbound calls After you've acquired a number (or configured SIP or Caller ID), you'll need to assign it to your AI assistant. The process is the same whether you're using the number for inbound or outbound calls. ## Assigning a Number 1. Go to **Assistants** → **(Your Assistant)** → **Settings** 2. Under **Phone Numbers**, select a number from your Kalimna.ai inventory 3. Click **Save** to apply the changes ## Number Usage Once assigned, the number can be used for: * **Inbound**: Callers dialing this number will reach your AI assistant * **Outbound**: The number will appear as Caller ID for outbound campaigns * **Both**: The same number can handle both inbound and outbound calls ## Number Verification For numbers not rented from Kalimna.ai: * You'll need to verify ownership via **OTP code** or a **verification call** * Once verified, the number can be used for both inbound and outbound * Verification status persists across different assistants ## Testing Before going live: 1. Make an inbound test call to verify the assistant answers 2. Run a test outbound call to check Caller ID display 3. Verify any specific features (call transfers, voicemail, etc.) *** **Tip:** Always test both inbound and outbound functionality after making any changes to number assignments. # Pricing & Regions Source: https://docs.kalimna.ai/phone-numbers/pricing-and-regions Understand phone number pricing across different regions, documentation requirements, and additional fees Phone number rental fees vary based on country, number type, and local telecom rules. Below is a general guide: ## 1. Typical Monthly Costs * **US/Canada**: Around \$3.99/month. * **UK**: Typically \~£3/month, but can vary. * **EU Countries**: €3–€5/month, or more for toll-free lines. * **Others**: Some countries can be \$3 or more, depending on local taxes. ## 2. Advanced Documentation * **Business Registration**: Many countries (e.g., France, Germany, Italy) require a local address or company registration to rent a number. * **ID Proof**: Some carriers need a government-issued ID for individuals. ## 3. Additional Fees * Some toll-free lines or special region numbers have higher monthly costs or per-minute surcharges. * Calls to or from certain regions might also incur higher usage rates—see [Costs & Pricing](/pricing/overview) for full details. ## 4. Don't See Your Region? * Contact us through the chat widget in the bottom right corner of the screen inside the app to request a number. * Provide the necessary documentation, and we'll attempt to source a local number through our carrier partners. *** **Note:** If you're integrating **SIP** or using **Caller ID** verification, you do not pay a monthly rental, but usage costs may still apply. # Purchasing & Managing Numbers Source: https://docs.kalimna.ai/phone-numbers/purchasing-and-managing Learn how to purchase, provision, and manage phone numbers for your AI assistants ## Getting Started 1. If you see a number you want in the platform, rent it instantly. 2. If it's not listed, contact us for custom provisioning. We'll let you know which documents are required. 3. Pricing may differ by country, we'll provide final monthly cost once the number is ready. 4. Any type of number (local, national, or toll-free) can be custom-provisioned if not visible in the platform. ## Custom Provisioning * Our team handles the entire process with the carrier. * We'll request any required documents based on the country's regulations. * Typical processing time is 1-3 business days. ## After Purchase * Assign the number to an AI assistant for inbound calls. * Use it as Caller ID for outbound campaigns if desired. * Monitor usage and costs in your dashboard. *** **Tip:** Remember to **assign the purchased number** to an AI assistant. # SMS Capabilities Source: https://docs.kalimna.ai/phone-numbers/sms-capabilities Learn about SMS features, requirements, and pricing for your phone numbers This is an overview of SMS features. For detailed instructions on sending SMS through automation flows, check our [Automation Platform Documentation](/automation-platform/calls-related/sms-capabilities). ## Requirements To send SMS messages, you need: * An SMS-capable phone number * Sufficient credits in your account * Proper automation flow setup ## SMS Segments SMS messages are split into segments: * Each segment is 160 characters for standard ASCII text * Or 70 characters for Unicode (special characters, emojis) * Longer messages are automatically split into multiple segments * You are charged per segment sent For example: * "Hello! How are you?" (16 chars) = 1 segment * A message with 200 ASCII chars = 2 segments * A message with emojis and 100 chars = 2 segments ## Costs SMS pricing varies by: * Destination country * Number of segments * Type of content (standard/unicode) ## Monitoring & History Track your SMS activity in the dashboard: * Delivery status * Timestamp * Number of segments * Cost per message * Recipient details * Content preview ## Best Practices 1. **Message Length** * Keep messages concise * Monitor segment count * Use standard characters when possible 2. **Compliance** * Include opt-out instructions * Follow local regulations * Respect quiet hours 3. **Testing** * Verify number capabilities * Test delivery to different carriers * Monitor delivery rates *** **Want to start sending SMS?** Check out our [automation platform documentation](/automation-platform/calls-related/sms-capabilities) to learn how to set up SMS workflows. # Types of Phone Numbers Source: https://docs.kalimna.ai/phone-numbers/types Learn about the different types of phone numbers you can use with Kalimna.ai: dedicated numbers, SIP integration, and Caller ID Kalimna.ai lets you connect three different kinds of phone numbers to your AI assistant: 1. **Normal (Dedicated) Numbers** * Rented directly from Kalimna.ai. * Can be used for **both inbound** and **outbound** calls. * Typically charged as a monthly rental, with the ability to handle multiple parallel calls on a single number. 2. **SIP Integration (VOIP/PBX)** * Connect an existing VOIP or PBX number via SIP. * This setup allows you to keep your existing numbers while benefiting from Kalimna.ai's AI. * Works for **both inbound and outbound**—but requires you to share SIP credentials or trunk details with us to configure. * To submit a request, contact us through the chat widget in the bottom right corner of the screen inside the app. 3. **Caller ID (Outbound Only)** * When you already have a phone number (e.g., your personal or business line) but don't want to port it or integrate via SIP. * You verify ownership (via OTP or a short call) so that number can appear on people's caller ID. * **Inbound calls won't be answered by the AI** if you use Caller ID alone—it only masks the AI's outbound calls. ## Choosing the Right Option * If you need **inbound** and you don't already have a VOIP solution, consider renting a dedicated number. * If you have an established **PBX** or VOIP provider, use **SIP integration**. * If you just want to do **outbound** calls showing your existing phone line, pick **Caller ID**. # Number Rentals & International Rates Source: https://docs.kalimna.ai/pricing/number-rentals Understand phone number rental costs, plus how SIP and Caller ID usage is billed by the minute. Kalimna.ai offers multiple ways to handle phone numbers for inbound or outbound calls. You can **rent** a dedicated number from us, use a **SIP** trunk (no monthly fee but carrier costs are on your own PBX), or verify an **existing Caller ID** (also no monthly fee, but region-based per-minute charges). *** ## 1. Renting a Dedicated Number If you want a fully managed inbound/outbound line, you can rent it directly in the platform: * **Monthly Fee**: Typically \$3.99/month for standard local numbers (US/CA/UK). Regions vary: * **EU Countries**: €3–€5/month * **Latin America, Asia, Africa**: \$10+ in some cases, depending on availability or local taxes * **Custom Provisioning**: If you don’t see your desired country or region listed, our team can custom-provision a number after verifying local documents. **Per-Minute Rates** * Outbound calls on a rented number: depends on the country you’re calling—could range from \$0.05/min to \$0.50/min if it’s an expensive destination. * Inbound calls: usually no extra charge unless it’s a special/toll scenario in that region. *** ## 2. SIP Integration (No Monthly Fee) If you already have a VOIP/PBX solution, you can integrate via a **SIP trunk** with **no monthly rental** from Kalimna.ai. Instead, you pay: * **SIP Per-Minute**: \$0.00045/min on our side for carrier bridging. Your VOIP provider may also have separate usage fees. * **Your Existing Number**: You’ll continue to use your own phone lines for inbound and outbound, but the carrier layer costs \$0.00045/min with us whenever the AI is on the call. This is ideal if you’re comfortable managing your own phone system or want to keep your existing numbers without renting from us. *** ## 3. Caller ID (No Monthly Fee) You can verify an existing number for **outbound calls** only—no inbound routing. * **Verification**: We confirm ownership via a short OTP or call. * **Per-Minute**: For the telephony used behind the scenes, we charge region-based rates. * **Example**: In the US, Caller ID usage might be \$0.01/min. * Other countries vary; contact support for specifics. > **Note**: Caller ID alone does **not** enable inbound AI; it only masks your outbound calls with your verified number. *** ## 4. International Rates & Regions When making outbound calls: * **Carrier Rates**: Some countries cost \$0.01/min, others \$0.50/min due to local carriers. * **Inbound**: If you rent a number in a high-cost region or special type, inbound calls could have surcharges. Regardless of whether you rent a number or use Caller ID/SIP, the **carrier portion** of the call cost depends on the destination/origin country and is typically added to your overall usage. *** ## 5. Putting It All Together 1. **Rent a Number** * Pay a monthly fee (from \$3.99), plus standard inbound/outbound carrier costs for calls on that line. 2. **Use SIP** * No monthly from us, but a \$0.00045/min AI bridging cost, plus your own PBX fees. 3. **Caller ID** * No monthly from us, but region-based per-minute telephony charges (e.g., \$0.01/min in the US). Outbound only. # Cost Overview Source: https://docs.kalimna.ai/pricing/overview Understand the main components of Kalimna.ai pricing, including call minutes, number rentals, and optional fees Kalimna.ai uses a **credit/minute system** to track usage for both AI processing and carrier network fees. Here's how it breaks down: *** ## 1. Main Components 1. **AI Cost** * Billed in fractional increments by the second (e.g., 0.5 minute for a 30-sec call). * Rate depends on your plan (Starter, Pro, Agency, etc.). 2. **Carrier Cost** * The telecom side of the call, generally **rounded up** to the next minute and converted to your plan’s minute rate. * Region-dependent: e.g., calling US vs. Europe vs. Asia has different carrier rates. 3. **Number Rental** * If you rent a phone number, there’s a monthly fee (e.g., \$3.99 for a standard US number). * If your region isn’t listed, we can custom-provision a number upon verifying documents. * Each number’s cost is billed monthly until released. 4. **Extra Fees (Optional)** * **SMS**: If your number is SMS-capable, standard per-message fees apply. * **Voicemail detection**: Billed as 1 minute per call. * **High-Volume**: Potential bulk discounts if you exceed tens of thousands of minutes monthly. *** ## 2. Visual Example Suppose you have 200 included minutes in your plan. A typical 1-minute call might consume \~1.5 minutes from your balance if carrier cost is half your plan’s rate. This means you’d have about 198.5 left. By the end of the billing cycle, any unused minutes do no rollover. *** ## 3. Checking Call Logs * **Dashboard → Call History**: See each call’s final cost breakdown. * AI usage (seconds → fraction of a minute). * Carrier usage (rounded up → fraction of a minute after conversion). * Summed total in “minutes” deducted from your included or purchased balance. *** ## 4. Monitoring & Alerts * Watch your real-time usage in the **dashboard**. *** ## 5. Putting It All Together 1. **Pick a Plan**: Decide on Starter, Pro, or Agency—higher plans have cheaper AI rates. 2. **Acquire or Verify a Number**: Rent from Kalimna.ai or add your own as caller ID for outbound. 3. **Start Making Calls**: Inbound or outbound usage deducts from your minute balance. 4. **SMS & Extras**: If relevant, each text or advanced feature also deducts from your balance or is billed separately. That’s the overall cost structure. For a deeper look at the math behind minute conversion, check our [Pricing Breakdown](/pricing/usage-based) page. # Pricing Breakdown Source: https://docs.kalimna.ai/pricing/usage-based Detailed explanation of how call minutes are calculated and billed # Pricing Breakdown Kalimna.ai uses a **minutes-based** system for billing. These minutes (or tokens/credits) get **deducted** from your balance each time you make or receive a call. The actual “per-minute cost” depends on your plan, and **carrier costs** are also converted into minutes. Below is how it works. *** ## 1. Inbound vs. Outbound Calls * **Inbound**: You spend minutes as soon as the AI assistant picks up and is engaged in a call. * **Outbound**: Minutes start deducting once the customer answers the call and stays connected. Dial time is not billed. > **Note**: A call is considered active until the AI or the user hangs up, **or** until voicemail detection ends the call if the user’s voicemail answers (for outbound). *** ## 2. How Minutes Are Used ### a) AI Spoken Time * If your AI assistant is actively on the call for 1 minute, you consume **1 minute** of AI time. * The cost is **prorated** by the second, so a 30-second call uses 0.5 minutes from your plan (for AI time). ### b) Carrier Conversion * **Carrier cost** (the telecom network fee) is also deducted from your balance **but** is typically **rounded up** to the next minute. * We convert the carrier’s dollar amount to minutes at your plan’s rate. * **Example**: If your carrier charge is \$0.05 for a 1-minute call, and your plan’s AI rate is \$0.10/min, we convert that \$0.05 to 0.5 minutes from your balance. **So a single 1-minute conversation might consume:** * **1 AI minute** (for the assistant) * **+ 0.5 “carrier minutes”** (converted from the carrier’s \$0.05 to half your AI cost). * **= 1.5 minutes total** deducted from your plan balance. *** ## 3. Per-Second Billing vs. Rounding 1. **AI Time** * **Measured per second**, so 70 seconds is \~1.17 minutes of AI usage. * Deducted exactly from your plan’s minute balance. 2. **Carrier Time** * **Rounded to next full minute** for the network fee. * Then converted into a fraction of your AI plan cost to decide how many “minutes” to deduct from your credit balance. *** ## 4. Included Minutes & Top-Ups * **Each Plan**: Usually includes a monthly allotment of minutes. * **Using Up Minutes**: Once you exceed included minutes, you can **top up** your wallet with additional minutes at your plan’s rate. * **No Rollover**: Unused minutes typically don’t roll over to the next month. **Example** > You’re on the **Starter Plan** with 200 included minutes: > > * If you make enough calls that total 180 AI minutes + carrier conversions = 180 used, you have 20 left this month. > * Next month, you reset to 200. If you need 210 minutes, you pay for 10 extra minutes at your plan’s rate. *** ## 5. Volume Discounts or Tiers * Plans vary (e.g., **Starter** at \$0.20/min, **Pro** at \$0.15/min, **Agency** at \$0.09/min). * High-volume usage (like 50,000+ minutes/month) can often get **bulk discounts** by contacting sales. *** ## 6. Quick Usage Examples ### Example A (Outbound Call, Starter Plan) * **AI Rate**: \$0.20/min * **Call Duration**: 30 seconds → 0.5 AI minutes = \$0.10 AI cost. * **Carrier**: \$0.01/min, but 30 seconds → 1 minute rounded up → \$0.01. * \$0.01 at your plan’s \$0.20 rate = 0.05 “plan minutes” used (Or if you do a simpler approach, \$0.01 / \$0.20 = 0.05 minutes) * **Total**: 0.5 (AI) + 0.05 (carrier) = 0.55 minutes from your plan. If you had 200 included, you’d have 199.45 left. ### Example B (Inbound Call, Pro Plan) * **AI Rate**: \$0.15/min * **Call Duration**: 90 seconds → 1.5 AI minutes = \$0.225 AI cost. * **Carrier**: Suppose inbound is \$0.015/min, rounding up to 2 minutes if the call was 1.5 min. That’s \$0.03 total. * \$0.03 / \$0.15 = 0.2 minutes from your plan. * **Total**: 1.5 (AI) + 0.2 (carrier) = 1.7 minutes deducted. *** ### FAQ * **Do I pay double if user + AI talk simultaneously?**\ **No**, it’s based on total call duration, not per speaker concurrency. * **What if someone picks up then instantly hangs up?**\ The AI might register a few seconds; cost is fractional for the AI, but carrier may round up to 1 minute. *** **Bottom Line**\ All calls burn **AI time** plus a **converted carrier cost** from your plan’s minute balance. Keep track of usage in your dashboard, top up if needed, and choose the plan that best suits your volume. # Managing Your Numbers Source: https://docs.kalimna.ai/provisioning/managing-numbers Learn how to view, label, release, and manage your provisioned phone numbers After you meet any compliance requirements and purchase or provision your numbers: 1. **View All Numbers** * In your dashboard → **Numbers**. You'll see monthly costs, expiration/renewal dates, etc. 2. **Releasing or Renewing** * Release a number if you no longer need it. * Renewals happen automatically each month unless you release it. 3. **Scaling Up** * If you need multiple lines for different markets, repeat the provisioning steps. # Phone System Integrations Source: https://docs.kalimna.ai/provisioning/phone-system-integrations Learn how to integrate Kalimna.ai with your existing PBX or VOIP infrastructure through SIP trunks For businesses with existing PBX or VOIP infrastructure, Kalimna.ai can integrate through SIP trunks or direct connections: ## 1. SIP Trunk * **How It Works**: You share your SIP credentials (server, username, password). Kalimna.ai configures a trunk internally. * **Inbound/Outbound**: AI can pick up inbound calls from your PBX or place outbound calls using your existing number ranges. ## 2. Caller ID Forwarding * If your PBX already handles call routing, pass the call to Kalimna.ai only when certain conditions are met (like after IVR selection). ## 3. Hybrid Model * Some advanced setups keep human agents on your PBX but leverage the AI for high-volume or after-hours calls. * Example: *During business hours, normal agents handle calls. After hours, calls route to the AI assistant via SIP trunk.* ## 4. Things to Note * SIP sometimes requires opening firewall ports or whitelisting IPs. * Carrier charges from your PBX provider still apply, plus any Kalimna.ai usage fees. *** **Tip:** Contact support for guidance if you're new to SIP or PBX integration. We can assist with the config steps. # Supported Countries Source: https://docs.kalimna.ai/provisioning/supported-countries Learn about phone number availability and provisioning across different countries # Phone Number Availability Kalimna.ai can provide phone numbers in **any country**. There are two ways to get a number: ## 1. Instant Provisioning Numbers in these regions are available directly from your dashboard: * United States * Canada * United Kingdom * Most Western European countries * Australia * New Zealand * And more... Simply go to **Phone Numbers** in your dashboard and select from the dropdown. ## 2. Custom Provisioning Need a number in a country not shown in the dropdown? No problem! We can help: 1. Contact us via the live chat 2. Let us know: * Which country you need * How many numbers * Your use case (inbound/outbound) 3. We'll handle the provisioning process for you ## Documentation Requirements * **Standard Countries** (in dropdown): Usually just basic account verification * **Other Countries**: May need: * Business registration * Local address * Industry-specific licenses * Other compliance documents We'll guide you through exactly what's needed for your specific case. ## Timeframes * **Dropdown Countries**: Instant provisioning * **Custom Provisioning**: Usually 1-3 business days, depending on: * Country requirements * Document verification * Local regulations *** **Need a specific number?** Just reach out via live chat, and we'll help you get set up in any country you need! # AI Behavior Issues Source: https://docs.kalimna.ai/troubleshooting/ai-behavior Troubleshoot and optimize your AI assistant's conversation behavior and responses Your AI's behavior can be fine-tuned through a combination of engine settings and prompt adjustments. ## Engine Settings Impact Different AI engine modes affect behavior: ### Fast Engine * Quick, more conversational responses * May occasionally miss context * Best for: Simple interactions, sales calls * Works great with Filler Audio for natural flow ### Standard Engine * Balanced understanding and speed * Good for most use cases * Default recommendation for new assistants ### Accurate Engine * Deep context understanding * More thoughtful responses * Best for: Complex support, detailed information gathering * May have longer pauses between responses ## Common Issues & Solutions 1. **AI Misunderstanding Context** * Switch to Accurate Engine * Add more context to your prompt * Include example conversations 2. **Unnatural Conversation Flow** * Enable Filler Audio for smoother transitions * Use Fast Engine for quicker back-and-forth * Add conversation examples in your prompt 3. **Repetitive Responses** * Review and update your system prompt * Add variation examples * Consider switching to Standard/Accurate engine ## Optimization Tips * **Sales Calls**: Fast Engine + Filler Audio for engagement * **Customer Support**: Accurate Engine for better problem solving * **Lead Qualification**: Standard Engine for balanced performance ## Testing Changes After adjusting settings: 1. Use the test call feature 2. Try different conversation scenarios 3. Monitor call recordings for improvement *** **Tip:** Start with Standard Engine and adjust based on your specific needs and feedback. # Billing & Credits Source: https://docs.kalimna.ai/troubleshooting/billing Troubleshoot billing issues, understand charges, and learn about refund policies and usage tracking ## 1. Unexpected Charges? * **Large Outbound Campaign?** Possibly your calls used more minutes than expected. * **Did You Rent Multiple Numbers?** Monthly fees stack if you keep multiple lines active. ## 2. Refund / Cancellation Policies * Check your plan's terms. Usually usage-based minutes are non-refundable because resources are used in real-time. * If you have a monthly plan with included minutes, you can often cancel future renewals but not partial months. ## 3. Tracking Usage * **Dashboard**: Real-time usage counters show minutes consumed. * **Notifications**: Set alerts if you near a monthly threshold. *** **Tip:** If usage spiked unexpectedly, see call logs or see if an employee triggered a large campaign by mistake. # Call Quality Issues Source: https://docs.kalimna.ai/troubleshooting/call-quality Troubleshoot and optimize call quality, latency, and connection issues Call quality can be affected by both technical factors and AI settings. Here's how to optimize both: ## AI Engine Impact Your choice of AI engine affects perceived call quality: ### Fast Engine + Filler Audio * Minimal latency * Quick back-and-forth * Natural conversation flow * Best for most calls ### Standard/Accurate Engine * Longer processing time * More accurate responses * Better for complex conversations ## Optimization Tips * Start with Fast Engine + Filler Audio * Switch to Standard/Accurate only if needed * Monitor call recordings for quality * Test different voice models ## Quick Fixes If experiencing issues: 1. Try a test call 2. Switch to a faster engine setting 3. Enable filler audio 4. Check network connection *** **Tip:** The combination of Fast Engine and Filler Audio typically provides the best perceived call quality. # Voice & Response Issues Source: https://docs.kalimna.ai/troubleshooting/voice-problems Troubleshoot voice quality and response timing issues with your AI assistant If you're experiencing issues with voice quality or response timing, you can adjust several settings to optimize performance. ## Response Speed vs. Accuracy Your AI assistant has adjustable engine settings: * **Fast Engine**: Quicker responses but might be less accurate * **Standard Engine**: Balanced speed and accuracy * **Accurate Engine**: Most accurate but slower responses Adjust these in your assistant's settings under "AI Engine Configuration". ## Filler Audio To minimize silence during processing: * Enable "Filler Audio" in your assistant settings * The AI will use natural sounds (like "hmm" or "one moment") while processing * Works best with the Fast Engine for near-instant perceived responses ## Common Issues & Solutions 1. **Slow Responses** * Switch to Fast Engine mode * Enable Filler Audio * Simplify your system prompt 2. **Inaccurate Responses** * Use the Accurate Engine mode * Provide more context in your prompt * Add specific examples 3. **Voice Quality** * Try different voice models * Adjust speech speed settings * Try cloning a voice ## Optimization Tips * For sales calls: Use Fast Engine + Filler Audio for natural flow * For support: Consider Accurate Engine for better comprehension *** **Need help?** Contact support if these adjustments don't resolve your issues.