groupme-lib/bots_api.go

package groupme

import (
	"errors"
	"fmt"
	"net/http"
	"net/url"
)

// GroupMe documentation: https://dev.groupme.com/docs/v3#bots

////////// Endpoints //////////
const (
	// Used to build other endpoints
	botsEndpointRoot = "/bots"

	// Actual Endpoints
	createBotEndpoint      = botsEndpointRoot              // POST
	postBotMessageEndpoint = botsEndpointRoot + "/post"    // POST
	indexBotsEndpoint      = botsEndpointRoot              // GET
	destroyBotEndpoint     = botsEndpointRoot + "/destroy" // POST
)

////////// API Requests //////////

// Create

/*
CreateBot -

Create a bot. See the Bots Tutorial (https://dev.groupme.com/tutorials/bots)
for a full walkthrough.

Parameters:
	See Bot
	Name - required
	GroupID - required
*/
func (c *Client) CreateBot(bot *Bot) (*Bot, error) {
	httpReq, err := http.NewRequest("POST", c.endpointBase+createBotEndpoint, nil)
	if err != nil {
		return nil, err
	}

	if bot == nil {
		return nil, errors.New("bot cannot be nil")
	}

	data := url.Values{}
	data.Add("bot", bot.String())

	httpReq.PostForm = data

	var resp Bot
	err = c.do(httpReq, &resp)
	if err != nil {
		return nil, err
	}

	return &resp, nil
}

// PostMessage

/*
PostBotMessage -

Post a message from a bot

Parameters:
	botID - required, ID(string)
	text - required, string
	pictureURL - string; image must be processed through image
				service (https://dev.groupme.com/docs/image_service)
*/
// TODO: Move PostBotMessage to bot object, since it doesn't require access token
func (c *Client) PostBotMessage(botID ID, text string, pictureURL *string) error {
	URL := fmt.Sprintf(c.endpointBase + postBotMessageEndpoint)

	httpReq, err := http.NewRequest("POST", URL, nil)
	if err != nil {
		return err
	}

	data := url.Values{}
	data.Add("bot_id", string(botID))
	data.Add("text", text)
	if pictureURL != nil {
		data.Add("picture_url", *pictureURL)
	}

	httpReq.PostForm = data

	return c.do(httpReq, nil)
}

// Index

/*
IndexBots -

List bots that you have created
*/
func (c *Client) IndexBots() ([]*Bot, error) {
	httpReq, err := http.NewRequest("GET", c.endpointBase+indexBotsEndpoint, nil)
	if err != nil {
		return nil, err
	}

	var resp []*Bot
	err = c.do(httpReq, &resp)
	if err != nil {
		return nil, err
	}

	return resp, nil
}

// Destroy

/*
DestroyBot -

Remove a bot that you have created

Parameters:
	botID - required, ID(string)
*/
func (c *Client) DestroyBot(botID ID) error {
	URL := fmt.Sprintf(c.endpointBase + destroyBotEndpoint)

	httpReq, err := http.NewRequest("POST", URL, nil)
	if err != nil {
		return err
	}

	data := url.Values{}
	data.Add("bot_id", string(botID))

	httpReq.PostForm = data

	return c.do(httpReq, nil)
}