Skip to content
Docs
API reference Go to dashboard
DocsInbox & AI Replies

Inbox & AI Replies

A shared inbox for all customer channels: email, Instagram, WhatsApp and the widget's webchat all come together in one place. The AI proposes grounded replies — and only takes over on its own once it has proven itself for a given topic area. Uncertain or sensitive cases go to your team.

The Shared Inbox

The inbox brings together all incoming customer conversations across every channel in a single view. You'll find it in the console under Inbox. Every conversation is a thread with the full history, customer context and the associated channel — whether the message arrived by email, via Instagram, WhatsApp or webchat.

At a glance, each thread shows you:

ElementDescription
ChannelHow the message arrived — email, Instagram, WhatsApp or webchat.
HandlerWhether the AI is replying or a human has taken over the conversation.
MaturityThe AI's phase for the detected topic: Shadow, Copilot or Autopilot.
HistoryThe complete message history, including AI suggestions and sent replies.
Duplicate messages are detected and merged via a unique message ID — even if a channel delivers the same incoming message multiple times, no duplicate thread and no duplicate reply is created.

Channels

Alpheris connects the following channels to the inbox. You set up the connection in the console under Email or Integrations.

Email
Outlook / Microsoft 365 via Microsoft Graph, plus a generic mailbox via SMTP/IMAP.
Instagram
Instagram direct messages and comments via the Meta connection (OAuth).
WhatsApp
WhatsApp conversations via the official Meta connection (OAuth).
Webchat
Conversations from the chat widget on your website also land in the inbox.

Email

For email, Alpheris supports three connection methods:

  • Outlook / Microsoft 365: connection via Microsoft Graph — the standard method for Microsoft mailboxes.
  • SMTP / IMAP: a generic method for any other mail server where no OAuth connector is available.

Incoming mails land as threads in the inbox, and outgoing replies go back out through the same connected mailbox. The AI learning and ticket logic (see Maturity) is designed above all for the email channel.

Instagram & WhatsApp

Instagram and WhatsApp are connected via Meta. You authorize the connection via OAuth; incoming messages reach Alpheris through signed webhooks from Meta. For WhatsApp, this includes a verify-token handshake during setup. Incoming events are verified server-side by signature so that only genuine Meta events are processed — details on this under Webhooks.

On messaging channels, Meta's platform rules apply — such as the time windows within which you may reply freely to the customer. Alpheris only sends within these permitted windows; outgoing messages after that are subject to the rules of WhatsApp or Instagram.

AI Reply Suggestions

For every incoming customer message, the AI generates a reply that is grounded in your knowledge base — that is, in the crawled website content, uploaded documents and (for Shopify) your product catalog. The suggestion is produced through hybrid retrieval (full-text plus vector search with subsequent reranking), so that the reply is tied to concrete sources rather than being made up.

For each suggestion, the system determines a confidence from retrieval signals such as source coverage and match quality. This confidence governs whether a suggestion is only shown as a draft or may be sent automatically.

The AI automatically adapts tone and length to the channel:

ChannelStyleLength
Emailformal, with a formal salutationmedium
Webchatbalanced, neutral salutationmedium
WhatsAppfriendly, casualshort
Instagramfriendly, casualshort

You configure the personality and reply rules of your AI agent under AI Agent. If a customer replies in another language, Alpheris detects it automatically and answers in the same language — more on this under Multilingual.

Maturity: Shadow → Copilot → Autopilot

Alpheris does not hand full control to the AI from day one. Instead, the AI goes through a three-stage maturity model per topic area (intent cluster, e.g. shipping questions, returns, product questions). Each topic area is assessed and unlocked individually — so the AI can already be running on Autopilot for shipping questions while product questions are still in Copilot.

1
Shadow (default)
The AI generates suggestions in the background and learns along the way, but sends nothing. You see the suggestions in the inbox and reply yourself. This is how the system gathers evidence of how well the AI performs in this topic area.
2
Copilot
The AI presents ready-made reply drafts. Your team reviews them, adjusts them if needed and sends with one click. Every acceptance or correction feeds back into the assessment of the topic area.
3
Autopilot
Once the topic area has proven itself, the AI may send replies on its own — provided the confidence is high enough in the individual case and the channel has been enabled for auto-reply.

