🔧 Troubleshooting Guide

🔔 Webhook не працює

Крок 1: Перевірте URL

# Правильний формат webhook URL
https://viragamesinc.app.n8n.cloud/webhook/teamtailor-hired

# НЕ використовуйте
http:// (без SSL)
/webhook-test/ (тестові endpoints)

Крок 2: Перевірте налаштування в TeamTailor

1. Settings → Integrations → Webhooks
2. Перевірте що обрані правильні події:
   • ✅ candidate.hired
   • ✅ candidate.changed (опціонально)
3. Перевірте статус: Active

Крок 3: Тест webhook

curl -X POST https://viragamesinc.app.n8n.cloud/webhook/teamtailor-hired \
  -H "Content-Type: application/json" \
  -d '{"event":"test","data":{"test":true}}'

Крок 4: Перевірте логи n8n

• Відкрийте workflow в n8n
• Перейдіть на вкладку "Executions"
• Шукайте failed або test executions

❌ API помилки

401 Unauthorized

400 Bad Request

429 Rate Limit

// Додайте delay між запитами
// n8n: Wait node з Fixed interval
{
  "interval": 1, // секунда
  "unit": "seconds"
}

500 Internal Server Error

👥 Дублікати даних

Дублікати в BambooHR

// Додайте цей код в n8n Function node
const email = $input.item.json.email;

// Перевірка існуючого співробітника
const existingEmployee = await bamboohrApi.get(
  `/employees/directory?email=${email}`
);

if (existingEmployee.length > 0) {
  throw new Error(`Employee with email ${email} already exists`);
}

Дублікати в Notion

1. Використовуйте Notion формули для перевірки унікальності
2. Створіть view з фільтром по дублікатах
3. Регулярно запускайте дедуплікацію

Видалення дублікатів

# delete_test_employees.py
import requests

def delete_duplicates(api_key, subdomain):
    # Отримати всіх співробітників
    employees = get_all_employees()
    
    # Знайти дублікати по email
    email_map = {}
    for emp in employees:
        email = emp['workEmail']
        if email in email_map:
            # Видалити старіший запис
            delete_employee(emp['id'])
        else:
            email_map[email] = emp['id']

🔄 Проблеми синхронізації

Департаменти не синхронізуються

Вакансія не створюється

• Перевірте всі обов'язкові поля в Notion
• Hiring Manager має існувати в TeamTailor
• Департамент має бути верифікований
• Зарплатна вилка в правильному форматі

🎯 TeamTailor помилки

Approval flow не працює

Пагінація обрізає дані

// Переконайтесь що обробляєте всі сторінки
while (nextUrl) {
  const response = await fetch(nextUrl);
  const data = await response.json();
  
  // ВАЖЛИВО: перевірте links.next
  nextUrl = data.links?.next;
  
  if (!nextUrl) {
    console.log('Остання сторінка досягнута');
  }
}

Resume URLs не працюють

🎋 BambooHR помилки

Employee створюється без даних

• Перевірте mapping полів в n8n
• BambooHR чутливий до типів даних
• Числа мають бути без лапок
• Дати в форматі YYYY-MM-DD

File upload не працює

Custom fields не зберігаються

// Використовуйте правильні field IDs
{
  "customField123": "value", // ❌ Неправильно
  "field_123": "value"       // ✅ Правильно
}

📝 Notion помилки

Relations не працюють

// Правильний формат для relations
{
  "Department": {
    "relation": [
      { "id": "abc-123-def" } // ID сторінки, не назва
    ]
  }
}

Формули показують помилки

• Формули read-only, не намагайтесь їх оновити через API
• Перевірте що всі залежні поля заповнені
• Оновіть сторінку в браузері для перерахунку

Rate limiting

⚙️ n8n помилки

Як працює Error Handler

Workflow зависає

1. Перевірте execution timeout (Settings → Workflow)
2. Розбийте великі workflows на менші
3. Error Handler автоматично повідомить про проблему

Memory exceeded

Credentials не працюють

• Перевірте що вибрані правильні credentials
• Test connection в налаштуваннях
• Перевірте environments (dev/prod)

⚡ Топ-10 швидких рішень

🔄 Процедури скидання

Повне скидання синхронізації

1. Зупиніть всі активні workflows
2. Очистіть TeamTailor ID в Notion
3. Видаліть тестові записи
4. Запустіть Department Sync
5. Перевірте результати
6. Відновіть автоматичні workflows

Скидання webhook

# 1. Видаліть старий webhook в TeamTailor
# 2. Створіть новий webhook
curl -X POST https://api.teamtailor.com/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://viragamesinc.app.n8n.cloud/webhook/teamtailor-hired",
    "events": ["candidate.hired"]
  }'

🚨 Екстрені випадки

Масове створення дублікатів

Втрата даних

• Перевірте Notion history (30 днів)
• BambooHR має audit log
• n8n зберігає execution history
• Відновіть з backup (якщо є)

Контакти для критичних ситуацій