gizlinebot

README

GIZ Line Bot

Setup the line bot on your local

Requirements:

• Golang
• Golang Dependency tool: https://github.com/golang/dep
• Mysql server (see below instructions for importing the schema - assets/init.db)
• Line account with a messaging API provider: https://developers.line.me/console/register/messaging-api/provider/

git clone git@github.com:VagabondDataNinjas/gizlinebot.git
cd gizlinebot
dep install

# config file
cp .gizlinebot.example.toml ~/.gizlinebot.toml
# update ~/.gizlinebot.toml with the values for
# GIZLB_LINE_TOKEN and GIZLB_LINE_SECRET from the
# line developer area Messaging API(https://developers.line.me/)
# set correct the config for the SQL parameters

# import the SQL Schema from assets/init.sql

# install ngrok
# https://ngrok.com/download

# start an ngrok tunnel
# the port you give to ngrok should be the same as
# PORT value (default port 8888)
ngrok http 127.0.0.1:8888

# update the line Webhook URL to the ngrok host + "/linewebhook"
eg: https://d2631531.ngrok.io/linewebhook

# start the bot
go run main.go lineBot

# in a different terminal you can also start the
# web API
go run main.go webApi

Release process

Requirements:

• you'll need to have your github token exported: export GITHUB_TOKEN="YOUR_GITHUB_TOKEN"
• install goreleaser: brew install goreleaser/tap/goreleaser

Release steps:

• tag a new release: git tag -a v0.0.4 -m "Commit message describing your release" && git push origin v0.0.4
• release goreleaser

Static files and endpoints

• This binary will serve static files from the gizsurvey repo which should be located on the same folder level at ../gizsurvey (path relative to this repo)

The API endpoints are defined in ./http/api.go

Local development

# install realize
go get -u github.com/tockins/realize

# run and watch the files for changes (config in `.realize` folder)
realise start