Promotion to Autopilot is tied to hard thresholds — nothing is unlocked on gut feeling alone:

  • At least 50 accepted suggestions in this topic area.
  • An acceptance rate of at least 75% (the share of AI suggestions adopted without significant correction).
  • The topic area must be qualified: at least 5 cases, and the assessment must not be too old (a 14-day window).

The minimum confidence required per individual reply decreases as the topic area matures: 0.85 by default, 0.78 for established topics and 0.72 for fully matured topics. If a specific suggestion falls below the respective threshold, it is not sent automatically but remains a draft.

Complaints always stay with a human. The "Complaint" topic area is permanently excluded from Autopilot — such conversations do receive suggestions, but they are never sent automatically; they are always handled by your team.

Auto-Reply: Gating & Control

Auto-reply — that is, autonomous sending by the AI — is not an all-or-nothing switch. You control per shop whether and how automatic sending happens. Under Inbox in the console, you define:

  • Auto-reply on/off as a global switch for autonomous sending.
  • Enabled channels — auto-reply can be activated specifically for certain channels only.
  • Confidence threshold — only from this value may a suggestion be sent automatically; below it, a draft is created for human review.

In addition, the send mode per channel determines what happens with a finished suggestion:

ModeBehaviorDefault for
Draft first (draft_first)The AI presents a draft, and a human sends it.Email
Send directly (direct_send)With sufficient confidence, the AI sends itself.Webchat, WhatsApp, Instagram

You can set the send mode globally or differentiate it per channel via the by_channel mode — for example, deliberately keeping email on "Draft first" while webchat sends directly. This way, several gates interlock before a message goes out automatically.

An AI reply is only sent automatically when all gates are open: auto-reply is active, the channel is enabled, the topic area is on Autopilot (and not locked), and the confidence of the specific suggestion is above the threshold. If even one condition is missing, it stays a draft.

Quota & Abuse Protection

So that a faulty loop or a wave of incoming messages never leads to a burst of automatic replies, AI sending is rate-limited and safeguarded against abuse. If limits kick in or the system detects unusual patterns, Alpheris falls back to draft mode and hands off to your team instead of continuing to send uncontrolled. Incoming content is also checked for prompt-injection attempts so that injected instructions cannot subvert the AI.

Escalation & Handoff to Humans

The AI is built to hand off rather than guess when in doubt. A handoff to your team is triggered, among other things, when:

  • the confidence is too low — the knowledge base does not sufficiently cover the question;
  • the topic area is not yet on Autopilot (Shadow or Copilot);
  • it is a locked topic area (e.g. complaints);
  • quota or protection mechanisms kick in.

Here's how the handoff works in practice:

1
The AI detects the need for a handoff
One of the conditions above applies. Instead of sending automatically, the AI flags the conversation for human handling and — where possible — attaches a draft.
2
The conversation lands in the inbox
The thread appears in the shared inbox for handling — with the full history, customer context and the AI draft as a starting point.
3
A human takes over
Your team reviews the draft, adjusts it or writes their own — and sends via the same channel the message arrived on.
4
Feedback flows back
Every acceptance or correction of a suggestion raises or lowers the respective topic area — so the AI matures over time toward Autopilot or deliberately stays in Copilot.
The maturity model is self-correcting: if a topic area's acceptance rate drops again, it falls back from Autopilot to Copilot — the AI then only sends on its own again once it has proven itself anew.

Inbox via API

The inbox can also be driven programmatically — for example, to mirror threads into your own helpdesk or to reply from an external system. Available operations include listing threads and sending a reply to a thread. API access is limited to the Business and Enterprise plans; authentication is via API key. You'll find endpoints and examples in the API Reference and under Custom API.

For privacy, data location (EU/Germany) and data processing when handling customer messages, see Security & Privacy.