Metody API udostępnione przez czat

Written By Łukasz Strumiński (Administrator)

Updated at January 19th, 2026

Widżet czata udostępnia kilka metod API, które pomagają w dostosowaniu go do specyficznych potrzeb klienta.

Ważne...⚠️

Aby możliwe było użycie poniższych metod należy najpierw zainicjalizować API poprzez wywołanie następującego kodu:

window._tc=window._tc||function(){(_tc.q=_tc.q||[]).push(arguments)};
 

Lista metod:

Otwarcie czata

Metoda pozwala na otwarcie widżetu czat.

  • _tc('open_chat'); 

Metoda pozwala na otwarcie formularza czat.

  • _tc('open_chat_form'); 

Metoda pozwala na otwarcie zminimalizowanego okna lub otwarcie nowego okna widgetu.

  • _tc('open'); 

Otwarcie oddzwonienia

Metoda pozwala na otwarcie widżetu oddzwonienia.

  • _tc('open_callback');

Metoda pozwala na otwarcie formularza widżetu oddzwonienia.

  • _tc('open_callback_form');

Otwarcie wiadomości email

Metoda pozwala na otwarcie widżetu wiadomości email.

  • _tc('open_email');

Zamknięcie widżetu

Metoda pozwala na zamknięcie otwartego widżetu.

  • _tc('close');

Minimalizowanie okienka konwersacji

Metoda pozwala na zminimalizowanie okna konwersacji.

  • _tc('minimalize');

Ustawianie domyślnych danych klienta (Imię, adres email, kolejkę czat, numer telefonu, kolejkę oddzwonień)

Metoda pozwala na ustawienie domyślnego imienia, emaila i numeru telefonu klienta oraz wybrania kolejki dla czatów i oddzwonień.

  • _tc('set_user', 'name', 'email_address', topic Id, 'phone', queue Id);

Ustawianie elementu w którym zostanie umieszczony widżet

Metoda pozwala na wybranie elementu do którego zostanie dołączony widżet (domyślnie BODY). Jako parametr przyjmuje identyfikator (id) odpowiedniego elementu.

  • _tc('set_container', 'element-id');

Nasłuchiwanie na zdarzenia (np. rozpoczęcie konwersacji)

Metoda pozwala na uruchomienie kodu po określonym zdarzeniu (np. rozpoczęciu konwersacji).

  • _tc('event_listener', function(event) { alert('Zdarzenie: ' + event); });

Obsługiwane zdarzenia:

  • conversation_created - rozpoczęcie rozmowy
  • conversation_finished - zakończenie rozmowy
  • callback_created - zamówione oddzwonienie na teraz
  • callback_finished - zakończone oddzwonienie
  • callback_scheduled - zamówione oddzwonienie na wybraną datę
  • ticket_created - zostawiona wiadomość
  • poke_showed - pokazana zaczepka
  • minimized - zminimalizowano okno widgetu poprzez przycisk "_"
  • closed - zamknięto okno przysickiem "x"
  • opened - otwarto zminimalizowany bądź zamknięty widget

Przykładowe użycie:

Ustawienie danych klienta i otwarcie czatu po kliknięcki na link na stronie

HTML:

<a href="#" id="open-chat-link">otwórz czat</a>

Java Script:

window.addEventListener('load', function () {
    window._tc = window._tc || function () {
        (_tc.q = _tc.q || []).push(arguments);
    };

    document
        .getElementById('open-chat-link')
        .addEventListener('click', function () {
            _tc('set_user', 'Janko Walski', 'janko@wals.ki');
            _tc('open_chat');
        });
});