API приложений Emotify

Через API вы можете создать бота, который работает в Emotify: пишет в комнаты, отвечает на сообщения людей, ставит реакции и заходит в голосовые каналы.

Подойдёт любой язык, умеющий делать HTTP-запросы. Устанавливать SDK не нужно.

Что можно сделать

• Чат-бот — отвечает на сообщения в комнатах канала: команды, справки, игры.
• Уведомления — присылает в комнату алерты из вашей системы: CI, мониторинг, заказы.
• Музыкальный или голосовой бот — заходит в голосовую комнату и проигрывает звук.
• Вход через Emotify — кнопка «Войти через Emotify» на вашем сайте.

Как это работает

1. Вы создаёте приложение в настройках Emotify и получаете ключ (emb_…).
2. Администратор канала устанавливает ваше приложение на свой канал.
3. На канале появляется бот — участник с вашим именем и меткой «БОТ».
4. Ваша программа ходит в https://emotify.ru/api/v1 с ключом и действует от имени этого бота.

Если бот реагирует на команды вида /погода, объявите их список (как). Портал показывает объявленное у поля ввода и в подсказке по / — это единственный способ, которым участник канала узнаёт, что бот умеет. Незарегистрированной команды для портала не существует.

Бот может делать на канале только то, что разрешает и его роль — как обычному участнику, — и ключ: выпуская ключ, вы отмечаете, чем программа пользуется. Роль настраивает администратор канала, ключ настраиваете вы, и работает пересечение. Пока приложение не установлено ни на один канал, API отвечает, но делать боту нечего.

Начните отсюда

Первый бот за десять минут	от создания приложения до сообщения в комнате
Эхо-бот целиком	готовый код: скопировать, подставить ключ, запустить
Бот погоды целиком	команда в чате → поход во внешний сервис → ответ
Бот-модератор целиком	команда /кик → поиск участника → действие над ним
Справочник маршрутов	все запросы с примерами и ответами
Ключи и лимиты	что открывает ключ, коды ответов, квоты
События	как узнавать о новых сообщениях
Вход через Emotify	OAuth2 для вашего сайта

Ограничения

• Событий семь: сообщение создано, изменено, удалено; реакция поставлена и снята; вход и выход из голосовой. Остальное бот узнаёт запросами.
• Звук в голосовой публикует ваша программа (через LiveKit SDK) — Emotify не проигрывает файлы за вас.
• Личные сообщения пользователей боту недоступны.
• До 3 приложений на аккаунт, 60 запросов в минуту на приложение.