Installation with Laravel

Project Starter Kit

The fastest and easiest way to get your first bot up and running is by using the BotMan Laravel starter project. You can create a new project using the composer create-project command:

$ composer create-project mpociot/botman-laravel-starter my_new_bot

This will create a new folder called my_new_bot with a fresh Laravel 5.4 project, which is preconfigured for the use of BotMan. After you created the boiler plate project, edit your .env file with the configuration services of your choice.

The bot logic can be found in the routes/botman.php file, which works as a single definition point for your BotMan hears commands.

$botman->hears('test', function($bot){

$botman->hears('Start conversation', BotManController::class.'@startConversation');


The Laravel starter project comes with a neat Artisan command, that allows you to dry-run your chatbot without needing to setup external services.

Just run php artisan botman:tinker and you have a chat with your bot right in your terminal!

Use BotMan in your existing project

Require this package with composer using the following command:

$ composer require mpociot/botman

BotMan comes with a Service Provider to make using this library in your Laravel application as simple as possible.

Go to your config/app.php and add the service provider:


Also add the alias / facade:

'BotMan' => Mpociot\BotMan\Facades\BotMan::class

Add your Facebook access token / Slack token to your config/services.php:

'botman' => [
    'hipchat_urls' => [
    'nexmo_key' => 'YOUR-NEXMO-APP-KEY',
    'nexmo_secret' => 'YOUR-NEXMO-APP-SECRET',
    'microsoft_bot_handle' => 'YOUR-MICROSOFT-BOT-HANDLE',
    'microsoft_app_id' => 'YOUR-MICROSOFT-APP-ID',
    'microsoft_app_key' => 'YOUR-MICROSOFT-APP-KEY',
    'slack_token' => 'YOUR-SLACK-TOKEN-HERE',
    'telegram_token' => 'YOUR-TELEGRAM-TOKEN-HERE',
    'facebook_token' => 'YOUR-FACEBOOK-TOKEN-HERE',
    'facebook_app_secret' => 'YOUR-FACEBOOK-APP-SECRET-HERE', // Optional - this is used to verify incoming API calls,
    'wechat_app_id' => 'YOUR-WECHAT-APP-ID',
    'wechat_app_key' => 'YOUR-WECHAT-APP-KEY',

Using it:


use Mpociot\BotMan\BotMan;

$botman = app('botman');

$botman->hears('hello', function (BotMan $bot) {
    $bot->reply('Hello yourself.');

// start listening

Make sure that your controller method doesn't use the CSRF token middleware.

That's it.