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

2. Распакуйте в директорию custom nodes:

tar -xzf pachca-node-v2.2.2.tar.gz -C /path/to/n8n/custom-nodes/

3. Перезапустите n8n:

docker restart n8n-container

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

1. Клонируйте репозиторий:

git clone https://github.com/doesntneedname/n8n-nodes-pachca.git
cd n8n-nodes-pachca

2. Установите зависимости:

npm install

3. Соберите проект:

npm run build

4. Перезапустите 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 на наличие ошибок загрузки

📞 Поддержка

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

• GitHub Issues: Создать issue
• Документация Pachca API: api.pachca.com
• n8n Community: community.n8n.io

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

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

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