
# Dostawca SMS (Własne konto Twilio)

Ta strona służy do zarządzania kontem Twilio używanym w **WhatsApp Business API**. Domyślnie WhatsApp Business API działa na zarządzanym koncie Twilio platformy — użytkownik nigdy nie widzi Twilio i nie musi samodzielnie rejestrować się w tej usłudze. Jeśli połączono własny klucz Anthropic (BYOK), wiadomości WhatsApp wysyłane przez zarządzane konto Twilio kosztują 0,05 kredytu każda (zarówno przychodzące, jak i wychodzące). W przypadku wszystkich innych kont koszty dostarczenia są już pokryte w ramach stawki kredytów AI, więc nie ma oddzielnej opłaty za każdą wiadomość. (Cennik wiadomości WhatsApp ulegnie zmianie 1 października 2026 r. — zobacz [Koszty WhatsApp i zmiana z października 2026 r.](../messaging-channels/whatsapp-pricing.md).) Jest to istotne tylko wtedy, gdy użytkownik chce, aby WhatsApp Business API działało na jego własnym koncie Twilio.


> **W przypadku SMS zawsze wymagane jest własne konto Twilio.** Przepisy dotyczące SMS (A2P 10DLC, rejestracja marki, zatwierdzanie identyfikatora nadawcy) muszą być dopełnione w imieniu Twojej firmy, dlatego platforma nie oferuje zarządzanych numerów SMS. Skonfiguruj SMS oddzielnie, korzystając z karty **SMS via Twilio** w Ustawienia → Kanały (dostępna jest również opcja bramki SMS na telefon z systemem Android). Ta strona — karta **Konto Twilio** — steruje kontem WhatsApp Business API i nie zmienia Twojego numeru SMS.


## Dlaczego miałbym przełączyć WhatsApp Business API na własne konto Twilio?

Większość użytkowników nie musi tego robić. Zarządzane konto jest prostsze:

