Lita::Adapters::Vkontakte

Gem Version Build Status Coverage Status

VKontakte adapter for the Lita chat bot.

Usage

At first, see the documentation for Lita: https://docs.lita.io/

Installation

Add lita-vkontakte to your Lita instance's Gemfile:

gem 'lita-vkontakte', '~> 1.0.0'

Preparation

Go to https://vk.com/editapp?act=create and create standalone application. Then go to application settings page and look at application ID and secure key.

Open the Ruby console (for example with irb command) and type the following (replace LITA_VK_APP_ID with your application ID):

require 'vkontakte_api'

VkontakteApi.app_id = 'LITA_VK_APP_ID'
VkontakteApi.redirect_uri = 'https://oauth.vk.com/blank.html'

puts VkontakteApi.authorization_url(type: :client, scope: [:offline, :messages])

You will see a link. Open it in browser where you are authorized in VKontakte as your future chat bot's user. You will be redirected to some address. We need a parameter access_token from this URL.

Configuration

Required attributes

  • app_id (String) - An ID of your application
  • app_secret (String) - A secure key of your application
  • access_token (String) - An acces token from URL

Example

This is an example lita_config.rb file:

Lita.configure do |config|
  config.robot.name = 'Lita'
  config.robot.mention_name = 'lita'

  config.robot.adapter = :vkontakte

  config.adapters.vkontakte.app_id     = '2849670'
  config.adapters.vkontakte.app_secret = 'EtgJI2yFJ0GYzgDLSS8e'
  config.adapters.vkontakte.access_token  = '51jeIbjmmxJvKo7TTaW0Ext4cx6ajonDIbEkSjFofh7boyxH27JcjKXMODwZTaOxLA1bQbRyY0CEUM2TrXGK6'
end