NAME

Bot::ChatBots::Messenger::WebHook - WebHook for Bot::ChatBots::Messenger

SYNOPSIS

            

              
              
use Mojolicious::Lite;
plugin 'Bot::ChatBots::Messenger',
   helper_name => 'messenger', # default is chatbots.messenger
   instances => [
      [
         WebHook => path => '/messenger/yadda-yadda-yadda',
         processor => \&process,
         verify_token => 'yadda-yadda-yadda',
      ]
   ];
app->start;
sub process {
   my $record = shift;
   # ...
   return $record;
}
            
          

DESCRIPTION

This module allows you to load a Mojolicious plugin for dealing with Facebook Messenger webhooks for a chatbot.

ACCESSORS

This module consumes role Bot::ChatBots::Role::WebHook, inheriting all the accessors. The accessors in the following subsections are added.

no_routes

boolean flag to avoid routes generation upon plugin import. Used during the "BUILD" process. Defaults to 0, meaning that the routes will be generated (both "install_route" in Bot::ChatBots::WebHook and "install_get_route").

verify_token

the verification token required by FaceBook to make sure your settings are accepted by your bot. You MUST set this or it will complain loudly upon calling "install_get_route".

METHODS

This module consumes role Bot::ChatBots::Role::WebHook and implements or overrides the methods in the following subsections.

BUILD

Called by Moo construction process. It uses "no_routes" to establish whether to call "install_route" in Bot::ChatBots::WebHook and "install_get_route" or not.

install_get_route

            

              
              
$obj->install_get_route(%args); # OR
$obj->install_get_route(\%args);
            
          

Install the additional GET route for Facebook verification process. See "validation_token", which MUST be available for this method to work.

normalize_record

            

              
              
my $r = $obj->normalize_record($input_record);
            
          

Modify $input_record in-place and return it, trying to put it in some standard shape. Which has not been standardized yet.

See "normalize_record" in Bot::ChatBots::Role::WebHook.

parse_request

            

              
              
my @updates = $obj->parse_request($c->req);
            
          

See "parse_request" in Bot::ChatBots::Role::WebHook.

BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

SEE ALSO

Foo::Bar.

AUTHOR

Flavio Poletti <polettix@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2016 by Flavio Poletti <polettix@cpan.org>

This module is free software. You can redistribute it and/or modify it under the terms of the Artistic License 2.0.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

cpanm Bot::ChatBots::Messenger

perl -MCPAN -e shell
install Bot::ChatBots::Messenger