Core overview

Lower-level Landbot client for connecting a custom UI to the Landbot messaging engine.

Landbot.Core connects a user interface to the Landbot messaging database and app services. It's the layer the Widgets SDK sits on top of — Landbot v3 widgets use a Landbot.Core instance internally to do all the conversation plumbing.

Reach for Core when you want full control over the chat UI: a custom rendering engine, a native mobile app, a non-standard chrome on top of the Landbot conversation engine. If you only need to drop a Landbot into a website with a builder-driven design, the Widgets SDK is the easier path.

In this section

• Install — Pull @landbot/core from npm, import it, and create a Core instance from a bot config URL.

• API — Methods, pipelines, and events. The Core surface for sending and receiving messages and reacting to bot state.

• Example — End-to-end worked example wiring Core to a minimal custom UI.

Tip Prefer a guided build? The cookbook recipe Build a custom chat UI with @landbot/core walks through a complete, runnable example — from config URL to sending replies — in a single copy-paste HTML file, no build step.

Package

@landbot/core is published to npm: npmjs.com/package/@landbot/core.