pachca

Кастомная нода n8n для интеграции с API мессенджера Pachca. Поддерживает управление пользователями, сообщениями, чатами, файлами и другими ресурсами.

Package Information

Released: 11/7/2025
Downloads: 34 weekly / 84 monthly
Latest Version: 1.0.15
Author: doesntneedname

Available Nodes

Pachca (beta) icon
Pachca (beta)
No description available

Documentation

n8n Pachca Node

Кастомная нода для интеграции с API мессенджера Pachca в n8n. Позволяет автоматизировать работу с пользователями, сообщениями, чатами, файлами и другими ресурсами Pachca.

📋 Содержание

🚀 Установка

Автоматическая установка

  1. Скачайте архив с нодой:
wget https://github.com/doesntneedname/n8n-nodes-pachca/releases/latest/download/pachca-node-v2.2.2.tar.gz
  1. Распакуйте в директорию custom nodes:
tar -xzf pachca-node-v2.2.2.tar.gz -C /path/to/n8n/custom-nodes/
  1. Перезапустите n8n:
docker restart n8n-container

Ручная установка

  1. Клонируйте репозиторий:
git clone https://github.com/doesntneedname/n8n-nodes-pachca.git
cd n8n-nodes-pachca
  1. Установите зависимости:
npm install
  1. Соберите проект:
npm run build
  1. Перезапустите n8n:
docker restart n8n-container

⚙️ Настройка

1. Создание Credentials

  1. В n8n перейдите в Settings → Credentials
  2. Нажмите Add Credential
  3. Найдите Pachca API в списке
  4. Заполните поля:
    • Base URL: https://api.pachca.com/api/shared/v1
    • Access Token: Ваш токен доступа к API Pachca

2. Получение Access Token

Для получения токена доступа:

  1. Войдите в веб-версию Pachca
  2. Перейдите в Настройки → Интеграции
  3. Создайте новый токен доступа
  4. Скопируйте токен и вставьте в настройки credentials

⚠️ Важно: Токен должен иметь необходимые права доступа для операций, которые вы планируете выполнять.

📚 Ресурсы и операции

👥 User (Пользователи)

Операция Описание Метод
Get All Получить список всех пользователей GET
Get By ID Получить пользователя по ID GET
Create Создать нового пользователя POST
Update Обновить данные пользователя PUT
Delete Удалить пользователя DELETE

Параметры для Update:

  • First Name, Last Name, Email
  • Nickname, Phone Number
  • Department, Title, Role
  • Suspended (деактивация)
  • List Tags (теги через запятую)
  • Custom Properties (дополнительные поля)

💬 Message (Сообщения)

Операция Описание Метод
Send Отправить сообщение POST
Get All By Chat Получить сообщения чата GET
Get By ID Получить сообщение по ID GET
Update Редактировать сообщение PUT
Delete Удалить сообщение DELETE
Get Read Members Получить список прочитавших GET

🏠 Chat (Чаты)

Операция Описание Метод
Get All Получить список чатов GET
Get By ID Получить чат по ID GET
Create Создать новый чат POST
Update Обновить чат PUT
Archive Архивировать чат PUT
Unarchive Разархивировать чат PUT

Параметры для Create:

  • Chat Name (название чата)
  • Channel (переключатель: канал/беседа)
  • Public (переключатель: открытый/закрытый)

🏷️ Group Tag (Групповые теги)

Операция Описание Метод
Get All Получить все теги GET
Get By ID Получить тег по ID GET
Create Создать новый тег POST
Update Обновить тег PUT
Delete Удалить тег DELETE
Add Tags Добавить теги к чату POST
Remove Tag Удалить тег из чата DELETE

📁 File (Файлы)

Операция Описание Метод
Upload Загрузить файл POST
Get Upload Params Получить параметры загрузки POST

Поддерживаемые источники файлов:

  • URL (ссылка на файл)
  • Binary (бинарные данные из предыдущих нод)

🎯 Custom Fields (Дополнительные поля)

Операция Описание Метод
Get Custom Properties Получить список полей GET

