Thulium REST API to interfejs programistyczny umożliwiający zewnętrznym aplikacjom komunikację z platformą contact center — pobieranie danych o połączeniach, zarządzanie agentami, inicjowanie połączeń wychodzących, pobieranie nagrań i wiele innych operacji, które można zautomatyzować bez ręcznego klikania w panelu. API Thulium jest udokumentowane w standardzie REST z autoryzacją przez API Key lub OAuth 2.0, co pozwala na integrację z praktycznie dowolnym systemem posiadającym możliwość wysyłania żądań HTTP. Pierwsze kroki z API Thulium wymagają zapoznania się z dokumentacją, wygenerowania klucza API i przetestowania podstawowych endpointów.
Serwis Wiatraczna pomaga w pierwszych krokach z API Thulium — konfiguracji autoryzacji, testowaniu endpointów i budowaniu pierwszych integracji. Jeżeli masz trudności z połączeniem się z API Thulium lub potrzebujesz pomocy przy tworzeniu integracji — skontaktuj się z naszym zespołem technicznym.
Thulium REST API — pierwsze kroki z interfejsem programistycznym
API to brama, przez którą zewnętrzne systemy mogą rozmawiać z Thulium. Znajomość podstaw pracy z API Thulium jest fundamentem każdej niestandardowej integracji — od prostego pobierania raportów do zewnętrznego Excela po pełną synchronizację danych z CRM.
Wygenerowanie klucza API Thulium
Dostęp do API Thulium wymaga klucza API (API Key) generowanego w panelu administratora. Klucz jest unikalnym tokenem uwierzytelniającym — każde żądanie do API musi zawierać go w nagłówku HTTP (zazwyczaj jako `X-API-Key` lub `Authorization: Bearer
Struktura API Thulium — zasoby i metody
Thulium API jest zorganizowane wokół zasobów: `/calls` (dane o połączeniach), `/agents` (agenci i ich statusy), `/queues` (kolejki i ich parametry), `/recordings` (nagrania), `/campaigns` (kampanie outbound), `/contacts` (kontakty). Każdy zasób obsługuje standardowe metody HTTP: GET (pobieranie danych), POST (tworzenie nowych rekordów), PUT/PATCH (aktualizacja), DELETE (usunięcie). Odpowiedzi API są w formacie JSON z czytelną strukturą danych i standardowymi kodami błędów HTTP (200 OK, 400 Bad Request, 401 Unauthorized, 404 Not Found, 429 Too Many Requests).
Testowanie API przez narzędzia deweloperskie
Przed integracją warto przetestować endpointy API Thulium ręcznie używając narzędzi takich jak Postman, Insomnia lub curl. Przykład najprostszego żądania GET pobierającego listę połączeń: `curl -H "X-API-Key: TWÓJ_KLUCZ" "https://api.thulium.com/v1/calls?date_from=2024-01-01"`. Testowanie pomaga zrozumieć strukturę odpowiedzi, zidentyfikować wymagane parametry i sprawdzić, czy uprawnienia klucza API są wystarczające do planowanych operacji. Dokumentacja API Thulium zawiera interaktywny sandbox do testowania bez pisania kodu.
Limity wywołań API (rate limiting)
Thulium API stosuje rate limiting — maksymalną liczbę żądań w jednostce czasu (zazwyczaj per minuta lub per godzinę). Przekroczenie limitu skutkuje odpowiedzią 429 Too Many Requests. Przy projektowaniu integracji należy uwzględnić: buforowanie wyników często używanych zapytań, implementację mechanizmu retry z exponential backoff przy odpowiedzi 429, pobieranie danych w odpowiednich interwałach zamiast ciągłego pollingu i używanie webhooków zamiast pollingu tam, gdzie to możliwe. Konkretne limity są dostępne w dokumentacji Thulium i mogą się różnić w zależności od planu abonamentowego.
Pierwsze żądanie API — inicjowanie połączenia wychodzącego
Jednym z najpopularniejszych zastosowań API Thulium jest click-to-call: system CRM lub aplikacja webowa przesyła żądanie POST do API z numerem telefonu klienta i identyfikatorem agenta, a Thulium inicjuje połączenie telefoniczne. Pozwala to na zintegrowanie przycisku „Zadzwoń" bezpośrednio w interfejsie CRM, eliminując ręczne wybieranie numeru przez agenta. Implementacja wymaga autoryzowanego klucza API z uprawnieniami do tworzenia połączeń i obsługi odpowiedzi asynchronicznej (Thulium zwraca identyfikator zainicjowanego połączenia, a nie wynik rozmowy).
Pierwsze kroki z API Thulium — Serwis Wiatraczna
Serwis Wiatraczna pomaga firmom wdrożyć integracje oparte na API Thulium — od konfiguracji autoryzacji przez pierwsze żądania po pełne integracje z systemami business. Skontaktuj się z nami, jeżeli potrzebujesz wsparcia przy pracy z API Thulium.
