mg-bot-api-client-go/README.md

104 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

2020-11-26 14:10:42 +03:00
[![Build Status](https://github.com/retailcrm/mg-bot-api-client-go/workflows/ci/badge.svg)](https://github.com/retailcrm/mg-bot-api-client-go/actions)
[![Coverage](https://img.shields.io/codecov/c/gh/retailcrm/mg-bot-api-client-go/master.svg?logo=codecov&logoColor=white)](https://codecov.io/gh/retailcrm/mg-bot-api-client-go)
[![GitHub release](https://img.shields.io/github/release/retailcrm/mg-bot-api-client-go.svg?logo=github&logoColor=white)](https://github.com/retailcrm/mg-bot-api-client-go/releases)
[![Go Report Card](https://goreportcard.com/badge/github.com/retailcrm/mg-bot-api-client-go)](https://goreportcard.com/report/github.com/retailcrm/mg-bot-api-client-go)
[![GoLang version](https://img.shields.io/badge/go->=1.13-blue.svg?logo=go&logoColor=white)](https://golang.org/dl/)
[![pkg.go.dev](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white)](https://pkg.go.dev/github.com/retailcrm/mg-bot-api-client-go)
2018-08-29 02:44:06 +03:00
2020-11-12 14:00:49 +03:00
# Message Gateway Bot API Go client
2018-08-29 02:44:06 +03:00
## Install
```bash
go get -u -v github.com/retailcrm/mg-bot-api-client-go
```
## Usage
```golang
package main
import (
"fmt"
"net/http"
"github.com/retailcrm/mg-bot-api-client-go/v1"
)
func main() {
var client = v1.New("https://token.url", "cb8ccf05e38a47543ad8477d49bcba99be73bff503ea6")
message := MessageSendRequest{
Scope: "public",
Content: "test",
ChatID: 12,
}
data, status, err := c.MessageSend(message)
if err != nil {
t.Errorf("%d %v", status, err)
}
fmt.Printf("%v", data.MessageID)
}
```
2018-09-04 11:30:00 +03:00
## Websocket Example
```golang
package main
import (
"encoding/json"
"log"
"strings"
"github.com/gorilla/websocket"
"github.com/retailcrm/mg-bot-api-client-go/v1"
)
func main() {
var client = v1.New("https://token.url", "cb8ccf05e38a47543ad8477d49bcba99be73bff503ea6")
url, headers, err := client.WsMeta([]string{"message_new"})
if err != nil {
log.Fatal("wsMeta:", err)
}
wsConn, _, err := websocket.DefaultDialer.Dial(url, headers)
if err != nil {
log.Fatal("dial:", err)
}
for {
var wsEvent v1.WsEvent
err = wsConn.ReadJSON(&wsEvent)
if err != nil {
log.Fatal("ReadJSON:", err)
}
var eventData v1.WsEventMessageNewData
err = json.Unmarshal(wsEvent.Data, &eventData)
if err != nil {
log.Fatal("Unmarshal:", err)
}
if !strings.HasPrefix(eventData.Message.Content, "Hello") {
continue
}
message := v1.MessageSendRequest{
Scope: "public",
Content: "Bonjour!",
ChatID: eventData.Message.ChatID,
Type: "text",
2018-09-04 11:30:00 +03:00
}
_, status, err := client.MessageSend(message)
if err != nil {
log.Fatalf("%d %v", status, err)
}
}
}
2020-11-12 14:00:49 +03:00
```