[Intum Pomoc V1](https://intum.intum.pl/kb/intum-kb-v1.md) / [Chat Firmowy](https://intum.intum.pl/kb/intum-kb-v1/chat.md) # [Intum Chat - firmowy komunikator wewnętrzny](https://intum.intum.pl/kb/intum-kb-v1/chat/intum-chat.md) | [API](#api) **Intum Chat** to wbudowany komunikator, który przenieść całą komunikację zespołową bezpośrednio do systemu. Pozwala zrezygnować z zewnętrznych aplikacji i trzymać ustalenia firmowe dokładnie tam, gdzie realizowane są zadania i obsługa klientów. ### Dlaczego warto korzystać z Intum Chatu? - **Wszystko w jednym miejscu:** Brak konieczności przełączania się między zewnętrznymi komunikatorami a systemem CRM - **Brak zagubionych ustaleń:** Cała historia rozmów firmowych zostaje w systemie i jest łatwa do odnalezienia. - **Wygodna współpraca:** Szybkie przesyłanie plików, zrzutów ekranu ze schowka oraz wzmianki o współpracownikach. ## 1. Włączanie modułu i dostęp Aby zacząć korzystać z czatu, administrator musi upewnić się, że moduł jest aktywny na koncie: 1. Przejdź do **4 kropki -> sekcja Konto -> Moduły**. 2. Włącz moduł **Czat (Czat firmowy - rozmowy zespołu, kanały i wątki)**. ![](f5251fedcff3-Screenshot - 2026-09-01T105054.864.png) Po aktywacji moduł będzie dostępny w sekcji **Praca zespołowa -> Czat** (lub bezpośrednio pod adresem `/chat`). ![](452bceb6790b-Screenshot - 2026-09-01T105144.597.png) ## 2. Tworzenie rozmów i rodzaje pokoi W panelu czatu po lewej stronie znajduje się lista Twoich aktywnych rozmów. Nowe konwersacje możesz rozpocząć bezpośrednio nad listą: ![](0fb6c2ac1cf2-różne pokoje.png) - **Rozmowa 1:1:** Kliknij ikonę **`@`** nad listą rozmów i wybierz współpracownika z listy. Z każdą osobą masz jeden wspólny wątek, którego historia nie ginie. - **Nowy pokój / kanał grupowy:** Kliknij ikonę **`+`** nad listą rozmów, aby utworzyć nowy pokój dyskusyjny przeznaczony dla grupy osób lub całego działu (np. `#Rozmowy o marketingu`). Do pokoju możesz zapraszać kolejne osoby (ikona 👥 w nagłówku rozmowy) > **Dla administratora:** Pełne tworzenie i edycja pokoi wraz z wyborem ich dokładnego rodzaju (Kanał, Rozmowa 1:1, Rozmowa o obiekcie, Agent AI) jest również dostępne z poziomu menu **Ustawienia -> Pokoje** (`/chat/rooms`). ![](d5708556e9a6-dodawanie pokoju.png) ## 3. Pisanie wiadomości i funkcje edytora Podczas prowadzenia rozmów dostępne są funkcje ułatwiające codzienną komunikację: - **Wzmianki (@):** Wpisz `@`, aby wywołać konkretną osobę (dostanie powiadomienie), lub `@all`, aby powiadomić wszystkich uczestników pokoju. ![](62380b0a0854-Screenshot - 2026-09-01T112016.685.png) - **Emoji i reakcje:** Korzystaj z menu emoji (`:-)`), skrótów tekstowych (np. `:tada:`) lub dodawaj reakcje bezpośrednio do wysłanych wiadomości. - **Zrzuty ekranu i pliki:** Wklejaj zrzuty ekranu bezpośrednio ze schowka (`Ctrl+V`) lub dołączaj pliki z dysku za pomocą ikony spinacza (`📎`). - **Edycja i usuwanie:** Swoje wiadomości możesz w każdej chwili edytować lub usunąć po najechaniu na nie kursorem. ## 4. Ustawienia i powiadomienia W sekcji **Czat -> Ustawienia** możesz dostosować zachowanie komunikatora: - **Dołączaj osobę odpowiedzialną do nowej rozmowy przy obiekcie:** Automatycznie dodaje opiekuna zadania/zgłoszenia do wątku. - **Potwierdzenia przeczytania:** Pokazuje miniatury osób, które doczytały rozmowę do danego momentu. - **Personalizacja notyfikacji:** W sekcji powiadomień dzwonka możesz wybrać sposób informowania o nowych wiadomościach na czacie (np. *Kropka i dźwięk* lub *Kropka od razu*). ## 5. Administracja i moderacja (dla Administratorów) Administrator konta ma pełny wgląd w historię oraz możliwość moderacji rozmów z poziomu zakładek **Pokoje** (`/chat/rooms`) oraz **Wiadomości** (`/chat/messages`). Pozwala to na sprawną analitykę i wyszukiwanie potrzebnych wątków w całej firmie. --- ## API ### Ogólne API # Intum API Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy. ## Host Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta) ## Autoryzacja Wszystkie requesty API wymagają `api_token`: - header: `Authorization: Bearer TOKEN` Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API** # Chat - API Moduł `chat` musi być aktywny na koncie, token z uprawnieniem **chat**. **Autoryzacja:** `Authorization: Bearer TOKEN` ## Endpointy | Metoda | Ścieżka | Opis | |--------|---------|------| | GET | `/chat.json` | Pokoje zalogowanego użytkownika | | GET | `/chat/rooms.json` | Wszystkie pokoje konta (admin; `q`, `kind`) | | POST | `/chat/rooms.json` | Utworzenie/znalezienie pokoju | | PATCH | `/chat/rooms/:id.json` | Zmiana nazwy (owner/admin) | | DELETE | `/chat/rooms/:id.json` | Usunięcie pokoju (owner/admin) | | GET | `/chat/rooms/:id/members.json` | Członkowie pokoju | | POST | `/chat/rooms/:id/add_member.json?user_id=X` | Dodanie osoby | | POST | `/chat/rooms/:id/remove_member.json?user_id=X` | Usunięcie osoby (owner/admin) | | POST | `/chat/rooms/:id/join.json` | Dołączenie (kanały) | | POST | `/chat/rooms/:id/leave.json` | Opuszczenie (rozmowy 1:1 nie da się opuścić) | | POST | `/chat/rooms/:id/mark_read.json` | Oznaczenie jako przeczytane | | GET | `/chat/rooms/:id/messages.json` | Historia (od najnowszych; paginacja `before_id`) | | POST | `/chat/rooms/:id/messages.json` | Wysłanie wiadomości | | GET | `/chat/messages.json` | Wszystkie wiadomości (admin; `q`, `kind`, `room_id`) | | PATCH | `/chat/messages/:id.json` | Edycja własnej wiadomości | | DELETE | `/chat/messages/:id.json` | Usunięcie (autor/admin) | | POST | `/chat/messages/:id/toggle_reaction.json?emoji=👍` | Reakcja emoji | Id pokoi i wiadomości to uuid (string). ## Tworzenie pokoi Rozmowa 1:1 (find-or-create per para): ```json { "chat_room": { "kind": "dm", "user_id": 5 } } ``` Kanał: ```json { "chat_room": { "kind": "group", "name": "Ogólny", "user_ids": [5, 7] } } ``` Rozmowa w kontekście obiektu (jeden pokój per obiekt; `subject_type`: `Organize::Task`, `Organize::Project`, `Organize::Team`, `Mail::Email`, `Helpdesk::Ticket`, `Crm::Client`): ```json { "chat_room": { "kind": "subject", "subject_type": "Organize::Task", "subject_id": 123 } } ``` ## Wysłanie wiadomości ```json { "chat_message": { "content": "Treść (markdown)", "parent_id": null } } ``` Wzmianka to token z ID: `@[Imię Nazwisko](user:5)` - użytkownik 5 dostanie powiadomienie, jeśli jest członkiem pokoju. `@all` / `@here` powiadamia wszystkich członków. --- ## Powiązane - [Jak korzystać z czatu wewnętrznego przy zadaniach, projektach i e-mailach?](https://intum.intum.pl/kb/intum-kb-v1/chat/czat-w-kontekscie-zadan-projektow-i-klientow.md)