This package provides the basic framework required to implement and run a Line Bot.
There are two main modules in this package:
LineBot
provides helpers to call the various APIs, for exampleLineBot.send_reply/3
to reply to an event. This module also defines callbacks for you to implement, which are called when your bot receives events from the Line server.LineBot.Webhook
provides aPlug
for handling HTTP requests from the line server, and forwarding them to your callback module, which should implement theLineBot
behaviour.
Add :line_bot
to your mix deps:
defp deps do
[
{:line_bot, "~> 0.1.0"}
]
end
- Defines callbacks (see
LineBot
) to handle all of the possible events a bot can receive. - Provides a plug (
LineBot.Webhook
) to automatically verify, decode, and dispatch webhook requests a bot received. - Provides API helpers (see
LineBot
) for all of the documented Messaging API endpoints.- Automatically retrieves, maintains, renews, and injects the access token into API requests a bot makes.
- When necessary, automatically handles encoding and decoding of JSON and adding the required HTTP headers.
- Defines structs for all of the available message types, to allow for compile-time checking. See
LineBot.Message
.
Credentials are available from the Line Developers site. The credentials are called Channel ID
and Channel secret
on the developers site.
In config/config.exs
:
import Config
config :line_bot,
client_id: YOUR_CHANNEL_ID
client_secret: YOUR_CHANNEL_SECRET
The recommended way to do this is to use LineBot
, which will create default callbacks handlers, and then override the events you want to handle. The default implementations return without doing anything.
An example is available in the sample application.
Using Plug.Router
, this can be done as follows:
forward "/bot", to: LineBot.Webhook, callback: YourCallbackModule
The forwarded URL should be whatever you specified as the callback URI on the Line Developers site.
For detailed instructions, see LineBot.Webhook
. You can also check the sample application.
The Rich Menu API is not currently implemented, although LineBot.APIClient
can be used to call the API manually.
For example, you can post to the rich menu API like this:
menu = %{
"areas" => [
%{
"action" => %LineBot.Message.Action.URI{uri: "https://example.com"},
"bounds" => %{"height" => 1686, "width" => 2500, "x" => 0, "y" => 0}
}
],
"chatBarText" => "test",
"name" => "test",
"selected" => false,
"size" => %{"height" => 1686, "width" => 2500}
}
LineBot.APIClient.post("richmenu", menu)
And get like this:
LineBot.APIClient.get("richmenu/list")
Recent additions to the Flex message API have not been added yet.
Documentation for this package is available online at Hexdocs and interactively in iex via h/1
, for example:
iex> h LineBot