Быстрый старт

Это руководство поможет вам выполнить первый запрос к API Пачки — от получения токена до отправки сообщения.

Для работы с API нужен аккаунт Пачки с доступом к API (настраивается владельцем пространства) и любой HTTP-клиент — терминал с cURL, Postman или Bruno. Также можно использовать CLI — все методы доступны как команды.

Первый запрос

Получите токен

Для работы с API вам нужен токен доступа. Есть два способа его получить:

  • Персональный токен — в интерфейсе Пачки: «Автоматизации» → «API» (доступно администраторам)
  • Токен бота — создайте бота в «Автоматизации» → «Интеграции» → «Чат-боты и Вебхуки»
Подробнее о типах токенов и скоупах — в разделе Авторизация.

Проверьте токен

Получим информацию о своем профиле — простейший запрос GETИнформация о профиле без параметров:

Получение профиля
curl "https://api.pachca.com/api/shared/v1/profile" \  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Все запросы отправляются на базовый URL https://api.pachca.com/api/shared/v1. Токен передаётся в заголовке Authorization: Bearer TOKEN. Ответ содержит данные в объекте data, а для списочных методов — ещё и блок meta с информацией о пагинации.

Если вместо данных вы получили 401 Unauthorized — проверьте, что токен скопирован без лишних пробелов и что у него есть нужный скоуп.

Отправьте сообщение

Теперь отправим сообщение в беседу. Все параметры — в описании метода POSTНовое сообщение.

Отправка сообщения
curl "https://api.pachca.com/api/shared/v1/messages" \  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \  -H "Content-Type: application/json" \  -d '{  "message": {    "entity_id": 334,    "content": "Вчера мы продали 756 футболок (что на 10% больше, чем в прошлое воскресенье)"  }}'

Замените entity_id на ID вашей беседы или канала — его можно узнать в URL чата в веб-версии Пачки или через метод GETСписок каналов и бесед. Запросы с телом отправляются в формате JSON с заголовком Content-Type: application/json.

Следующие шаги