Connect Langflow to Mattermost
Step-by-step guide to running your Langflow app as a Mattermost bot with LangBot: Langflow setup, bot credentials, networking, testing and troubleshooting.
This recipe puts your Langflow app behind a Mattermost bot. LangBot receives messages from Mattermost, runs them through a pipeline, and sends the answer back, so you do not write any platform code.
Langflow builds agents and flows with a drag-and-drop editor. LangBot runs a flow through the Langflow API for every message.
What you need
- A running LangBot instance: LangBot Cloud (no server needed) or a self-hosted deployment with Docker or
uvx langbot. - A Langflow account or instance that LangBot can reach over the network.
- A Mattermost bot account (role
Member) and its access token, plus your Mattermost server URL.
Networking
LangBot only needs to reach your Mattermost server; Mattermost does not need to reach LangBot.
1. Prepare Langflow
- Build a flow in Langflow (the Simple Agent template is a good start).
- Create an API key under Settings.
- Copy the Flow ID from Share → API access.
2. Create a pipeline
Open Pipelines in the LangBot WebUI, create a pipeline (or edit the default one) and set AI as follows. If the runner is not listed, install the official runner plugin from Plugins or the LangBot Space marketplace.
| Field | Value |
|---|---|
| Runner | Langflow (official Langflow Agent runner plugin) |
| Base URL | Your Langflow address, reachable from LangBot |
| API Key | The Langflow API key |
| Flow ID | The flow to run |
3. Create the Mattermost bot
- Create the bot account in Mattermost (choose
post:allfor direct messages) and copy its token; it is shown only once. - Create a bot with the Mattermost adapter, enter the server address and token, and bind a pipeline.
4. Bind and test
Open the bot, select the pipeline you created, save and make sure the bot is enabled.
Send the bot a direct message, or mention it in a channel it has joined.
Troubleshooting
- Connection refused:
http://localhost:7860only works when Langflow runs on the same host and network namespace as LangBot. - Administrator-related features are not supported; keep the bot role as
Member. - Disable streaming on the bot if your pipeline or AI provider does not support it.
- Check Monitoring in the WebUI: every message, pipeline run and error is recorded there.
FAQ
Do I need a server with a public IP for Mattermost?
No. LangBot only needs to reach your Mattermost server; Mattermost does not need to reach LangBot.
Does the Mattermost bot support streaming replies?
Yes. Enable streaming on the bot; the AI back end must also stream. See the platform feature matrix for details.
Can the same Langflow setup serve other platforms too?
Yes. A pipeline can be bound to many bots, so one configuration can answer on several platforms at once.
Related guides
- Full Mattermost setup guide
- Full Langflow runner guide
- Other AI back ends on Mattermost: Dify · n8n · Coze · DeepSeek · OpenAI (ChatGPT models)
- Langflow on other platforms: Telegram · Discord · Slack · Lark (Feishu) · DingTalk · WeCom (internal app)
Connect Langflow to KOOK
Step-by-step guide to running your Langflow app as a KOOK bot with LangBot: Langflow setup, bot credentials, networking, testing and troubleshooting.
Connect Langflow to a website chat widget
Step-by-step guide to running your Langflow app as a a website chat widget bot with LangBot: Langflow setup, bot credentials, networking, testing and troubleshooting.
