BOTIX API
для ваших интеграций
Подключите BOTIX к своей CRM, сайту или приложению. Передавайте контакты, отправляйте сообщения и запускайте сценарии ботов через API.
Доступ к API входит в стоимость BOTIX
Новый клиент в CRM
- Метка
- crm
- Куда передать
- В контакты BOTIX
Ваша интеграция отправит данные клиента через API.
Запрос вашей интеграции
POST/public/v1/contacts
{
"first_name": "Анна",
"last_name": "Смирнова",
"email": "anna@example.com",
"tags": ["crm"]
}JSON · ключ с правом contacts:write
Контакт создан в BOTIX
- ID контакта
- 42
- Метка
- crm
201 CreatedДанные сохранены
Что доступно через API
- Контакты
- Передавайте клиентов из CRM, обновляйте данные и теги. Для больших списков есть массовое создание и обновление.
- Сообщения и чаты
- Отправляйте сообщения клиентам и получайте историю переписки для своей системы.
- Сценарии
- Запускайте сценарии бота из своего приложения — например, после действия клиента в CRM.
- Вебхуки
- Получайте события о контактах, сообщениях, чатах и сценариях на свой сервер. Подлинность проверяется подписью HMAC-SHA256.
От ключа к первому запросу
Для своего проекта
Создайте проект
Зарегистрируйтесь в BOTIX. Если проект уже есть, откройте его кабинет.
Получите ключ
Владелец проекта создаёт ключ в разделе «API и SDK». Выберите разрешения и сохраните ключ — он показывается один раз.
Ключи в кабинетеВыполните запрос
В ответе будут проект и разрешения вашего ключа.
curl 'https://api.botix.pro/public/v1/me' \
-H 'Authorization: Bearer YOUR_API_KEY'Замените YOUR_API_KEY своим ключом из кабинета.
Фрагмент ответа · пример
{
"success": true,
"data": {"project_id": 42, "scopes": ["contacts:read"]}
}Приложение для клиентов
Подключайте проекты клиентов через OAuth 2.0 с PKCE. Каждый клиент разрешает вашему приложению доступ к своему проекту.
SDK и инструменты
Статус сервисовНачните со своего проекта
Создайте аккаунт BOTIX и получите ключ в кабинете.