Connic
Back to templates

Email Helpdesk

End-to-end email support with IMAP polling, auto-reply filtering, and intent classification. Drafts contextual replies from your knowledge base.

communicationintermediateEmailView on GitHub
connic init my-project --templates=email-helpdesk
Quickstart

Overview

Polls an IMAP mailbox for new emails, filters auto-replies and spam with StopProcessing middleware, classifies by intent/urgency/department, and drafts contextual replies using the full knowledge base CRUD (query, store, and delete). Replies are sent automatically via the SMTP outbound connector. Middleware extracts sender metadata into context for personalized responses. Supports multilingual replies matching the sender's language.

Use cases

Support inbox automation

Automatically triage and respond to support emails from a shared mailbox, filtering noise and drafting helpful replies.

Knowledge maintenance

Auto-update the knowledge base as new solutions are discovered; remove outdated entries using delete_knowledge.

Multilingual support

Detect the sender's language and draft replies in the same language for international customer bases.

Architecture

IMAP Inbox
helpdesk-pipeline
email-classifier
email-responder
Knowledge Base
SMTP Outbound

Scaffolded project structure

Running connic init my-project --templates=email-helpdesk creates this file tree.

email-helpdesk/
  agents/
    email-classifier.yaml
    email-responder.yaml
    helpdesk-pipeline.yaml
  tools/
    helpdesk_tools.py
  middleware/
    email-classifier.py
  schemas/
    email-classification.json
    email-reply.json
  requirements.txt
  README.md

Get started

Install the template, create a Connic project, and deploy. Choose Git (automatic on push) or CLI (works with any provider).

Prerequisites

  • Python 3.10+
  • A Connic account (create a project first)
  • API key for your LLM provider (e.g. Gemini, OpenAI) to add in project variables
Create project
1

Install and scaffold

Install the SDK and create a project from this template.

terminal
pip install connic-composer-sdk
connic init my-project --templates=email-helpdesk

Then cd my-project

2

Deploy

Pick your deployment method. Git auto-deploys on push; CLI works with GitLab, Bitbucket, or no Git.

Git integration

  1. In Connic: Project Settings → Git Repository, connect your GitHub repo
  2. Settings → Environments: map branch (e.g. main) to Production
  3. Push your scaffolded project to that repo
terminal
git add .
git commit -m "Add Email Helpdesk template"
git push origin main

CLI deploy

  1. In Connic: Project Settings → CLI, create an API key and copy project ID
  2. Run connic login in your project folder
  3. connic test to try with hot-reload, or connic deploy for production
terminal
connic login
connic test    # Ephemeral dev env with hot-reload
connic deploy # Deploy to production
3

Connect and configure

Add an Email inbound (IMAP) connector to poll your mailbox and an Email outbound (SMTP) connector to send replies. Provide your mail server credentials for both. Add your LLM provider API key in Project Settings → LLM Provider API Keys.

Full connector setup guideQuickstart guideConnector docs

Template source

Browse the full template, contribute improvements, or fork for your own use.

connic-org/connic-awesome-agents/tree/main/email-helpdesk

Explore other templates

View all

PostgreSQL Change Notifier

Monitor PostgreSQL changes via LISTEN/NOTIFY, classify events by impact, and route notifications to the right team. Stores high-impact changes for auditing.

Kafka Fraud Detector

Score transactions for fraud in real-time on Kafka streams. Uses velocity analysis, geo-anomaly detection, and pattern matching per customer.

S3 Document Pipeline

Auto-process documents uploaded to S3 with text extraction, classification, and routing. Handles PDFs, images, and text files with retries.

Lead Enricher

Enrich and qualify new signups by researching their company and scoring fit against your ideal customer profile. Saves qualified leads.