Access the Platform Guide

Enter your work email to continue. We’ll notify our team that you’re viewing the onboarding guide.

Your email is only used to track guide access.

Your complete guide to CandexAI

Everything you need to set up AI agents, chatbots, phone lines, automations, and integrations — with screenshots showing exactly where to click.

Create Account & Sign In

Start here — create your CandexAI workspace or sign in to an existing account. After login, use this onboarding guide to set up the platform.

Create a New Account

For first-time users who don't have a CandexAI workspace yet.

Create account page
  1. Go to app.candexai.co.in and open the sign-up page
  2. Choose a quick sign-up option: Google, Facebook, or Microsoft
  3. Or scroll to Or Sign Up With Email and fill in:
    • Full Name
    • Email Address
    • Password (at least 6 characters)
    • Confirm Password
  4. Complete the reCAPTCHA ("I'm not a robot") checkbox
  5. Click Continue to create your account and enter the platform
  6. Already registered? Click Sign in at the bottom instead

Sign In to Your Workspace

Returning users sign in here to access Conversations, AI, Automations, and the rest of the platform.

Sign in page
  1. Go to app.candexai.co.in and open the sign-in page
  2. Sign in with Google, Facebook, Microsoft, or email under Or continue with email
  3. Enter your Email address and Password
  4. Forgot your password? Click Forgot password? next to the password field
  5. Complete the reCAPTCHA if shown
  6. Click Sign In — you'll be directed into your CandexAI dashboard
  7. From there, open Onboarding hub in the sidebar to follow setup tasks and unlock bonus minutes
💡 After you sign in Continue with Section 2 below (Getting Started) or jump to any topic in the left sidebar. This guide walks you through every part of the platform step by step.

⚡ 5-Step Quick Start

1

Connect Channels

Go to Integrations → connect WhatsApp, Gmail, Meta, or phone

2

Add Knowledge

AI → Knowledge Base → upload docs, URLs, or paste text

3

Configure Chatbot

Configuration → Chatbot → set name, color, greeting & prompt

4

Create Voice Agent

AI → Agents → pick a template or build from scratch

5

Automate & Measure

Build automations, launch campaigns, track in Analytics

The Onboarding Hub

Track your setup progress and unlock bonus minutes from the Onboarding Hub.

Onboarding hub setup checklist

Click any image to zoom in

  1. Click Onboarding hub at the bottom of the left sidebar
  2. Work through the Setup Checklist tasks at your own pace to unlock +200 bonus minutes
  3. Use Start AI Tour or Open Setup Assistant for guided help
  4. Watch your Overall completion progress bar and Your queue as you complete each step

Knowledge Base

Teach your AI what your business knows — so chatbot and voice agents answer from your real content, not guesses.

Why create this?

Without a knowledge base, AI only uses its general training. A knowledge base gives it your FAQs, policies, product info, and website content — so answers match your business.

What happens after?

Once status is Ready, link the knowledge base to your chatbot (Configuration → Chatbot) and voice agents (when creating/editing an agent). Customers get accurate answers on chat and phone.

Step 1 — Open the Knowledge Bases Page

Navigate to AI in the sidebar, then open the Knowledge Base area.

Knowledge bases list page
  1. Click AI in the left sidebar, then open Knowledge base
  2. You'll see summary counts: Total, Ready, Processing, Failed
  3. Existing knowledge bases appear as cards showing name, type, date, and a Ready status
  4. Click + Create knowledge base in the top-right to add a new one
  5. Use Ingest data on any card to add more content to an existing knowledge base

Step 2 — Create a Knowledge Base

A modal will open where you name your knowledge base and add your first document.

Create knowledge base modal
  1. Enter a Name for your knowledge base (e.g. "Product FAQ", "Support Docs")
  2. Choose a Source type:
    • Text — paste FAQ or policy text directly
    • URL — provide a website link to scrape
    • File — upload a PDF, DOCX, or TXT file
  3. Add your Content in the text area (or upload file / enter URL)
  4. Click Create & ingest to process and index your content
