Gratio API — HTTP API для работы с мессенджерами и почтой компании из ваших систем: бота, CRM, helpdesk, сайта, телефонии. Номер или ящик подключается в кабинете Gratio. Ваше приложение получает ключ канала и через него отправляет сообщения, принимает входящие, читает историю, ведёт группы и звонки.
Каналы
| Канал | Что подключается | Как подключается |
|---|---|---|
| MAX | номер MAX | веб-сеанс: QR-код или номер с кодом |
| Telegram | аккаунт Telegram | новое устройство: QR-код или номер с кодом |
| номер WhatsApp или WhatsApp Business | связанное устройство: QR-код или код привязки | |
| Почта | ящик компании | вход через сервис почты или логин и пароль; IMAP и SMTP |
Один канал — один номер, аккаунт или ящик. У каждого канала свой ключ: idInstance и apiTokenInstance.
Как это устроено
Ваша система Gratio Площадка
┌────────────┐ HTTPS ┌───────────────┐ сеанс номера ┌──────────┐
│ бот, CRM, │──────────►│ api.gratio.net│─────────────────►│ MAX │
│ helpdesk, │ │ │ │ Telegram │
│ сайт │◄──────────│ канал │◄─────────────────│ WhatsApp │
└────────────┘ очередь, └───────────────┘ │ почта │
вебхук, └──────────┘
подписки
- Запросы — ваша система вызывает методы:
sendMessage,getChatHistory,createGroup… - Уведомления — Gratio сообщает о событиях: входящее сообщение, статус, звонок. Их забирают из очереди или получают вебхуком.
- Канал держит сеанс номера: принимает сообщения сразу, хранит файлы, выравнивает темп запросов и после обрыва связи дочитывает пропущенное.
MAX, Telegram и WhatsApp подключаются как сеанс пользователя — так же, как веб-версия или приложение на компьютере. Поэтому Gratio бережёт номер: сглаживает залпы запросов и держит правила, по которым мессенджер не сочтёт номер ботом. Подробно — в статье Темп и лимиты.
Начните здесь
Четыре шага — от регистрации до приёма сообщений на своём сервере. Каждый занимает несколько минут и заканчивается проверкой.
Шаг 1. Подключите номерЗарегистрировать компанию, привязать номер мессенджера и взять ключ канала. Шаг 2. Первый запросЗадать ключ в переменных окружения, проверить канал и отправить первое сообщение на curl, Python, Node.js или PHP. Шаг 3. Примите входящиеЗабрать входящее сообщение из очереди, подтвердить его и ответить — по шагам и готовым циклом на Python и Node.js. Шаг 4. Уведомления на свой серверПринять уведомления вебхуком — обработчик на Python или Node.js, публичный адрес, настройка канала и проверка.Дальше
- Основы — как устроены ключи, адреса, ошибки и лимиты: начните со статьи Как проходят сообщения и уведомления.
- Руководства — готовые сценарии с полным кодом: Чат-бот на Python, Переписка в своей CRM, Напоминания и рассылки без блокировок.
- Справочник — каждый метод на своей странице, с примерами на curl, Python, Node.js и PHP: Все методы.
- Переходите с Green API — пути и поля совпадают, см. Переход с Green API.