# Telefon (SMS)

Konfiguracja bramki dostarczającej kody jednorazowe przez SMS lub połączenie głosowe (bramka wbudowana, Twilio lub własna bramka HTTP).

Requires: customSmsGateway

> **Uwaga dotycząca planu:** Własna bramka SMS jest dostępna w planie Essential i wyższych. Zobacz [Plany i dodatki](https://dts-identity.com/pl/docs/getting-started/plans-and-addons.md). W niższych planach platforma wysyła kody jednorazowe przez swoją wbudowaną bramkę.

Platforma dostarcza kody jednorazowe przez SMS na potrzeby telefonicznego [uwierzytelniania wieloskładnikowego](https://dts-identity.com/pl/docs/security/multi-factor-authentication.md) oraz weryfikacji numerów telefonu. Wbudowana bramka działa od razu; w planie Essential i wyższych można kierować te wiadomości przez własnego dostawcę.

[Image: Karta Telefon w ustawieniach brandingu]

## Wybór bramki

1. W Admin Console otwórz **Branding → Telefon**.
2. Wybierz dostawcę:
   - **Wbudowana brama**: usługa domyślna. Nie wymaga konfiguracji.
   - **Twilio**: wysyłka przez własne konto Twilio.
   - **Bramka niestandardowa**: wysyłka przez dowolne API SMS oparte na HTTP.
3. Skonfiguruj pola dla wybranej opcji (poniżej) i wybierz **Zapisz zmiany**.

## Twilio

Podaj **Account SID** i **Token uwierzytelniający** konta Twilio, a następnie określ sposób wysyłania wiadomości:

- **Nadawca**: **Numer nadawcy** albo **Messaging Service SID**. Messaging Service dotyczy wiadomości tekstowych; połączenia głosowe zawsze używają numeru nadawcy.
- **Metody dostarczania**: dostarczanie kodu jako **Wiadomość tekstowa (SMS)**, jako **Połączenie głosowe** lub na oba sposoby.

## Bramka niestandardowa

Platformę można skierować na dowolne API SMS oparte na HTTP:

- **Adres URL bramki** i **Metoda HTTP** (GET lub POST).
- Dla POST: **Format treści** (JSON, form-encoded lub raw) oraz szablon **Request body**. Dla treści raw można ustawić **Content-Type**.
- **Nagłówki niestandardowe**: jeden `Name: value` w każdym wierszu, przydatne np. dla nagłówka `Authorization`.
- **Nazwa użytkownika**, **Hasło** i **Token uwierzytelniający** dla bramek, które ich wymagają.

Adres URL, treść żądania i nagłówki obsługują symbole zastępcze, które są podstawiane w momencie wysyłki, w tym numer odbiorcy i tekst wiadomości, na przykład `https://api.example.com/send?to={{to}}&text={{message}}` albo nagłówek w rodzaju `Authorization: Bearer {{authToken}}`.

## Pola z sekretami

Wartości poufne, takie jak Auth Token Twilio oraz hasło i token uwierzytelniający bramki niestandardowej, są przechowywane w bezpieczny sposób i nigdy nie są wstępnie wypełniane. **Pozostawienie pola z sekretem pustego zachowuje jego bieżącą wartość**; nową wartość należy wpisać tylko wtedy, gdy ma zostać zmieniona.

## Treść wiadomości

Tekst wiadomości z kodem pochodzi z wbudowanych, przetłumaczonych sformułowań platformy i nie jest edytowany na tej stronie. Treść opiera się na zlokalizowanych tekstach językowych instancji, dlatego język wiadomości odpowiada ustawieniom regionalnym użytkownika (lub instancji), a nie edytorowi poszczególnych szablonów.

## Ochrona przed nadużyciami

Wychodzące wiadomości SMS mają limit liczby wysyłek na użytkownika, więc pojedyncze konto nie może wywołać nieograniczonej liczby wiadomości. Chroni to przed przypadkowymi pętlami i celowymi nadużyciami, które w przeciwnym razie zwiększałyby koszty dostarczania.

## Rozwiązywanie problemów

- **Kody nie docierają**: sprawdź poprawność danych uwierzytelniających bramki, zapisz ponownie, a następnie przetestuj przepływ jeszcze raz. Pola z sekretami są po zapisaniu celowo puste; nie oznacza to, że wartość została usunięta.
- **Połączenie głosowe Twilio bez numeru**: Messaging Service SID obejmuje wyłącznie SMS; aby włączyć dostarczanie głosowe, dodaj numer nadawcy.
- **Bramka niestandardowa zwraca błąd**: sprawdź, czy adres URL, metoda HTTP, format treści i symbole zastępcze odpowiadają oczekiwaniom dostawcy.