✅ Task (Задачи)

Операция Описание Метод
Create Создать задачу POST

🤖 Bot (Боты)

Операция Описание Метод
Update Обновить настройки бота PUT

👤 Status (Статус)

Операция Описание Метод
Get Profile Получить профиль GET
Get Status Получить статус GET
Update Status Обновить статус PUT
Delete Status Удалить статус DELETE

🧵 Thread (Потоки)

Операция Описание Метод
Create Thread Создать поток POST
Get Thread Получить поток GET

👍 Reactions (Реакции)

Операция Описание Метод
Add Reaction Добавить реакцию POST
Delete Reaction Удалить реакцию DELETE
Get Reactions Получить реакции GET

💡 Примеры использования

1. Отправка сообщения в чат

{
  "resource": "message",
  "operation": "send",
  "chatId": 12345,
  "content": "Привет! Это автоматическое сообщение от n8n."
}

2. Создание чата с настройками

{
  "resource": "chat",
  "operation": "create",
  "chatName": "Новый проект",
  "channel": true,
  "public": false
}

3. Обновление пользователя

{
  "resource": "user",
  "operation": "update",
  "userId": 123,
  "firstName": "Иван",
  "lastName": "Петров",
  "department": "Разработка",
  "title": "Senior Developer",
  "role": "user",
  "listTags": "Backend, Senior",
  "customProperties": {
    "property": [
      {
        "id": 1678,
        "value": "Москва"
      }
    ]
  }
}

4. Загрузка файла

{
  "resource": "file",
  "operation": "upload",
  "fileSource": "url",
  "fileUrl": "https://example.com/document.pdf",
  "fileName": "document.pdf"
}

5. Workflow: Уведомление о новом пользователе

  1. Webhook - получает данные о новом пользователе
  2. Pachca: Create User - создает пользователя в Pachca
  3. Pachca: Send Message - отправляет приветственное сообщение
  4. Pachca: Create Chat - создает персональный чат

🔧 Устранение неполадок

Ошибка "Invalid URL"

Проблема: API запросы не проходят из-за неправильного URL.

Решение:

  1. Проверьте Base URL в credentials: https://api.pachca.com/api/shared/v1
  2. Убедитесь, что токен доступа действителен
  3. Проверьте права доступа токена

Ошибка "Request failed with status code 404"

Проблема: Ресурс не найден.

Решение:

  1. Проверьте правильность ID ресурса
  2. Убедитесь, что у токена есть права на доступ к ресурсу
  3. Проверьте, что ресурс существует

Ошибка "Request failed with status code 400"

Проблема: Неверные параметры запроса.

Решение:

  1. Проверьте обязательные поля
  2. Убедитесь в правильности формата данных
  3. Проверьте ограничения API (длина текста, размер файла)

Файлы не загружаются

Проблема: Ошибка при загрузке файлов.

Решение:

  1. Проверьте доступность URL файла
  2. Убедитесь, что файл не превышает лимиты размера
  3. Проверьте формат файла (поддерживаемые типы)

Нода не отображается в списке

Проблема: Кастомная нода не появляется в n8n.

Решение:

  1. Убедитесь, что файлы скопированы в правильную директорию
  2. Перезапустите n8n
  3. Проверьте логи n8n на наличие ошибок загрузки

📞 Поддержка

Получение помощи

Сообщение об ошибках

При сообщении об ошибке укажите:

  1. Версию n8n
  2. Версию ноды
  3. Описание проблемы
  4. Логи ошибок
  5. Шаги для воспроизведения

Вклад в развитие

Мы приветствуем вклад в развитие проекта:

  1. Fork репозитория
  2. Создайте feature branch
  3. Внесите изменения
  4. Создайте Pull Request

📄 Лицензия

MIT License - см. файл LICENSE для подробностей.

🏷️ Версии

v1.0.0

  • Базовая функциональность
  • Поддержка всех основных ресурсов Pachca API
  • Загрузка файлов
  • Управление пользователями и чатами

Создано с ❤️ для сообщества n8n и Pachca

Discussion