Files
crm.clientright.ru/API_ATTACH_DOCS_README.md
Fedor cd90b0d58a feat: Добавлен инструмент генерации документов для AI Ассистента
- Создан API create_document_with_text.php для создания DOCX/XLSX/PPTX с текстом от AI
- Поддержка Markdown форматирования (заголовки, жирный, курсив, списки, код)
- Установлен PHPWord для красивого форматирования документов
- Исправлены пути сохранения (crm2/CRM_Active_Files/... без /crm/ в начале)
- Замена пробелов на подчеркивания в именах папок
- Создана документация для AI и разработчиков
- Добавлены API для работы с шаблонами Nextcloud
2025-11-12 19:46:06 +03:00

2.0 KiB
Raw Permalink Blame History

📎 API для привязки документов

Прямой эндпоинт (готов к использованию!)

POST https://crm.clientright.ru/api_attach_documents.php

🚀 Формат запроса (из n8n)

[
  {
    "contact_id": "320096",
    "project_id": "396868",
    "ticket_id": "396936",
    "filename": "boarding_pass.pdf",
    "file_type": "flight_delay_boarding_or_ticket",
    "file": "/f9825c87-4e3558f6-f9b6-405c-ad3d-d1535c49b61c/crm2/CRM_Active_Files/Documents/HelpDesk/ЗАЯВКА_827_396936/flight_delay_boarding_or_ticket.pdf"
  }
]

Важно:

  • Массив [...] (даже для одного документа)
  • file без хоста → автоматически добавится https://s3.twcstorage.ru
  • ticket_id опционально (если есть → HelpDesk, иначе → Project)

📊 Формат ответа

{
  "success": true,
  "total_processed": 1,
  "successful": 1,
  "failed": 0,
  "results": [
    {
      "document_id": "15x396941",
      "document_numeric_id": "396941",
      "attached_to": "ticket",
      "attached_to_id": "396936",
      "file_name": "boarding_pass.pdf",
      "file_type": "flight_delay_boarding_or_ticket",
      "s3_bucket": "f9825c87-...",
      "s3_key": "crm2/CRM_Active_Files/...",
      "file_size": 85320,
      "message": "Документ создан и привязан..."
    }
  ],
  "errors": null
}

🧪 Тест

curl -X POST "https://crm.clientright.ru/api_attach_documents.php" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "contact_id": "320096",
    "project_id": "396868",
    "ticket_id": "396936",
    "filename": "test.pdf",
    "file_type": "flight_delay_boarding_or_ticket",
    "file": "/bucket/path/to/file.pdf"
  }
]'

🔍 Логи

tail -f /var/www/fastuser/data/www/crm.clientright.ru/logs/api_attach_documents.log

🎯 Готово к использованию в n8n!