102 lines
2.3 KiB
Markdown
102 lines
2.3 KiB
Markdown
|
# ✅ ИТОГОВОЕ РЕШЕНИЕ: Привязка документов
|
|||
|
|
|
|||
|
|
## 🎯 Прямой PHP эндпоинт (рекомендуется)
|
|||
|
|
|
|||
|
|
**URL для n8n:**
|
|||
|
|
```
|
|||
|
|
POST https://crm.clientright.ru/api_attach_documents.php
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Почему этот вариант:**
|
|||
|
|
- ✅ Нет лишних прокси-слоев
|
|||
|
|
- ✅ Не зависит от backend контейнера
|
|||
|
|
- ✅ Прямое взаимодействие с CRM
|
|||
|
|
- ✅ Проще в отладке
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📋 Формат запроса
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"claim_id": "CLM-2025-11-02-WNRZZZ",
|
|||
|
|
"event_type": "delay_flight",
|
|||
|
|
"contact_id": "320096",
|
|||
|
|
"project_id": "396868",
|
|||
|
|
"ticket_id": "396936",
|
|||
|
|
"filename": "boarding_pass.pdf",
|
|||
|
|
"file_type": "flight_delay_boarding_or_ticket",
|
|||
|
|
"file": "/bucket/path/file.pdf"
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Обязательные поля:**
|
|||
|
|
- `contact_id` - ID контакта
|
|||
|
|
- `project_id` - ID проекта (полиса)
|
|||
|
|
- `filename` (или `file_name`) - имя файла
|
|||
|
|
- `file` (или `file_url`) - путь к файлу в S3
|
|||
|
|
|
|||
|
|
**Опциональные поля:**
|
|||
|
|
- `ticket_id` - ID заявки (**если указан → привязка к HelpDesk, иначе → к Project**)
|
|||
|
|
- `file_type` - описание типа документа
|
|||
|
|
- `claim_id`, `event_type` - для логирования
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📊 Ответ
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"success": true,
|
|||
|
|
"total_processed": 1,
|
|||
|
|
"successful": 1,
|
|||
|
|
"failed": 0,
|
|||
|
|
"results": [
|
|||
|
|
{
|
|||
|
|
"document_id": "15x396941",
|
|||
|
|
"attached_to": "ticket",
|
|||
|
|
"attached_to_id": "396936",
|
|||
|
|
"file_name": "boarding_pass.pdf",
|
|||
|
|
"...": "..."
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"errors": null
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔧 Интеграция в n8n
|
|||
|
|
|
|||
|
|
### HTTP Request Node:
|
|||
|
|
|
|||
|
|
**Method:** `POST`
|
|||
|
|
**URL:** `https://crm.clientright.ru/api_attach_documents.php`
|
|||
|
|
**Authentication:** None
|
|||
|
|
**Body Content Type:** JSON
|
|||
|
|
|
|||
|
|
**Body:**
|
|||
|
|
```
|
|||
|
|
{{ $json.documents }}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Где `$json.documents` - массив из предыдущей ноды.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔍 Логи
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
tail -f /var/www/fastuser/data/www/crm.clientright.ru/logs/api_attach_documents.log
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ✅ Готово к использованию!
|
|||
|
|
|
|||
|
|
Эндпоинт протестирован и готов к production! 🚀
|
|||
|
|
|
|||
|
|
Полная документация: `/var/www/fastuser/data/www/crm.clientright.ru/API_ATTACH_DOCS_README.md`
|