PHPackages                             elgibor-solution/laravel-botpress - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. elgibor-solution/laravel-botpress

ActiveLibrary[API Development](/categories/api)

elgibor-solution/laravel-botpress
=================================

A Laravel bridge for Botpress Community Edition API.

1.0.1(3mo ago)097↓50%MITPHPPHP ^8.2

Since Feb 2Pushed 3mo agoCompare

[ Source](https://github.com/elgiborsolution/laravel-botpress)[ Packagist](https://packagist.org/packages/elgibor-solution/laravel-botpress)[ RSS](/packages/elgibor-solution-laravel-botpress/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

Laravel Botpress Bridge
=======================

[](#laravel-botpress-bridge)

A production-ready Laravel package that acts as a transparent bridge to the Botpress v12 Community Edition API.

Features
--------

[](#features)

- Bridge all Botpress API endpoints with a configurable prefix.
- Mirror same API path, payload, and response as Botpress.
- Handle configuration from `.env` or Database.
- Production ready with comprehensive tests.

Installation
------------

[](#installation)

```
composer require elgibor-solution/laravel-botpress
```

Configuration
-------------

[](#configuration)

Publish the config file:

```
php artisan vendor:publish --tag="botpress-config"
```

### Environment Variables

[](#environment-variables)

The package supports both **Botpress Cloud** and **Botpress Community Edition (CE)** with different authentication methods.

#### For Botpress Cloud

[](#for-botpress-cloud)

```
BOTPRESS_SERVER_URL=https://your-cloud-instance.botpress.cloud
BOTPRESS_AUTH_TYPE=bearer
BOTPRESS_API_TOKEN=bp_pat_your_token_here
BOTPRESS_ROUTE_PREFIX=botpress
BOTPRESS_USE_DATABASE_CONFIG=false
```

#### For Botpress CE (No Authentication)

[](#for-botpress-ce-no-authentication)

Ideal for development or internal networks:

```
BOTPRESS_SERVER_URL=http://localhost:3000
BOTPRESS_AUTH_TYPE=none
BOTPRESS_ROUTE_PREFIX=botpress
BOTPRESS_USE_DATABASE_CONFIG=false
```

#### For Botpress CE (JWT Authentication)

[](#for-botpress-ce-jwt-authentication)

When your CE instance requires JWT tokens:

```
BOTPRESS_SERVER_URL=http://your-botpress-server:3000
BOTPRESS_AUTH_TYPE=jwt
BOTPRESS_AUTH_SECRET=your-jwt-secret-key
BOTPRESS_JWT_EXPIRY=3600
BOTPRESS_ROUTE_PREFIX=botpress
BOTPRESS_USE_DATABASE_CONFIG=false
```

#### For Botpress CE (Basic Authentication)

[](#for-botpress-ce-basic-authentication)

When your CE instance uses basic auth:

```
BOTPRESS_SERVER_URL=http://your-botpress-server:3000
BOTPRESS_AUTH_TYPE=basic
BOTPRESS_AUTH_USERNAME=admin
BOTPRESS_AUTH_PASSWORD=your-password
BOTPRESS_ROUTE_PREFIX=botpress
BOTPRESS_USE_DATABASE_CONFIG=false
```

### Authentication Types

[](#authentication-types)

- **`bearer`** - For Botpress Cloud (uses PAT/BAK/IAK tokens)
- **`jwt`** - For Botpress CE with JWT authentication
- **`basic`** - For Botpress CE with HTTP Basic authentication
- **`none`** - For Botpress CE without authentication (development/internal)

### Database Configuration

[](#database-configuration)

If you want to manage configuration via database, run the migrations:

```
php artisan vendor:publish --tag="botpress-migrations"
php artisan migrate
```

Then set `BOTPRESS_USE_DATABASE_CONFIG=true` in your `.env`. The package will look for configuration keys in the `botpress_configs` table:

**Available keys:**

- `server_url` - Botpress server URL
- `api_token` - API token (for bearer auth)
- `auth_type` - Authentication type (bearer, jwt, basic, none)
- `auth_secret` - JWT secret key (for JWT auth)
- `jwt_expiry` - JWT expiration in seconds (for JWT auth)
- `auth_username` - Username (for basic auth)
- `auth_password` - Password (for basic auth)

Usage
-----

[](#usage)

Simply make requests to your Laravel application using the configured prefix.

For example, if your prefix is `botpress`, a request to: `POST https://your-laravel-app.com/botpress/api/v1/bots/my-bot/converse/my-user`

Will be bridged to: `POST http://your-botpress-server:3000/api/v1/bots/my-bot/converse/my-user`

Headers (except for excluded ones like `host`) and payloads are forwarded exactly as received.

Testing
-------

[](#testing)

```
vendor/bin/phpunit
```

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance82

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

2

Last Release

97d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f5e7899407946e1ed48940ae3b5fea2477eacc7ec98e9f53122e2d97718b7087?d=identicon)[esolution](/maintainers/esolution)

---

Top Contributors

[![elgibor-solution](https://avatars.githubusercontent.com/u/783039?v=4)](https://github.com/elgibor-solution "elgibor-solution (4 commits)")

---

Tags

laravelBridgechatbotpress

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/elgibor-solution-laravel-botpress/health.svg)

```
[![Health](https://phpackages.com/badges/elgibor-solution-laravel-botpress/health.svg)](https://phpackages.com/packages/elgibor-solution-laravel-botpress)
```

###  Alternatives

[essa/api-tool-kit

set of tools to build an api with laravel

52680.5k](/packages/essa-api-tool-kit)[resend/resend-laravel

Resend for Laravel

1191.4M6](/packages/resend-resend-laravel)[joggapp/laravel-aws-sns

Laravel package for the SNS events by AWS

3171.8k](/packages/joggapp-laravel-aws-sns)[simplestats-io/laravel-client

Client for SimpleStats!

4515.5k](/packages/simplestats-io-laravel-client)[dragon-code/laravel-json-response

Automatically always return a response in JSON format

1118.6k1](/packages/dragon-code-laravel-json-response)[surface/laravel-webfinger

A Laravel package to create an ActivityPub webfinger.

113.8k](/packages/surface-laravel-webfinger)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)