Rozdíly
Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
| Obě strany předchozí revize Předchozí verze Následující verze | Předchozí verze | ||
|
skoda-ep:modules:messenger_bot_module [16.01.2018 10:12] jan.lorenc [Facebook messenger bot] |
skoda-ep:modules:messenger_bot_module [26.11.2018 17:39] (aktuální) Lukáš Čech |
||
|---|---|---|---|
| Řádek 1: | Řádek 1: | ||
| ====== Facebook messenger bot ====== | ====== Facebook messenger bot ====== | ||
| - | This module contains available submodule - [[.:messenger_bot_module:shout_cast|ShoutCast]] | + | Standard main setup process - [[.:messenger_bot_module:setup|Setup]] |
| - | After successfull instalation and setup covered in this article, continue above on ShoutCast link wiki page. | + | Customization & settings documentation - [[.:messenger_bot_module:customization|Customization]] |
| - | ===== Setup Facebook Page ===== | + | Design - [[.::messenger_bot_module:design|Design guidelines]] |
| - | Fb messenger bot needs facebook page on behalf which will be communicating. | + | ==== Modules ==== |
| - | So its important to create new Facebook page. | + | ShoutCast submodule documentation - [[.:messenger_bot_module:shout_cast|ShoutCast Module]] |
| - | After logging into facebook, head over to: | + | Standard & Extender submodule documentation - [[.:messenger_bot_module:st_extender|Standard & Extender Module]] |
| - | https://www.facebook.com/pages/create/ | ||
| - | After creating page, u can get Page ID from URL, for example: | ||
| - | |||
| - | https://www.facebook.com/Test-1796766873669723/ => 1796766873669723 (will need this later on) | ||
| - | |||
| - | Alternative way to obtain Page ID is described here | ||
| - | https://www.facebook.com/help/community/question/?id=378910098941520 | ||
| - | |||
| - | ===== Setup facebook App ===== | ||
| - | |||
| - | After page creation it's essential to create facebook App and connect it to Page. | ||
| - | |||
| - | U need to login again as a facebook developer and Create new App | ||
| - | |||
| - | https://developers.facebook.com/apps | ||
| - | |||
| - | Afted App creation head to Messenger section | ||
| - | https://developers.facebook.com/apps/xxx/messenger/settings/ | ||
| - | |||
| - | {{:skoda-ep:modules:fb-app-1.png?200|}} | ||
| - | |||
| - | Select Page from dropdown and generate Token (will be used later) | ||
| - | |||
| - | {{:skoda-ep:modules:fb-app-2.png?200|}} | ||
| - | |||
| - | Select a page to subscribe | ||
| - | |||
| - | {{:skoda-ep:modules:fb-bot-8.png?600|}} | ||
| - | |||
| - | Next step is to setup webhooks | ||
| - | |||
| - | {{:skoda-ep:modules:fb-app-3.png?400|}} | ||
| - | |||
| - | * Callback URL => wordpress endpoint => https://skoda-wlc.ys-dev.cz/wide/wp-json/fb-msg/webhook | ||
| - | * Verify Token => write random string (will be used later) | ||
| - | * Subscriptions Fields => check "messages" and "messaging_optins" | ||
| - | |||
| - | Now it's time to setup Wordpress facebook messenger by section "Setup credentials in wordpress". After All is set up, return here and click Verify and Save to finalize setup. | ||
| - | |||
| - | At first fb messenger bot will be in development mode - only administrator of facebook App will see plugin and be able to optin for notifications - for testing purposes. | ||
| - | After development stage is over its essential to submit App for revision to Facebook to enable it for public use. | ||
| - | |||
| - | {{:skoda-ep:modules:fb-app-4.png?600|}} | ||
| - | |||
| - | ===== Setup credentials in wordpress ===== | ||
| - | |||
| - | First step is to enable "YS facebook messenger API" plugin in Plugins => Installed Plugins. | ||
| - | |||
| - | Then head over to Social Networks => Facebook tab => FB mesenger optin plugin. You should have all fields gathered from previous sections. | ||
| - | |||
| - | * App ID => ID of created app in facebook developers console | ||
| - | * Page ID => ID of facebook page on which behalf bot will communicate. Obtaining is described in first section of this manual | ||
| - | * Verify Token => string set up to validate wordpress API in facebook developers console | ||
| - | * Page Access Token => token generated in facebook developers console | ||
| - | * Send from all categories => check to send notifications from all published posts. Otherwise only notifications from particular category new posts will be sent | ||
| - | |||
| - | ==== Inserting Shortcode into Page ==== | ||
| - | |||
| - | FB messenger bot plugin needs to be inserted into page, to display optin button for users on frontend. | ||
| - | |||
| - | In visual editor use shortcode plugin button | ||
| - | |||
| - | {{:skoda-ep:modules:fb-app-5.png?600|}} | ||
| - | |||
| - | Or in texteditor shorcode: | ||
| - | |||
| - | ''[fb-msg-optin msg="Optin for notification!"]'' | ||
| - | |||
| - | msg => This message displayed on fronend above optin fb button | ||
| - | |||
| - | {{:skoda-ep:modules:fb-app-6.png?200|}} | ||
| - | |||
| - | ==== Publishing post with notification ==== | ||
| - | |||
| - | When publishing new post (or updating older one, which was not notified by FB messenger bot) | ||
| - | check "Send one-time publish notification" option. | ||
| - | |||
| - | {{:skoda-ep:modules:page_publish.png?200|}} | ||
| - | |||
| - | After publishing/updating, all users opted for selected main category will be notified. In case that wordpress doesn't include "main category" function, notifications will be sent to all assigned post categories. | ||
| - | |||
| - | Notifications for each post will by sent only once. | ||