ℹ️ Note After creation, the platform will ingest (index) your content. This may take a few seconds. Once the status shows Ready, link it to your chatbot and voice agents for consistent answers.

Voice Clone

Make your voice agent sound like a real person from your team — using a short audio sample.

Why clone a voice?

Standard AI voices sound generic. Voice clone lets you upload a short recording and create a custom voice that matches your brand or a specific team member — so phone calls feel more personal and trustworthy.

What happens after?

Your cloned voice appears in Voice library when creating or editing a voice agent. Select it under Voice → Voice library and every call that agent makes will use your custom voice.

Cloning a Custom Voice

Go to AI → Voice Clone to build and manage your own voices.

Voice clone page
  1. Go to AI → Voice clone in the sidebar
  2. Switch between the Voice library tab (your saved clones) and the Voice clone tab
  3. Click + Clone new voice in the top-right to create a voice from a short recording or audio file
  4. If you have no voices yet, click Get started → in the empty state
  5. Once created, your voice appears in Your library and can be assigned to any agent under Voice → Voice library
  6. Click Refresh to update the list after cloning

AI Integrations & Tools

Give your AI superpowers — let it send emails, call your APIs, and take real actions during chat or phone calls.

Why create AI tools?

Knowledge bases help AI answer questions. AI tools let AI do things — check order status from your API, send a confirmation email, fetch patient records, etc. The AI decides when to use each tool based on the description you write.

What happens after?

During a live chat or call, when a customer asks something that matches your tool description, the AI automatically runs that tool. For example: visitor books an appointment → AI sends a confirmation email. Or caller asks for order status → AI calls your API and reads back the result.

Step 1 — Open AI Integrations

Important: This is not the same as Settings → Integrations. This page is only for tools the AI can use mid-conversation.

AI integrations empty state
  1. Go to AI → Integrations from the AI sidebar
  2. Read the How integrations work box at the top:
    • Email integrations use Gmail connected under Settings → Integrations
    • HTTP tools let AI call external APIs for chatbot, voice agent, or both
    • A clear Description tells the AI when to use each tool
  3. Click Refresh to update the list after creating tools
  4. Click + New Integration in the top-right to create your first AI tool
ℹ️ Difference from Settings → Integrations Settings → Integrations connects platforms like Gmail, CRMs, WhatsApp, and Shopify. AI → Integrations creates callable tools that the AI can use during chat or voice conversations.

Step 2 — Create an HTTP Tool

Connect any external API so your chatbot or voice agent can fetch data or trigger actions in your own systems.

Create HTTP tool modal

When to use HTTP tools

Use when you have an existing API — hospital records, order lookup, inventory check, booking system, etc. The AI calls your API URL and uses the response in its reply.

After registration

