Skip to content

Commit 659d312

Browse files
authored
Merge pull request #3 from green-api/SW-1631
Updated docs
2 parents 50192bb + 8ff79eb commit 659d312

File tree

2 files changed

+167
-39
lines changed

2 files changed

+167
-39
lines changed

README.md

Lines changed: 40 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,94 +1,95 @@
11
# whatsapp-api-webhook-server-golang
22

3-
whatsapp-api-webhook-server-golang - библиотека для интеграции с мессенджером WhatsApp через API
4-
сервиса [green-api.com](https://green-api.com/). Чтобы воспользоваться библиотекой, нужно получить регистрационный токен
5-
и ID аккаунта в [личном кабинете](https://console.green-api.com/). Есть бесплатный тариф аккаунта разработчика.
3+
- [Документация на русском языке](docs/README_RU.md).
4+
5+
whatsapp-api-webhook-server-golang is a library for integration with WhatsApp messenger using the API
6+
service [green-api.com](https://green-api.com/en/). You should get a registration token and an account ID in
7+
your [personal cabinet](https://console.green-api.com/) to use the library. There is a free developer account tariff.
68

79
## API
810

9-
Документация к REST API находится по [ссылке](https://green-api.com/docs/api/). Библиотека является оберткой к REST API,
10-
поэтому документация по ссылке выше применима и к самой библиотеке.
11+
The documentation for the REST API can be found at the [link](https://green-api.com/en/docs/). The library is a wrapper
12+
for the REST API, so the documentation at the link above also applies.
1113

12-
## Авторизация
14+
## Authorization
1315

14-
Чтобы отправить сообщение или выполнить другие методы Green API, аккаунт WhatsApp в приложении телефона должен быть в
15-
авторизованном состоянии. Для авторизации аккаунта перейдите в [личный кабинет](https://console.green-api.com/) и
16-
сканируйте QR-код с использованием приложения WhatsApp.
16+
To send a message or perform other Green API methods, the WhatsApp account in the phone app must be authorized. To
17+
authorize the account, go to your [cabinet](https://console.green-api.com/) and scan the QR code using the WhatsApp app.
1718

18-
## Пример подготовки среды для Ubuntu Server
19+
## Example of preparing the environment for Ubuntu Server
1920

20-
### Установка Go
21+
### Go Installation
2122

22-
На сервере должен быть установлен Go. [Инструкция по установке Go](https://go.dev/doc/install).
23+
Go must be installed on the server. [Go installation instructions](https://go.dev/doc/install).
2324

24-
### Обновление системы
25+
### Updating the system
2526

26-
Обновим систему:
27+
Update the system:
2728

2829
```shell
2930
sudo apt update
3031
sudo apt upgrade -y
3132
```
3233

33-
### Брандмауэр
34+
### Firewall
3435

35-
Настроим брандмауэр:
36+
Set up the firewall:
3637

37-
Разрешим соединение по SSH:
38+
Allow the SSH connection:
3839

3940
```shell
4041
sudo ufw allow ssh
4142
```
4243

43-
Базовые правила:
44+
Base rules:
4445

4546
```shell
4647
sudo ufw default deny incoming
4748
sudo ufw default allow outgoing
4849
```
4950

50-
Разрешаем соединения по HTTP и HTTPS:
51+
Allow HTTP and HTTPS connections:
5152

5253
```shell
5354
sudo ufw allow http
5455
sudo ufw allow https
5556
```
5657

57-
Активируем брандмауэр:
58+
Enable the firewall:
5859

5960
```shell
6061
sudo ufw enable
6162
```
6263

63-
## Как запустить веб-сервер
64+
## How to run the web server
6465

65-
### Установка
66+
### Installation
6667

67-
Не забудьте создать модуль:
68+
Do not forget to create a module:
6869

6970
```shell
7071
go mod init example
7172
```
7273

73-
Установка:
74+
Installation:
7475

7576
```shell
7677
go get github.com/green-api/whatsapp-api-webhook-server-golang
7778
```
7879

79-
### Импорт
80+
### Import
8081

8182
```
8283
import (
8384
"github.com/green-api/whatsapp-api-webhook-server-golang/pkg"
8485
)
8586
```
8687

87-
### Примеры
88+
### Examples
8889

89-
#### Как инициализировать объект
90+
#### How to initialize an object
9091

91-
Атрибут WebhookToken является опциональным.
92+
The WebhookToken attribute is optional.
9293

9394
```
9495
webhook := pkg.Webhook{
@@ -97,32 +98,32 @@ webhook := pkg.Webhook{
9798
}
9899
```
99100

100-
#### Как запустить веб-сервер
101+
#### How to run the web server
101102

102-
Функция StartServer принимает функцию-обработчик. Функция-обработчик должна содержать 1
103-
параметр (`body map[string]interface{}`). При получении нового уведомления ваша функция-обработчик будет выполнена.
103+
The StartServer function takes a handler function. The handler function must have 1
104+
parameter (`body map[string]interface{}`). When a new notification is received, your handler function will be executed.
104105

105-
Ссылка на пример: [main.go](examples/main.go).
106+
Link to example: [main.go](examples/main.go).
106107

107108
```
108109
_ := webhook.StartServer(func(body map[string]interface{}) {
109110
fmt.Println(body)
110111
})
111112
```
112113

113-
### Запуск приложения
114+
### Running the application
114115

115116
```shell
116117
go run main.go
117118
```
118119

119-
## Документация по методам сервиса
120+
## Service methods documentation
120121

121-
[Документация по методам сервиса](https://green-api.com/docs/api/)
122+
[Service methods documentation](https://green-api.com/en/docs/api/)
122123

123-
## Лицензия
124+
## License
124125

125-
Лицензировано на условиях [
126+
Licensed under [
126127
Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0)
127-
](https://creativecommons.org/licenses/by-nd/4.0/).
128-
Смотрите файл [LICENSE](LICENSE).
128+
](https://creativecommons.org/licenses/by-nd/4.0/) terms.
129+
Please see file [LICENSE](LICENSE).

docs/README_RU.md

Lines changed: 127 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,127 @@
1+
# whatsapp-api-webhook-server-golang
2+
3+
whatsapp-api-webhook-server-golang - библиотека для интеграции с мессенджером WhatsApp через API
4+
сервиса [green-api.com](https://green-api.com/). Чтобы воспользоваться библиотекой, нужно получить регистрационный токен
5+
и ID аккаунта в [личном кабинете](https://console.green-api.com/). Есть бесплатный тариф аккаунта разработчика.
6+
7+
## API
8+
9+
Документация к REST API находится по [ссылке](https://green-api.com/docs/api/). Библиотека является оберткой к REST API,
10+
поэтому документация по ссылке выше применима и к самой библиотеке.
11+
12+
## Авторизация
13+
14+
Чтобы отправить сообщение или выполнить другие методы Green API, аккаунт WhatsApp в приложении телефона должен быть в
15+
авторизованном состоянии. Для авторизации аккаунта перейдите в [личный кабинет](https://console.green-api.com/) и
16+
сканируйте QR-код с использованием приложения WhatsApp.
17+
18+
## Пример подготовки среды для Ubuntu Server
19+
20+
### Установка Go
21+
22+
На сервере должен быть установлен Go. [Инструкция по установке Go](https://go.dev/doc/install).
23+
24+
### Обновление системы
25+
26+
Обновим систему:
27+
28+
```shell
29+
sudo apt update
30+
sudo apt upgrade -y
31+
```
32+
33+
### Брандмауэр
34+
35+
Настроим брандмауэр:
36+
37+
Разрешим соединение по SSH:
38+
39+
```shell
40+
sudo ufw allow ssh
41+
```
42+
43+
Базовые правила:
44+
45+
```shell
46+
sudo ufw default deny incoming
47+
sudo ufw default allow outgoing
48+
```
49+
50+
Разрешаем соединения по HTTP и HTTPS:
51+
52+
```shell
53+
sudo ufw allow http
54+
sudo ufw allow https
55+
```
56+
57+
Активируем брандмауэр:
58+
59+
```shell
60+
sudo ufw enable
61+
```
62+
63+
## Как запустить веб-сервер
64+
65+
### Установка
66+
67+
Не забудьте создать модуль:
68+
69+
```shell
70+
go mod init example
71+
```
72+
73+
Установка:
74+
75+
```shell
76+
go get github.com/green-api/whatsapp-api-webhook-server-golang
77+
```
78+
79+
### Импорт
80+
81+
```
82+
import (
83+
"github.com/green-api/whatsapp-api-webhook-server-golang/pkg"
84+
)
85+
```
86+
87+
### Примеры
88+
89+
#### Как инициализировать объект
90+
91+
Атрибут WebhookToken является опциональным.
92+
93+
```
94+
webhook := pkg.Webhook{
95+
Address: ":80",
96+
Pattern: "/",
97+
}
98+
```
99+
100+
#### Как запустить веб-сервер
101+
102+
Функция StartServer принимает функцию-обработчик. Функция-обработчик должна содержать 1
103+
параметр (`body map[string]interface{}`). При получении нового уведомления ваша функция-обработчик будет выполнена.
104+
105+
Ссылка на пример: [main.go](../examples/main.go).
106+
107+
```
108+
_ := webhook.StartServer(func(body map[string]interface{}) {
109+
fmt.Println(body)
110+
})
111+
```
112+
113+
### Запуск приложения
114+
115+
```shell
116+
go run main.go
117+
```
118+
119+
## Документация по методам сервиса
120+
121+
[Документация по методам сервиса](https://green-api.com/docs/api/)
122+
123+
## Лицензия
124+
125+
Лицензировано на условиях [
126+
Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0)
127+
](https://creativecommons.org/licenses/by-nd/4.0/). [LICENSE](../LICENSE).

0 commit comments

Comments
 (0)