BotHelp

https://help.bothelp.io
Admin
BotHelp is a platform for creating and managing chatbots, AI agents, and automated messaging...
Tokens:174,375
Snippets:1,725
Trust Score:10
Update:3 months ago
Show doc for...
Tokens:
Raw
### Supported Data Types

Source: https://help.bothelp.io/shag-formula

Examples of literal values for different supported data types.

```text
10
2.5
```

```text
"текст"
```

```text
True
False
```

```text
"2025-10-10"
"10.10.2025 12:00:00"
```

```text
null
```

--------------------------------

### Variable Naming Rules

Source: https://help.bothelp.io/shag-formula

Examples of valid and invalid variable naming conventions.

```text
Сумма1
1Сумма
```

--------------------------------

### Accessing Variables in Formula Step

Source: https://help.bothelp.io/shag-formula

Examples of reading and writing to different variable scopes including client fields, global variables, and local variables.

```text
client.price
{%Должность%}
```

```text
globals.order
{@discount@}
```

```text
age_years = 25
```

--------------------------------

### GET https://gc.bothelp.io

Source: https://help.bothelp.io/dejstviya-s-podpischikom-bothelpa-napryamuyu-iz-getcourse

Trigger an action in BotHelp for a specific subscriber identified by email or phone.

```APIDOC
## GET https://gc.bothelp.io

### Description
Triggers a specific action for a subscriber in BotHelp based on data provided by GetCourse.

### Method
GET

### Endpoint
https://gc.bothelp.io

### Query Parameters
- **domain_name** (string) - Required - The domain name of your BotHelp account.
- **token** (string) - Required - The BotHelp SecretKey from your integration settings.
- **email** (string) - Required - The email address of the subscriber.
- **phone** (string) - Optional - The phone number of the subscriber.
- **idBotHelp** (string) - Optional - The unique CUID of the subscriber in BotHelp.
- **actions[run_bot]** (string) - Optional - The reference ID of the bot to run.
- **actions[step_ref]** (string) - Optional - The reference ID of the bot step.
- **actions[stop_bot]** (string) - Optional - The reference ID of the bot to stop for the subscriber.
```

--------------------------------

### URL для вызова операции в GetCourse

Source: https://help.bothelp.io/proverka-oplaty-zakaza-na-getcourse-po-email-podpischika

Используется в блоке «Вызвать URL» для отправки данных о заказе в BotHelp. Замените {%Ваш домен в Bothelp%} на реальный домен вашего кабинета.

```text
https://gc.bothelp.io/callback?email={object.user.email}&phone={object.user.phone}&order_status={object.status}&offers={object.offers}&domain_name={%Ваш домен в Bothelp%}
```

--------------------------------

### Webhook JSON Data Structure

Source: https://help.bothelp.io/webhook-bothelp

Example of the JSON payload sent by BotHelp, including standard subscriber fields and custom UTM/profile fields.

```json
{
//Standard fields
«created_at»: 1499947711, //timestamp
«name»: «John Wick»,
«first_name»: «John»,
«last_name»: «Wick»,
«profile_link»: «https:\/\/fb.com\/1941325716136721»,
«email»: «john@gmail.com»,
«phone»: «+14123456789»,
«conversations_count»: 10,
«first_contact_at»: 1499944111,
«last_contact_at»: 1499944111,
«user_id»: «1234567890»,
«bothelp_user_id»: «47659»,
«created_at_show»: «14/07/2017 07:56:32 UTC» //time and date of creating a lead for humans,
«cuid»: «1et0.301»
//Custom fields
«utm_source»: «VK»,
«utm_campaign»: «messenger»,
«utm_medium»: «social_cpc»,
«utm_content»: «123»
«age»: «21»,
«position»: «CEO at Pinapple»,
}
```

--------------------------------

### Шаблон URL для интеграции GetCourse и BotHelp

Source: https://help.bothelp.io/segmentacziya-staryh-podpischikov-getcourse-v-baze-bothelp

Базовый шаблон ссылки для вызова операции POST в процессе GetCourse.

```text
https://gc.bothelp.io?domain_name={%Ваш домен в Bothelp%}&token={%Ваш SecretKey из кабинета BotHelp%}&email={object.email}&phone={object.phone}&actions[add_tag]={%Название метки из кабинета BotHelp%}
```

--------------------------------

### Скрипт передачи данных формы на страницу «Спасибо»

Source: https://help.bothelp.io/integracziya-s-vakas-tools

Используется на лендинге для перенаправления данных формы регистрации на страницу благодарности, где размещена виджет-кнопка BotHelp.

```html
<script>
var thanks_pages = [];
thanks_pages[1] = '{ссылка_на_страницу_спасибо_1}';
</script>
<script src="//vakas-tools.ru/f/s/to_thank.js"></script>
```
Tokens:
Raw