If target is Voice agent, the tool is auto-attached to the agent you select. If Chatbot or Both, the tool is available in widget and dashboard chat. The AI reads your description to know when to invoke it.
  1. Click + New Integration, then select the HTTP Tool tab
  2. Choose Target Platform:
    • Chatbot — website widget + dashboard chat only
    • Voice agent — phone calls only (you must pick which agent)
    • Both — same tool works in chat and on calls
  3. Enter Function name (e.g. get_patients, check_order_status) — this is the internal name the AI uses
  4. Write Description in plain English: what the tool does AND when the AI should use it. This is the most important field — be specific!
  5. Configure the HTTP Endpoint:
    • Method — GET (fetch data), POST (create/send), PATCH (update)
    • URL — your API endpoint (e.g. https://api.yoursite.com/orders)
    • Parameters — what data the AI should collect from the user and send (name, order ID, etc.)
    • Auth — Bearer token, API key, or Basic auth if your API requires it
  6. If target is Voice agent, select the agent from the dropdown
  7. Click Register HTTP tool
💡 Description example "Use this when the customer asks about their order status. Only call after you have collected their order ID. Returns shipping status and estimated delivery date."

Step 3 — Create an Email Tool

Let the chatbot automatically send Gmail emails when certain things happen in a conversation.

Create email integration modal

When to use email tools

Use when the chatbot should send real emails — appointment confirmations, follow-ups, sending info to the customer, notifying your team. Works in widget chat and dashboard chat.

After registration

During chat, when the visitor's message matches your condition (e.g. "appointment booked"), the AI sends the email through your connected Gmail. You can use templates like confirm_appointment or build custom emails with CC/BCC.
  1. First: Connect Gmail under Settings → Integrations → Gmail (required before email tools work)
  2. Go to AI → Integrations+ New IntegrationEmail tab
  3. Pick a template or click Skip — build from scratch:
    • confirm_appointment — sends confirmation when user books an appointment
    • send_email — general email with optional CC and BCC
  4. Enter Integration name (e.g. confirm_booking)
  5. Fill When should the chatbot send this email? — write in everyday language when the AI should trigger this (e.g. "When user successfully booked an appointment")
  6. Configure Email fields (recipient, subject, body) and click + Add field for dynamic values from the conversation
  7. Click Create email tool
⚠️ Prerequisite Gmail must be connected under Settings → Integrations before email tools can send. Email tools run via your connected Gmail account.

Agents & Agent Studio

Voice agents are AI phone assistants — they answer inbound calls and make outbound calls on your behalf.

Why create a voice agent?

A voice agent handles phone conversations automatically — booking appointments, answering FAQs, qualifying leads, or following a script you define. One agent can handle hundreds of calls without your team picking up the phone.

What happens after?

Assign a phone number (Configuration → Phone) and the agent answers inbound calls or makes outbound calls. Call transcripts appear in Conversations. Link a knowledge base for accurate answers and CRM tools to read/write data during calls.

Step 1 — Open the Agents Page

See all your voice agents and create new ones here.

Agents list page
  1. Go to AI → Agents in the sidebar
  2. Each row shows the agent name, agent ID, language, and created date
  3. Click Browse templates to start from a ready-made agent
  4. Click + New agent in the top-right to create a new agent
  5. Click any agent row to open and edit its prompts, voice, and workflow

Step 2 — Choose How to Start

Pick a template for a quick start, or build a blank agent for full control.

New agent page with templates
  1. Click Browse templates to see all 59+ ready-made agent templates
  2. Or pick a Popular Starter like "Customer support" or "Appointment booking"
  3. Or click Blank agent at the bottom to start from scratch

Step 3 — Browse & Select a Template

Templates come with pre-built conversation flows, prompts, and workflows.

Browse agent templates
  1. Use the search bar to find a specific template (e.g. "appointment", "sales")
  2. Filter by category: General, Sales, Support, Booking, Healthcare, Education
  3. Click a template card on the left to preview its workflow on the right
  4. Review the conversation flow steps (Start → Greeting → Collect info → Confirm → End)
  5. When satisfied, click Use template in the top-right

Step 4 — Configure Your Agent

Set the agent name, first message, and system prompt. The workflow preview updates live on the right.

Configure new agent
  1. Enter an Agent name (e.g. "Appointment Booking")
  2. Write the First message — what the agent says when the call connects
  3. Edit the System prompt to define the agent's role, tasks, and rules. Click Generate to auto-write one with AI
  4. Review the Workflow diagram on the right to understand the call flow
  5. Click Continue to studio when ready

Step 5 — Set Voice & Final Settings

Choose a voice, language, and link knowledge bases before creating the agent.

New agent voice and settings
  1. On the left: refine your System prompt and First message. Use variables like {{name}}, {{email}}, {{phone}}
  2. On the right under Identity: set agent name and Language
  3. Under Voice: browse Standard voices or the Voice library (your clones). Click the ▶ play icon to preview each voice
  4. Under Advanced: expand to link Knowledge bases and set escalation rules
  5. Click Create agent at the bottom-right to finish
💡 Tip Click "Preview" next to the first message to hear how it sounds with the selected voice before creating the agent.

Test Voice Agent

Test your voice agent with a real outbound call before going live.

Making a Test Outbound Call

Fill in the details to initiate a test call from your agent.

Test outbound call dialog
  1. Go to AI → Test voice agent in the sidebar (under AI section)
  2. In the Test Outbound Call dialog, select an Agent from the dropdown
  3. Select an Agent Phone Number (must have outbound support configured)
  4. Choose a Caller Provider (default: SIP)
  5. Enter the Customer Phone Number, Customer Name, and Customer Email
  6. Click Start test call to initiate the call
⚠️ Important You need an outbound phone number configured under Configuration → Phone before you can make test or outbound calls. See the Phone Numbers section below.

Batch Call Campaigns

Call many contacts at once with your voice agent — perfect for outreach, reminders, and follow-ups.

Why use batch calls?

Instead of calling contacts one by one, batch calls let your voice agent call an entire list automatically — from a CSV upload or a saved contact list. Great for appointment reminders, sales outreach, or survey calls.

What happens after?

The platform dials each contact using your chosen agent and phone number. Call outcomes appear in Conversations (as transcripts) and you can track batch status under View Batch Calls. Use Analytics to see call minutes used.

Step 1 — Create a Batch Call

Set up who to call, which agent handles the call, and when to start.

Create batch call campaign
  1. Go to Campaigns in the left sidebar
  2. Click + Batch Call in the top-right (or use the create form on the Campaigns page)
  3. Enter a Batch name (e.g. "Q1 Customer Outreach") — required, helps you identify this campaign later
  4. Select a Source Phone Number — must have outbound support (set up under Configuration → Phone first)
  5. Select an Agent — the voice agent that speaks on each call (create one under AI → Agents first)
  6. Choose Start time: Start now for immediate launch, or Schedule date and time for later
  7. Target concurrency limit (optional) — how many calls run at the same time. Leave empty to use platform default
  8. Add Recipients:
    • Upload via CSV — file must include headers: name, email, phone_number (or first_name + last_name)
    • Use existing contact list — pick a list you created in Contacts
  9. Click Submit a Batch Call when all required fields are filled
⚠️ Before you start You need: (1) an outbound phone number, (2) at least one voice agent, (3) a contact list or CSV. The Submit button stays disabled until everything is ready.

Step 2 — View & Track Batch Calls

Monitor running and completed batch jobs from the Batch Calls list.

View batch calls list
  1. From Campaigns, click View Batch Calls in the top-right
  2. The Batch Calls page lists all your outbound batch jobs
  3. Click Create Batch Call here to start a new campaign
  4. Click the refresh icon to update the list with latest status
  5. When batches are running, you'll see each job here with its status. When empty, it shows "No batch calls found" until you create your first one
  6. Individual call transcripts from batch campaigns also appear in Conversations under the Voice Calls channel

Conversations Inbox

One place for every customer message — WhatsApp, website chat, Instagram, Facebook, phone transcripts, and more.

Why use Conversations?

Without it, messages are scattered across apps. Conversations puts every customer interaction in one inbox so your team can reply, review AI responses, and take over when needed.

What happens after?

Messages from all connected channels land here automatically. AI replies first using your chatbot settings. You can Take Control to reply manually, or get an email alert when escalation rules trigger.

Using the Conversations Inbox

All inbound messages and call transcripts from every connected channel land here.

Conversations inbox
  1. Click Conversations in the left sidebar
  2. Use channel filters at the top (All Channels, Website Chat, WhatsApp, Instagram, Facebook, Telegram, Voice Calls, Auto Dialer)
  3. Use the date range picker (e.g. Last 7 days) and Folders to organize threads
  4. Click any conversation thread in the left list to open it and read the full history
  5. Type a reply in the message box at the bottom and press Send — it goes out on the same channel the customer used
  6. Use Take Control to pause AI and reply manually on an active thread
💡 Tip By default, your AI chatbot handles first-line responses. Use "Take Control" when you need to step in for sensitive cases, sales closes, or when the bot is stuck.

Chatbot Configuration

Style and train the AI that answers visitors on your website, WhatsApp, Instagram, and Facebook.

Why configure the chatbot?

This is where you set how your AI looks (logo, color, name) and how it behaves (greeting, personality, language). Link your knowledge base so it answers from your content, not generic AI responses.

What happens after?

Visitors see your branded chat widget on the website. AI handles first-line questions 24/7. When escalation rules fire (e.g. "visitor asks for human"), you get an email with the conversation context.

Customization — Appearance & Branding

Go to Configuration → Chatbot to style your widget.

Chatbot customization
  1. Navigate to Configuration → Chatbot
  2. Logo: Click the upload box to add your brand logo to the chat widget
  3. Chatbot Name: Enter the name shown in the widget header (e.g. "AI Assistant")
  4. Widget Color: Pick a preset color or enter a custom hex code (e.g. #6366f1)
  5. Default Knowledge Bases: Click the dropdown to select which knowledge bases the chatbot uses. Click Select All or Clear as needed
  6. System Prompt: Write the AI personality and behavior rules. Use Generate for AI-assisted writing, or pick a previous prompt from the dropdown

Behavior — Escalation, Greeting & Language

Configure when humans get alerted and how the bot greets visitors.

Chatbot behavior settings
  1. Escalation alert condition: Write in plain English when you need a human (e.g. "When user asks for a human"). Or click a prebuilt condition tag like "Appointment booked", "Visitor asks for a human", "Complaint or frustration"
  2. When triggered, you receive an email with context and a link to the conversation
  3. Greeting Message: Set the message shown after the visitor enters their name. Use {{name}} as a placeholder (e.g. "Hello {{name}}! How can I help you today?")
  4. Language: Select the primary language from the dropdown (e.g. English)
  5. Click Save Changes at the bottom to apply all settings
ℹ️ Note Voice phone escalation is configured separately under Configuration → Phone, not on this page.

Chatbot Test & Widget

Preview and test your chatbot before it goes live on your website and social channels.

Step 1 — Test in the Sandbox

Evaluate how your chatbot responds with your chosen knowledge base, tone, and prompt.

Chatbot test page
  1. Go to Chatbot Test in the sidebar
  2. On the right Sandbox testing panel: pick a Knowledge base, Tone, and Character
  3. Type a message in the sandbox chat to see how the AI responds
  4. Copy the Live preview link with Copy Link, or click Preview chatbot to open it
  5. Expand Optional: website embed code to get the snippet for your site
ℹ️ Note The sandbox is for experiments only. When satisfied, apply the same settings under Configuration → Chatbot so they take effect on Facebook, WhatsApp, and Instagram.

Step 2 — How the Widget Looks to Visitors

This is the chat widget your customers see on your website.

Chatbot widget preview
  1. The widget shows your configured chatbot name, color, and greeting
  2. Visitors type in the "Type your message..." box and press the send button (paper plane icon)
  3. Paste the embed snippet into your website's HTML before the closing </body> tag to go live

Phone Numbers

Connect phone lines so voice agents can make and receive real phone calls.

Why add phone numbers?

Voice agents need a real phone line to work. Outbound numbers let agents call customers. Inbound numbers let customers call in and talk to your agent. Without a number, agents can only be tested — not used live.

What happens after?

Outbound numbers power test calls, batch campaigns, and one-off outbound calls from Agent Studio. Inbound numbers route incoming calls to the voice agent you assign. All call logs sync to Conversations.

Phone Configuration Overview

Navigate to Configuration → Phone to manage your numbers.

Phone configuration page
  1. Go to Configuration → Phone
  2. The page shows two sections: Outbound numbers and Inbound numbers
  3. Summary cards at the top show your current count for each type
  4. Click Add outbound number to set up a number for making calls
  5. Click Add inbound number to set up a number for receiving calls

Option A — Import via Twilio (Full Setup)

Connect a Twilio phone number for outbound calling.

Add number via Twilio
  1. Click Add outbound number on the Phone page
  2. Select Full Setup (left card) — for Twilio numbers used by outbound agents
  3. Fill in the required fields:
    • Label — a friendly name (e.g. "Customer Support Line")
    • Phone Number — your Twilio number (e.g. +12625925656)
    • Provider Account SID — from your Twilio Console
    • Provider Auth Token — from your Twilio Console
  4. Click Import phone number to complete

Option B — Generic SIP Trunk

Connect any SIP provider (including Twilio) for inbound and/or outbound.

SIP trunk configuration
  1. Click Add outbound number or Add inbound number
  2. Select Generic SIP Trunk (right card)
  3. Check Supports Inbound and/or Supports Outbound based on your needs
  4. Fill in: Label, Phone Number, Provider
  5. For outbound: enter SIP Address, Username, Password, Media Encryption, and Transport
  6. Click Create SIP trunk to save

Automations

Automate repetitive work — when something happens, the platform does the next step for you. No coding needed.

Why build automations?

Examples: when a call ends → send your team an email digest. When a lead form is submitted → add to Google Sheets. When someone messages on chat → notify your team. Automations save hours of manual follow-up.

What happens after?

Once you toggle an automation to Active and save, it runs automatically every time the trigger event happens. Check Executions to see run history and confirm it's working.

Step 1 — Start a New Automation

Begin from a template or a blank workflow.

Automations empty state
  1. Go to Automations in the sidebar
  2. Click Browse templates or the + New automation button
  3. Pick a Popular Starter such as "Inbound Call → Email Conversation Digest" or "Batch Call → Appointment Booking"
  4. Or click Blank automation to build from scratch

Step 2 — Browse Automation Templates

Preview prebuilt workflows before using them.

Browse automation templates
  1. Filter templates by All, Calls, Email, or CRM
  2. Click a template card to preview its workflow steps on the right
  3. Review each step: Trigger (what starts it) → Actions (what happens) → Conditions (logic gates)
  4. Click Use template to create your automation from the template

Step 3 — Automation Builder

Edit, add steps, and activate your automation workflow.

Automation workflow builder
  1. Step 1 (Trigger): The event that starts the workflow (e.g. "Inbound Chatbox Message")
  2. Step 2+ (Actions): What the system does automatically (e.g. "Send Email")
  3. Click the + button between steps to add new actions or conditions
  4. Each step shows "Setup done" when configured correctly
  5. Toggle the Inactive → Active switch at the top-right to turn on the automation
  6. Click Save at the bottom-right to save changes
  7. Click Executions to view run history and logs
⚠️ Important Automations won't run until you toggle them from "Inactive" to "Active" and click Save.

Analytics Dashboard

See how your AI is performing — conversations, call minutes, channel breakdown, and usage over time.

Why check analytics?

Know if your AI is actually being used. See which channels get the most messages, how many call minutes you've consumed, and whether conversations are growing — so you can plan capacity and improve your setup.

What happens after?

Use the date range picker to review any period. Filter by channel to compare WhatsApp vs website chat vs voice. Call minutes help you track billing and plan outbound campaign volume.

Reading Your Analytics

Filter by time range, channel, and team to understand your platform usage.

Analytics dashboard
  1. Click Analytics in the sidebar
  2. Select a time range: Today, Yesterday, Last 7 days, Last 30 days, or Custom
  3. Filter by channel: All Channels, Website Chat, WhatsApp, Instagram, Facebook, Telegram, Voice Calls
  4. Review the KPI cards: Call Minutes, Conversations, Chat Threads, Avg Duration, Active Channels
  5. Green arrows show growth trends compared to the previous period
  6. Scroll down for charts: Call Minutes Over Time and Conversations Over Time
  7. Click Export to download a CSV report, or Refresh to update data
  8. Check your Balance badge in the top-right for remaining voice call minutes

CRM

Store structured business data in tables, then let your voice agents and chatbot search, create, and update records during live conversations.

Why use CRM tables?

Contacts hold people. CRM tables hold structured data — leads, bookings, deals, support tickets, or any custom records with columns you define. This lets AI read and write real business data, not just chat.

What happens after?

Once a table exists and tools are registered, your voice agent can look up a customer on a call, create a new lead, or update a record. Your chatbot can do the same in website chat. Data stays in your CRM table for your team to use.

Step 1 — Create a CRM Table

Every CRM setup starts with at least one table. You can create empty tables or import from CSV/Excel.

CRM tables empty state
  1. Click CRM in the left sidebar — you'll land on the CRM Tables view
  2. If you have no tables, click Create your first table in the center
  3. Or click + New Table in the top-right to create a table manually
  4. Name your table (e.g. "Leads", "Appointments", "Support Tickets") and add columns (name, email, phone, status, etc.)
  5. To import existing data: click Import to existing or use the Import link in the top bar with a CSV/Excel file
  6. Once created, your table appears in the list with a record count
ℹ️ CRM top navigation From the CRM page you can switch between: Tables (manage data), Voice Agents (attach CRM to phone agents), and Chatbot (attach CRM to website chat).

Step 2 — Attach CRM to a Voice Agent

Let your phone agent search, create, and update CRM records while on a live call.

CRM voice agents setup page

Example use case

A caller says "I want to book an appointment." Your voice agent searches the CRM for existing records, creates a new booking row, or updates an existing one — all during the call, without a human typing.

After setup

On live calls, the agent can run Search (find a record), Create (add new row), and Update (change existing data). Primary key fields tell the system how to match records (e.g. by phone number or email).
  1. From CRM, click Voice Agents in the top navigation
  2. You must already have a voice agent created under AI → Agents. If none exist, create one first
  3. On the left, browse Available Voice Agents or search by name/agent ID
  4. Click an agent card or Open setup → to open its CRM configuration page
  5. Step 1 — Choose a CRM table: Select which table this agent can access (e.g. "Appointments")
  6. Step 2 — Set primary keys: Pick column(s) used to match records (e.g. phone, email). The agent uses these to find the right row
  7. Step 3 — Register tools: Click Register tools for [table name] and configure:
    • Create record (POST) — agent adds a new row when caller provides info
    • Search record (GET) — agent looks up existing data by primary key
    • Update record (PATCH) — agent changes fields on an existing row
  8. Write a clear description for each tool so the AI knows when to use it during the call
  9. Save — the tools are now attached to that voice agent for live calls

Step 3 — Attach CRM to Your Chatbot

Let website visitors search, create, and update CRM records through live chat.

Example use case

A visitor on your website says "I'd like to register for the webinar." The chatbot creates a new row in your Leads table with their name and email — automatically, during the chat.

After setup

CRM tools are registered per user and used by the chatbot service. When a visitor's message matches a tool description, the chatbot reads or writes CRM data. Records appear in your CRM table immediately.
  1. From CRM, click Chatbot in the top navigation
  2. You need at least one CRM table created first (Step 1 above)
  3. Step 1 — Choose a CRM table: Click the table card your chatbot should access (e.g. "Leads")
  4. Click Register tools for [table name]
  5. Configure the same three tools as voice agents:
    • Create record — chatbot adds new data from the conversation
    • Search record — chatbot looks up existing records
    • Update record — chatbot updates fields on a matched record
  6. Select primary key columns for matching records (click column chips to toggle)
  7. Write descriptions in plain English for when each tool should run
  8. Register each tool — they're now active for your website widget and dashboard chat
💡 CRM vs HTTP tools CRM tools read/write data inside CandexAI tables. HTTP tools call your external APIs. Use CRM tools for data you store in the platform; use HTTP tools for external systems you already have.

Contacts

Your customer database — everyone you call, message, or run campaigns to.

Why manage contacts?

Contacts are the people your AI talks to. Store names, emails, phones, and organize them into lists and tags so batch campaigns and automations target the right audience.

What happens after?

Contact lists appear when creating batch call campaigns. Individual contacts can be selected for outbound test calls. Imported contacts sync across the platform for outreach and CRM workflows.

Managing Your Contacts

Your contact database powers campaigns, outbound calls, and CRM.

Contacts page
  1. Go to Contacts in the sidebar
  2. Click + Add contact to add a single contact manually
  3. Click + Add list to create a new contact list for segmentation
  4. Use the search bar to find contacts by name, email, or phone across your entire database
  5. Use the time filter (All time) and column headers to sort and filter
  6. Use the edit (pencil) and delete (trash) icons in the Actions column to manage each contact
  7. Adjust Per page (30 / 60 / 90 / Custom) at the bottom to control list size
💡 Tip Contact lists created here can be selected directly when setting up a Batch Call campaign.

Integrations

Connect external platforms so messages, data, and actions flow into CandexAI automatically.

Why connect integrations?

Each integration unlocks a channel or data source: WhatsApp/Instagram/Facebook for messaging, Gmail for email automations, HubSpot/Salesforce/Zoho for CRM sync, Google Workspace for calendar and sheets, Shopify for product data.

What happens after?

Connected channels start sending messages to Conversations. CRM integrations sync data to your tables. Gmail enables email tools and automations. Connected tools also appear as actions in the Automation builder.

Productivity & CRM Integrations

Connect Google Workspace, Calendly, HubSpot, Salesforce, and Zoho CRM.

Integrations CRM and productivity
  1. Go to Integrations in the sidebar (or Settings → Integrations)
  2. Use the category tabs: All, Productivity, CRM, E-commerce, Channels, Custom
  3. Use the search bar to find a specific integration
  4. Google Workspace: Click Connect to enable Sheets export, Drive storage, and Calendar scheduling
  5. Calendly: Click Connect to let visitors book appointments through your chatbot
  6. HubSpot / Salesforce / Zoho CRM: Click Connect on each to sync contacts, leads, and deals

Channels, E-commerce & Email

Connect messaging platforms, online stores, and email.

Integrations channels and ecommerce
  1. Shopify: Click Connect to link your store via OAuth
  2. WooCommerce: Click Connect for WordPress e-commerce integration
  3. Outlook Calendar: Click Connect for Microsoft calendar and mail automation
  4. WhatsApp Business: Click Connect — you'll need Access Token, Phone Number ID, and WABA ID
  5. Instagram Direct: Click Connect — needs Access Token, Instagram Account ID, and Page ID
  6. Facebook Messenger: Click Connect — needs Page Access Token and Page ID
  7. Telegram Bot: Click Connect — needs Bot Token from @BotFather
  8. Meta Lead Ads: Click Connect for lead form automations
  9. Gmail: Click Connect to send and receive emails
💡 Tip Each integration shows "Not connected" status until you complete the OAuth or credential setup. Click "Refresh status" at the top to update connection states.

Team Members

Invite colleagues to collaborate in your workspace.

Inviting Team Members

Go to Team in the sidebar to manage your workspace collaborators.

Team members page
  1. Go to Team in the sidebar (Settings → Team)
  2. In the "Invite by email" section, type your colleague's email (e.g. colleague@company.com)
  3. Click Send Invite — they'll receive an email with a link valid for 7 days
  4. View Active members in the list below with their roles (Owner, Member)
  5. Check Pending invitations to see invites that haven't been accepted yet

Profile & Billing

Manage your account information, security, and subscription.

Account Settings

Update your profile, company details, and password.

Profile settings page
  1. Go to Billing and Subscription in the sidebar (or click your avatar → Settings)
  2. Switch between Profile and Billing tabs at the top
  3. Avatar: Click Change photo to upload a profile picture (JPG, PNG, WebP · max 5 MB)
  4. Account Information: Fill in Name, Email, Phone, Company Name, Website, VAT, and Address fields
  5. Click Save Profile to save your details
  6. Security: Enter Current Password, New Password, and Confirm New Password
  7. Click Update Password to change your password

🚀 You're Ready to Go!

Follow the 5-step quick start at the top of this guide, and you'll have your AI platform running in minutes.

Open CandexAI Platform → Back to Quick Start