Quill CRM
AI Assistant article

AI Assistant Overview

The QuillCRM AI Assistant is an intelligent CRM copilot that lives inside your QuillCRM dashboard. It can answer questions about your CRM data, execute actions like creating contacts and deals, draft emails, and provide insights — all through a natural language chat interface.

Key Features

  • Chat Panel — A slide-over panel accessible from any QuillCRM page. Open it with the floating button or the Ctrl+K / Cmd+K keyboard shortcut.
  • Tool Calling — The AI can take real CRM actions on your behalf: search contacts, create deals, tag contacts, draft emails, view pipeline analytics, and more.
  • Context-Aware — The assistant automatically detects what page you’re on (contact, deal, campaign, or dashboard) and tailors its responses and suggestions accordingly.
  • Conversation History — Conversations are saved and can be resumed later. Browse and manage your history from the panel header.
  • Streaming Responses — Responses stream in real-time via Server-Sent Events (SSE), so you see the AI thinking and acting as it works.
  • Role-Based Access — Administrators always have access. Additional CRM roles (CRM Manager, Sales Manager, Sales Rep) can be granted access.
  • Data Governance — Granular toggles control which data categories the assistant may read: CRM data, conversations, campaigns, and activity logs.
  • Business Context — Configure your industry, brand voice, product description, and custom instructions to shape AI responses to match your business.

Requirements

Requirement Details
QuillCRM Pro Version 1.8.0 or later must be installed and active
AI Provider An AI provider must be configured in Settings → AI (OpenAI, Anthropic, Google Gemini, or a custom OpenAI-compatible provider)
WordPress 5.8 or later
PHP 7.4 or later

How It Works

The AI Assistant is a separate addon plugin (QuillCRM AI Assistant) that extends QuillCRM Pro. It does not bundle its own AI provider — it reuses the shared AI provider you configure in Settings → AI (the same one used by the AI Email Builder and AI Text Generation features).

When you send a message, the assistant:

  1. Detects your current page context (contact, deal, campaign, or dashboard) and enriches the prompt with relevant CRM data.
  2. Injects your business context, product documentation, and custom instructions into the system prompt.
  3. Calls the AI provider with your message and available CRM tools.
  4. If the AI decides to use a tool (e.g., search contacts), it executes the tool and feeds the result back to the AI for a final response.
  5. Streams the response back to you in real-time.
  6. Saves the conversation for future reference.

Architecture

The AI Assistant uses a multi-turn orchestration loop with up to 5 iterations per message. In each iteration, the AI can choose to call one or more CRM tools before composing its final response. This allows it to gather information, take actions, and then summarize what happened — all in a single conversation turn.

The assistant respects the same role-based permissions as the rest of QuillCRM. Sales reps only see their own deals and tasks through the AI, just as they would in the regular UI.