- Wynajem numeru WhatsApp, przesyłanie szablonów, rejestracja nadawcy oraz dbanie o kondycję numeru są obsługiwane automatycznie. Wynajęty tutaj numer kosztuje co najmniej 50 kredytów miesięcznie, a opłata ta obejmuje połączenie z WhatsApp — zobacz [Numery telefonów](phone-numbers.md#monthly-phone-number-billing).
- Nie ma oddzielnej faktury z Twilio. Jeśli połączono własny klucz Anthropic (BYOK), wiadomości WhatsApp wysyłane przez zarządzane konto Twilio kosztują 0,05 kredytu każda (zarówno przychodzące, jak i wychodzące). W przypadku wszystkich innych kont koszty dostarczenia są już pokryte w ramach stawki kredytów AI, więc nie ma oddzielnej opłaty za każdą wiadomość. Zobacz [Koszty WhatsApp i zmiana z października 2026 r.](../messaging-channels/whatsapp-pricing.md), aby dowiedzieć się więcej o zmianach w cenniku WhatsApp, które wejdą w życie 1 października 2026 r.
- Dział wsparcia może pomóc w bezpośrednim rozwiązywaniu problemów z dostarczaniem wiadomości.

Możesz chcieć użyć własnego konta Twilio, jeśli:

- Masz już założone konto Twilio z zatwierdzonymi szablonami WhatsApp i „rozgrzanymi” numerami, z których chcesz nadal korzystać.
- Twoja firma ma powody zakupowe lub związane z przestrzeganiem przepisów, aby płacić bezpośrednio do Twilio.
- Chcesz mieć pełny wgląd w wykorzystanie i ceny na poziomie operatora.

> **Zachowanie „rozgrzanego” numeru to zadanie dwuetapowe.** Przełączenie konta (poniżej) zmienia jedynie konto Twilio, przez które wysyłamy wiadomości. Twój istniejący numer WhatsApp nie pojawi się jako kanał, dopóki go nie podłączysz — zobacz [Podłączanie posiadanego już numeru WhatsApp](#attaching-a-whatsapp-number-you-already-have). Wykonaj te czynności w tej kolejności.

---

## Jak przełączyć

**Jak tam dotrzeć:** Ustawienia → grupa **Kanały** → **Kanały**, a następnie znajdź kartę **Konto Twilio**.

To, co zobaczysz, zależy od Twojej bieżącej konfiguracji:

### Jeśli korzystasz z konta zarządzanego (domyślnie)

Zobaczysz krótkie wyjaśnienie oraz przycisk **Zarządzaj** na karcie Konto Twilio. Kliknięcie go otworzy formularz **Przełącz na własne konto Twilio**, w którym zostaniesz poproszony o podanie **Account SID** oraz **Auth Token** Twojego konta Twilio — wraz z ostrzeżeniem o nieodwracalności tej akcji wyświetlanym bezpośrednio w oknie dialogowym.


Zanim potwierdzisz, przeczytaj uważnie ostrzeżenia — przełączenie jest procesem nieodwracalnym:

- **Wszystkie numery zakupione za pośrednictwem platformy zostaną trwale zwolnione.** Jeśli chcesz nadal korzystać z numeru, pozostaw go na zarządzanym koncie (nie przełączaj) lub najpierw kup/przenieś go na własne konto Twilio.
- **Zatwierdzone szablony WhatsApp nie zostaną przeniesione.** Szablony są powiązane z kontem WhatsApp Business, do którego należy nadawca — będziesz musiał przesłać je ponownie na własnym koncie i poczekać na ponowne zatwierdzenie.
- **Istniejące czaty i historia wiadomości pozostaną widoczne**, ale nowe odpowiedzi na zwolnione numery nie będą dochodzić (numer już nie istnieje).
- **Możesz później przełączyć się z powrotem**, ale otrzymasz nowe zarządzane konto bez numerów i szablonów — stare nie zostaną przywrócone.

Gdzie znaleźć swój Account SID i Auth Token: zaloguj się do konsoli Twilio pod adresem [console.twilio.com](https://console.twilio.com). Oba dane znajdują się na głównym pulpicie nawigacyjnym, w panelu "Account Info". Identyfikator Account SID zaczyna się od `AC` i ma 34 znaki długości.

Po wprowadzeniu obu wartości i potwierdzeniu, system:

1. Sprawdza, czy dane uwierzytelniające działają.
2. Zwalnia każdy zarządzany numer telefonu z Twilio.
3. Zamyka zarządzane subkonto.
4. Zapisuje Twoje dane uwierzytelniające, aby cała przyszła komunikacja **WhatsApp** korzystała z Twojego konta. Twój oddzielnie podłączony numer **SMS przez Twilio** jest przechowywany niezależnie i nie jest zwalniany ani zmieniany przez to przełączenie.

Może to potrwać od kilku sekund do kilku minut, jeśli miałeś kilka numerów.

### Jeśli korzystasz już z własnego konta Twilio

Karta pokazuje Twoje podłączone konto i umożliwia powrót do konfiguracji zarządzanej.

Przełączenie z powrotem na konfigurację zarządzaną tworzy nowe zarządzane subkonto. Jak wspomniano powyżej: nie przywraca to numerów ani szablonów, które miałeś wcześniej — zaczynasz od zera.

---

## Podłączanie posiadanego już numeru WhatsApp

Gdy konto zostanie przeniesione na własne Twilio, przycisk **Połącz WhatsApp** na karcie **WhatsApp Business API** zmienia swoje działanie: opcja zarządzana staje się opcją **Przez Twoje konto Twilio**, która przypisuje nadawcę WhatsApp wewnątrz połączonego konta Twilio, a opcja zakupu zarządzanego numeru przestaje być dostępna. Jest to celowe działanie — zakup numeru lub przeprowadzenie rejestracji w Meta spowodowałoby utworzenie drugiego, zarządzanego przez platformę konta Twilio obok Twojego, co sprawiłoby, że wiadomości byłyby wysyłane z jednego konta, podczas gdy numer znajdowałby się na drugim.

### Zanim zaczniesz

Twój numer musi już być działającym nadawcą WhatsApp **wewnątrz Twojego własnego konta Twilio**:

- Jest zarejestrowany jako nadawca WhatsApp w Twilio i podłączony do Twojego własnego konta WhatsApp Business.
- Twilio pokazuje tego nadawcę jako **Online**.

Ten ekran nie rejestruje niczego. Nie tworzy nadawcy, nie komunikuje się z Meta i nie przesyła Twojego numeru do zatwierdzenia — łączy nadawcę, który już działa. Jeśli jeszcze go nie masz, najpierw przeprowadź konfigurację nadawcy WhatsApp w Twilio.

### Kroki

1. Przejdź do **Ustawienia** → grupa **Kanały** → **Kanały**.
2. Na karcie **WhatsApp Business API** kliknij **Podłącz swojego nadawcę**.
3. Wprowadź **numer WhatsApp** w formacie międzynarodowym (na przykład `+31612345678`), dokładnie tak, jak widnieje przy nadawcy w Twilio.
4. Opcjonalnie nadaj mu **Etykietę** — nazwę dla tego numeru wewnątrz aplikacji. Jeśli pozostawisz to pole puste, użyta zostanie nazwa z Twojego profilu nadawcy w Twilio.
5. Kliknij **Podłącz nadawcę**.

Nie musisz ponownie wprowadzać swojego identyfikatora Account SID ani tokena uwierzytelniającego: mamy je już z momentu przełączenia konta.

### Co dzieje się w tle

1. Wyszukujemy nadawcę dla tego numeru na Twoim koncie Twilio i sprawdzamy, czy Twilio ma go w trybie online.
2. Upewniamy się, że na Twoim koncie istnieje usługa przesyłania wiadomości (messaging service) i kierujemy jej przychodzący webhook na nas (tworząc nowy, nazwany na cześć aplikacji, jeśli jeszcze go nie masz). To również sprawia, że wysyłanie szablonów działa.
3. Łączymy Twojego nadawcę z tą usługą przesyłania wiadomości.
4. Kierujemy własny webhook nadawcy na nas, aby przychodzące wiadomości trafiały tutaj.
5. Numer pojawia się na Twojej liście numerów, oznaczony jako **Twój Twilio (BYO)**, gotowy do przypisania do kampanii lub agenta.

Twoje zatwierdzone szablony pozostają dokładnie tam, gdzie są, na Twoim własnym koncie. Nic nie jest ponownie przesyłane ani usuwane.

### Koszty

Nie ma miesięcznej opłaty za utrzymanie numeru podłączonego w ten sposób — płacisz bezpośrednio firmie Twilio za numer oraz opłaty za każdą wiadomość. Odpowiedzi AI nadal zużywają kredyty w standardowy sposób.

### Jeśli to nie działa

- **"No WhatsApp sender for … exists in your Twilio account"** (Brak nadawcy WhatsApp dla … na Twoim koncie Twilio) — numer nie jest tam zarejestrowany jako nadawca WhatsApp lub jest wpisany w inny sposób. Sprawdź dokładny identyfikator nadawcy w konsoli Twilio i wprowadź go ponownie w formacie międzynarodowym.
- **"The WhatsApp sender … is not online in Twilio"** (Nadawca WhatsApp … nie jest dostępny w Twilio) — powód podany przez Twilio jest zawarty w komunikacie. Napraw to najpierw w Twilio; podłączenie nadawcy, który w Twilio jest offline, spowoduje późniejszy błąd w działaniu.
- **"… is already connected to another account"** (… jest już połączony z innym kontem) — numer jest tutaj podłączony do innego konta. Najpierw odłącz go tam.
- **"This account is still on the managed Twilio account"** (To konto nadal korzysta z zarządzanego konta Twilio) — wykonaj najpierw powyższe przełączenie.
- **"we could not update its webhook in Twilio"** (nie udało nam się zaktualizować jego webhooka w Twilio) — numer jest podłączony i będzie wysyłał wiadomości, ale nadawca nadal wskazuje na webhook, który był na nim wcześniej ustawiony. Wyczyść ten webhook dla nadawcy w konsoli Twilio, aby przychodzące wiadomości docierały do nas.

---

## Limity

- Możesz zmieniać dostawców maksymalnie raz na **24 godziny**. Zapobiega to powtarzającym się błędom, które generowałyby koszty API Twilio i limity szybkości.
- Wysyłanie SMS-ów jest całkowicie niezależne od tego ustawienia — jeśli już połączyłeś własne konto Twilio za pomocą karty **SMS przez Twilio**, jest to inne połączenie i pozostaje ono bez zmian, niezależnie od tego, co zrobisz tutaj.

---

## Co zrobić, jeśli coś pójdzie nie tak?

- **"Could not authenticate with the provided Twilio credentials"** (Nie udało się uwierzytelnić za pomocą podanych danych logowania Twilio) — sprawdź dokładnie SID (zaczyna się od `AC`, ma 34 znaki) oraz token uwierzytelniający. Oba są wrażliwe na wielkość liter.
- **"Account is not active"** (Konto nie jest aktywne) — konto Twilio, którego próbujesz użyć, jest zawieszone lub zamknięte. Użyj aktywnego konta.
- **"Please wait Xh before switching again"** (Proszę poczekać X godz. przed ponownym przełączeniem) — znajdujesz się w okresie 24-godzinnej blokady. Odczekaj ten czas.
- **Częściowa migracja (niektóre numery zwolnione, inne nie)** — uruchom przełączanie ponownie. System jest idempotentny; wznawia działanie od miejsca, w którym przerwał, i kończy zwalnianie wszystkiego, co nadal znajduje się na zarządzanym subkoncie.

Jeśli utkniesz po przełączeniu — wiadomości wychodzące nie są wysyłane, szablony nie pojawiają się — skontaktuj się z pomocą techniczną, podając swój Account SID (nigdy nie podawaj tokena uwierzytelniającego).

---

## Potrzebujesz pomocy?

If you're not sure whether switching is right for you, or run into trouble, [contact support](mailto:hi@youraiconnector.com) and we can help you decide.
