BotMan - From Zero to Chatbot [Laravel Live]

Transcript

1. BotMan From Zero to Chatbot
2. About me Marcel Pociot Developer at ORT interactive @marcelpociot
3. Open Source
4. Open Source 15 open source PHP packages / ~200k downloads Laravel TestTools Chrome extension / ~6k weekly users Codeception TestTools Chrome extension Rank 5 of top German PHP GitHub developers
5. Chatbots
6. Automate deployments Send SaaS metrics Scrum/stand-up bot Google Analytics Random fun Bots are your friends
7. Automate deployments Send SaaS metrics Scrum/stand-up bot Google Analytics Random fun Bots are your friends
8. Let's build our own chatbot!
10. How does all of this work?
11. Hi!
12. Installation $ composer require mpociot/botman $ composer create-project mpociot/botman-laravel-starter my_new_bot
13. Configuration botman.io $botman = BotManFactory::create([ 'slack_token' => 'YOUR-SLACK-TOKEN-HERE', 'telegram_token' => 'YOUR-TELEGRAM-TOKEN-HERE', 'facebook_token' => 'YOUR-FACEBOOK-TOKEN-HERE', ]);
14. Configuration botman.io # BOTMAN SERVICE CONFIGURATION HIPCHAT_URL= MICROSOFT_BOT_HANDLE= MICROSOFT_APP_ID= MICROSOFT_APP_KEY= NEXMO_KEY= NEXMO_SECRET= SLACK_TOKEN= TELEGRAM_TOKEN=
15. Bot fundamentals 1. Hear 2. Respond
16. Hearing things $botman->hears('keyword', function($bot) { $bot->reply('Hello my friend!'); }); $botman->hears('another keyword', 'My\Bot\Controllers@handle') $botman->listen();
17. Hearing things
18. Hearing things $botman->hears('tell me more', function($bot) { $bot->reply('Hello my friend!'); $bot->reply('What do you want to know from me?'); });
19. Hearing things $botman->group(['driver' => SlackDriver::class], function($botman) { $botman->hears('I only listen on Slack', function($bot) { }); $botman->hears('Me too', function($bot) { }); }); $botman->group(['driver' => TelegramDriver::class], function($botman) { $botman->hears('And I only listen on Telegram', function($bot) { }); });
20. Hearing things $botman->hears('Call me {name}', function($bot, $name) { $bot->reply('Hello '.$name); }); $botman->hears('I am {name} the {adjective}', function($bot, $name, $adjective) $bot->reply('Hello '.$name.'. You truly are '.$adjective); });
21. Hearing things $botman->hears('I am ([0-9]+) years old', function($bot, $age) { $bot->reply('Got it - your age is: '.$age); });
22. Hearing things If nothing else matters matches $botman->fallback(function($bot) { $bot->reply('I have no idea what you are talking about!'); });
23. Remembering things $botman->hears('I am ([0-9]+) years old', function($bot, $age) { $bot->reply('Got it - your age is: '.$age); $bot->userStorage()->save([ 'age' => $age ]); }); $botman->hears('How old am i', function($bot) { $user = $bot->userStorage()->get(); $bot->reply('You are '.$user->get('age')); });
24. Remembering things $bot->userStorage()->save([ 'age' => $age ]); $bot->channelStorage()->save([ 'num_users' => $num ]); $bot->driverStorage()->save([ 'foo' => $bar ]);
25. Advanced Responses $botman->hears('give me images', function($bot) { $message = Message::create('Here is a nice image') ->image('http://laravel-live-india.dev/img/botman.png'); $bot->reply($message); });
26. Advanced Responses $botman->hears('give me videos', function($bot) { $message = Message::create('Here is a nice image') ->video('http://laravel-live-india.dev/img/botman.mp4'); $bot->reply($message); });
27. Let's order some Pizza! - I want a large capricciosa with extra cheese delivered to Example street 34 $botman->hears('I want a ([^\s]+) ([^\s]+) (with [^\s]+)? delivered to ([^\s]+)'
28. Conversations $botman->hears('I want images', function($bot) { $bot->ask('Which images?', function($answer, $bot) { $text = $answer->getText(); $message = Message::create() ->image('http://lorempixel.com/400/200/'.$text.'/'); $bot->say($message); }); });
29. Conversations class PizzaConversation extends Conversation { public function run() { $this->ask('What Pizza size do you want?', function($answer) { $this->size = $answer->getText(); }); } }
30. Conversations $this->ask('What Pizza size do you want?', function($answer) { $this->size = $answer->getText(); $this->askTopping(); }); public function askTopping() { $this->ask('What kind of topping do you want?', function($answer) { $this->topping = $answer->getText(); $this->askAddress(); }); }
31. Conversations $this->ask('Where can we deliver your tasty pizza?', function($answer) { $this->address = $answer->getText(); $this->say('Okay. That is all I need.'); $this->say('Size: '.$this->size); $this->say('Topping: '.$this->topping); $this->say('Delivery address: '.$this->address); });
32. Conversations $botman->hears('I want pizza', function($bot) { $bot->startConversation(new PizzaConversation); });
33. Questions // Better pizza $question = Question::create('What Pizza size do you want?'); $question->addButtons([ Button::create('Supersize')->value('XXL'), Button::create('Large')->value('L') ]); $this->ask($question, function($answer) { // });
34. Questions
35. Natural Language Processing Hey Calendar, schedule dinner with Nicole at 8 pm tomorrow. { "intent": "create_meeting", "entities": { "name" : "Dinner with Nicole", "invitees" : ["Nicole"], "time": "2017-04-11 20:00:00" } }
36. Natural Language Processing $botman->hears('order.pizza', function($bot) { $extras = $bot->getMessage()->getExtras('apiParameters'); $bot->reply('Type: '.$extras['type']); $bot->reply('Size: '.$extras['size']); $bot->reply('Topping: '.implode($extras['topping'], ' ')); })->middleware(ApiAi::create('my-api-ai-token')->listenForAction());
37. Extending BotMan Middleware class Authorization implements MiddlewareInterface { /** @var array */ protected $allowedUsers = [1,2,3]; public function isMessageMatching(Message $message, $test) { return in_array($message->getUser(), $this->allowedUsers); } }
38. Extending BotMan Middleware $botman->hears('foo', function(){ // })->middleware(new Authorization); $botman->group(['middleware' => new Authorization], function($botman) { $botman->hears('foo', function(){ // }); })
39. Extending BotMan Middleware class RegisterUsers implements MiddlewareInterface { public function handle(Message $message) { $user = User::firstOrCreate(['user_id' => $message->getUser()]); $message->addExtras('user', $user); } }
40. Extending BotMan Drivers class FlockDriver implements DriverInterface { public function matchesRequest() { return true; } public function getMessages() { return [new Message('', '', '')]; } public function reply($message, $matchingMessage, $additionalParameters = [] { // }
41. Extending BotMan Drivers DriverManager::loadDriver(MyCustomDriver::class); $botman->hears('foo', function(){ // })->driver(MyCustomDriver::class); $botman->group(['driver' => MyCustomDriver::class], function($botman) { $botman->hears('foo', function(){ // }); })
42. Recap 7 supported messaging services Natural Language Processing support Easy extensibility
43. Thank you! Questions?