github.com/matthieudolci/hatcher@v0.2.8/README.md (about)

     1  # hatcher	
     2  
     3  [![Build Status](https://travis-ci.com/matthieudolci/hatcher.svg?branch=master)](https://travis-ci.com/matthieudolci/hatcher) [![Go Report Card](https://goreportcard.com/badge/github.com/matthieudolci/hatcher)](https://goreportcard.com/report/github.com/matthieudolci/hatcher)
     4  
     5  Hatcher is a slack bot written in go. It can:
     6  
     7  - Send and save standup notes 
     8  
     9  ## Slack App Creation:
    10  
    11  - Go to the following url to create a new app: https://api.slack.com/apps
    12  - Retrieve the token https://api.slack.com/apps/{app_id}/install-on-team?
    13  
    14      ```Bot User OAuth Access Token: xoxb-xxxxxxxxx-xxxxxxxxxxxxx```
    15  
    16  - Create an environment variable name SLACK_TOKEN with the value of the token you just created:
    17  
    18      ``` export SLACK_TOKEN=xoxb-xxxxxxxxx-xxxxxxxxxxxxx```
    19  
    20  ## How to start it:
    21  
    22  - Start ngrok
    23  
    24      ``` ngrok http 9191```
    25  
    26  - Copy and past the ngrok url into https://api.slack.com/apps/{app_id}/interactive-messages?
    27  
    28      ``` https://xxxxxx.ngrok.io/slack```
    29  
    30  - Start the stack with:
    31  
    32      ```docker-compose up```
    33  
    34  ## How to use it:
    35  
    36  Your users will have to interact a first time with Hatcher by sending a DM saying `hello`.
    37  
    38  It will trigger few questions that need to be answered before the user can use the bot.
    39  
    40  You can find out all the bot commands available by sending `help` to Hatcher
    41  
    42  ## Resources:
    43  https://blog.gopheracademy.com/advent-2017/go-slackbot/
    44  
    45  https://github.com/sebito91/nhlslackbot
    46  
    47  https://github.com/tcnksm/go-slack-interactive
    48  
    49  https://api.slack.com/interactive-messages
    50  
    51  https://www.calhoun.io/
    52  
    53  https://medium.com/aubergine-solutions/how-i-handled-null-possible-values-from-database-rows-in-golang-521fb0ee267
    54  
    55  https://flaviocopes.com/golang-tutorial-rest-api/