В этом шаге вы привяжете номер к Gratio и получите ключ канала — адрес API, idInstance и apiTokenInstance.
Что понадобится
- почта для регистрации;
- телефон с мессенджером, номер которого подключаете. Лучше рабочий: Gratio видит все личные чаты аккаунта.
1. Зарегистрируйте компанию
Откройте кабинет gratio.net/cabinet → «Зарегистрировать компанию»: название компании, ваше имя, почта, пароль. Введите код из письма.
Вы увидите: кабинет компании с предложением пробного канала.
2. Возьмите пробный канал
Первый канал новой компании — 7 дней бесплатно, карта не нужна. Выберите тип: MAX, Telegram, WhatsApp или почта.
Вы увидите: карточку канала со статусом «Без номера».
3. Привяжите номер
В карточке канала нажмите «Привязать номер» и выберите способ:
| Канал | По QR-коду | По номеру |
|---|---|---|
| MAX | телефон с MAX: «Устройства» → «Войти по QR-коду» | проверка «Я не робот» в отдельном окне, затем код из SMS или приложения |
| Telegram | «Настройки» → «Устройства» → «Подключить устройство» | код придёт в приложение, в чат «Telegram» |
| «Связанные устройства» → «Привязка устройства» | Gratio покажет код из 8 знаков: «Связать по номеру телефона» на телефоне |
Ящик почты подключается входом через сервис почты или логином и паролем — см. Почта.
Вы увидите: статус «Подключён · Номер работает».
4. Скопируйте ключ
В карточке канала нажмите «Ключ API». Ключ выдаётся сам, как только номер привязан.
| Поле в кабинете | Что это | Куда в коде |
|---|---|---|
| Адрес API | https://api.gratio.net |
GRATIO_URL |
idInstance |
номер канала в API, 10 цифр | GRATIO_ID |
apiTokenInstance |
токен, 50 символов; скрыт — нажмите «Показать» | GRATIO_TOKEN |
mediaUrl |
адрес для загрузки файлов — тот же https://api.gratio.net |
— |
«Скопировать всё» копирует все поля сразу.
Токен — секрет. Храните его на сервере, а не в коде страницы или мобильного приложения. Утёк — нажмите «Перевыпустить»: старый перестанет работать сразу. Подробно — в статье Каналы и ключи.
Что дальше
Ключ у вас — отправьте первый запрос.
Шаг 2. Первый запросЗадать ключ в переменных окружения, проверить канал и отправить первое сообщение на curl, Python, Node.js или PHP.