Skip to content
Youssef Alouani
← Public chatbots on Botpress, Rasa and an in-house engine

Deep dive · Qalqul Engine · shipped

Qalqul: Botpress integration

Integrating Botpress v12 into Qalqul's contact-centre suite, so bots, human agents and tickets share one conversation and hand-off path.

Problem

Qalqul’s clients, banks, insurers, healthcare and retail, wanted bots on their channels that could answer the routine questions and hand the rest to an agent with the context intact. Botpress v12 gave a strong bot runtime, but on its own it was a separate product next to the contact centre.

Constraints

  • Hand-off without loss: an agent picking up a bot conversation sees the whole exchange and what the bot understood.
  • Client-specific understanding: Arabic, French and Darija, with each client’s own intents.
  • Embedded everywhere: the same bots run in web widgets, mobile SDKs and messaging channels.

Architecture

Botpress inside QalqulMessages from chat widgets, SDKs and channels reach the Qalqul conversation layer, which routes them to Botpress v12. Botpress uses Qalqul's NLU engines for understanding. When the bot hands off, the conversation moves to an agent queue with its history, and outcomes are written to the contact profile and tickets.EntryReact chat widgetsBrowser & Kotlin SDKsChannelsConversationQalqul conversation layerWebSocketsBots & agentsBotpress v12core and modulesNLU enginesAgent hand-offqueues · tickets
Qalqul contact profile with demographic and geographic data and histories for calls, SMS, email, discussions, leads and tickets
Bot conversations land in the same contact history as calls, emails and tickets.

Key decisions

  1. Bots are participants, not a separate product. A bot is one more participant in a Qalqul conversation, so hand-off is a routing decision, not a migration.
  2. Own the understanding. Botpress calls Qalqul’s NLU engines for intents and entities.
  3. Work in Botpress core where needed. Some integration needed changes in Botpress v12 itself, not just a plugin.

Results

Numbers to come.

Stack and links