Dokumentacja
Instrukcja panelu · Platforma · 6 min

Integracje

Zarządzaj ograniczonym dostępem API, webhookami i połączeniami usług zewnętrznych.

01

Przeznaczenie i lokalizacja

Zarządzaj ograniczonym dostępem API, webhookami i połączeniami usług zewnętrznych.

Otwórz Platforma → Integracje. Dostępne elementy sterujące zależą od aktywnej edycji, uprawnień modułu, roli i zakresu tenanta.

Integracje RelayPBX dla danych API i podpisanych webhooków
Systemy zewnętrzne otrzymują wyłącznie jawnie nadane zakresy i typy zdarzeń.
02

Zanim zaczniesz

Zmiany platformowe mogą wpłynąć na wszystkie tenanty. Potwierdź aktualną zweryfikowaną kopię zapasową, właściciela operacji i okno serwisowe, jeżeli działanie może zrestartować usługi lub zmienić uprawnienia licencji.

Przed zmianą masową albo zmianą routingu zapisz bieżącą wartość lub wyeksportuj objęte nią rekordy. Zapewnia to dokładny punkt porównania i ułatwia ocenę obsługiwanego cofnięcia transakcji.

03

Proces krok po kroku

Wykonuj kroki po kolei. Nie łącz pierwszej konfiguracji z niezwiązanym porządkowaniem danych; małe i jednoznaczne zmiany łatwiej sprawdzić i wycofać.

  • Utwórz minimalny wymagany zakres.
  • Przechowuj sekrety we właściwym systemie sekretów.
  • Sprawdź TLS endpointu i podpisy.
  • Rotuj dane dostępowe i przeglądaj błędy dostarczenia.
04

Opis pól

Korzystaj z poniższego opisu podczas wypełniania formularza. Pola ukryte przez edycję, licencję modułu albo rolę są celowo niedostępne dla zalogowanego użytkownika.

Typ integracji
Token API, webhook albo obsługiwany konektor usługi.
Zakresy
Dozwolone moduły i operacje.
Odwołanie do sekretu
Wskaźnik chronionego materiału uwierzytelniającego.
Zdarzenia webhook
Lista zdarzeń dostarczanych na zewnątrz.
Stan dostarczania
Informacja o sukcesie, ponowieniu i błędzie końcowym.
05

Testy akceptacyjne

Zapisanie rekordu jest dopiero początkiem weryfikacji. Wykonaj wszystkie odpowiednie testy poniżej, a przy telefonii zachowaj identyfikator sesji, czas i wynik rozmowy.

  • Po zmianie potwierdź stan usług i izolację tenantów.
  • Zapisz wynik, odpowiedzialnego operatora i punkt wycofania w dzienniku audytowym.
06

Typowe błędy i bezpieczne odzyskiwanie

Jeżeli test się nie powiedzie, nie dodawaj kolejnych zmian. Przywróć poprzednią wartość albo użyj obsługiwanego cofnięcia transakcji, wygeneruj ponownie konfigurację PBX, a następnie powtórz najmniejszy nieudany test.

  • Nie wprowadzaj zmian obejmujących całą platformę bez przetestowanej ścieżki powrotu i aktualnej zweryfikowanej kopii zapasowej.
07

Co dołączyć do zgłoszenia

Podaj tenant, moduł i nazwę obiektu, czas lokalny wraz ze strefą, wynik oczekiwany, wynik obserwowany oraz ostatni poprawny stan. Dla problemu z rozmową dołącz identyfikator logicznej sesji i zanonimizowaną diagnostykę tekstową SIP/SDP przed poproszeniem o PCAP.

Nigdy nie wklejaj do zgłoszenia haseł, kluczy prywatnych, nieprzetworzonego dokumentu licencji ani niezanonimizowanych mediów klienta. Gdy pomoc techniczna potrzebuje dodatkowych danych, użyj jednorazowej zgody diagnostycznej i chronionych załączników.