Перейти до змісту

Організації (Organizations)

Керуйте організаціями у вашому обліковому записі ChatHub. Організації виступають в ролі контейнерів для операторів та їхніх операцій у чатах.

Огляд

Організації в ChatHub дозволяють:

  • Групувати операторів за відділами, командами або функціями.
  • Ізолювати роботу з чатами між різними бізнес-відділами компанії.
  • Керувати правами доступу на рівні відділів (організацій).
  • Відстежувати показники кожної організації окремо.

Список Організацій

Отримайте список всіх організацій, до яких ви маєте доступ, використовуючи токен компанії.

Ендпоінт

GET /api/company/organization

Запит

curl -X GET https://chatapi.smsbat.com/api/company/organization \
  -H "Authorization: Bearer {company-token}" \
  -H "Accept: text/plain"

Заголовки (Headers)

Заголовок Значення Обов'язково Опис
Authorization Bearer Так Токен компанії (Company Token)
Accept text/plain Так Формат відповіді

Відповідь (Response)

[
  {
    "id": 6,
    "name": "Customer Support"
  },
  {
    "id": 24,
    "name": "Sales Team"
  },
  {
    "id": 42,
    "name": "Technical Support"
  }
]

Поля Відповіді

Поле Тип Опис
id integer Унікальний ідентифікатор організації
name string Відображуване ім'я організації

Структура Організації

Кожна організація містить:

  • Операторів: Агентів чату (консультантів), призначених на цю організацію.
  • Діалоги (Chat Sessions): Активні розмови та історія чатів.
  • Віджети (Widgets): Вбудовані віджети для чату, прив'язані до конкретної організації.
  • Налаштування: Специфічні налаштування для відділу.

Випадки використання (Use Cases)

Компанія з кількома відділами

Компанія: ACME Corp
├── Організація: Відділ Продажів (id: 10)
│   ├── Оператор: John (Менеджер з продажів)
│   └── Оператор: Sarah (Керівник відділу)
├── Організація: Підтримка (id: 20)
│   ├── Оператор: Mike (Агент підтримки)
│   └── Оператор: Lisa (Старший агент)
└── Організація: Технічний Відділ (id: 30)
    └── Оператор: Alex (Тех. Експерт)

Бізнес на кілька брендів

Компанія: Retail Group
├── Організація: Бренд A (id: 101)
│   └── Віджет на сайті: branda.com
├── Організація: Бренд B (id: 102)
│   └── Віджет на сайті: brandb.com
└── Організація: Бренд C (id: 103)
    └── Віджет на сайті: brandc.com

Кращі Практики

Кешування (Caching)

Аби не вичерпувати ліміти API, кешуйте список організацій, оскільки вони не так часто змінюються.

Обробка Помилок (Error Handling)

Якщо виникає помилка 401 Unauthorized, перевірте, чи не сплив (протермінувався) ваш Company Token. Якщо так, запросіть його ще раз.

Валідація ідентифікаторів

Завжди зіставляйте organizationId при створенні операторів із дійсним списком організацій у системі бази даних.

Наступні Кроки