> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Natywna integracja z Twilio

## Omówienie

Ten przewodnik pokazuje, jak połączyć numer telefonu Twilio z agentem ElevenLabs, aby obsługiwać połączenia przychodzące i wychodzące.

Dowiesz się, jak:

* Zaimportować istniejący numer telefonu Twilio.
* Połączyć go z agentem, by obsługiwał połączenia przychodzące.
* Inicjować połączenia wychodzące za pomocą agenta.

## Typy i możliwości numerów telefonów

ElevenLabs obsługuje dwa typy numerów telefonów Twilio o różnych możliwościach:

### Kupione numery Twilio (pełne wsparcie)

* **Połączenia przychodzące**: Obsługiwane — mogą odbierać połączenia i kierować je do agentów
* **Połączenia wychodzące**: Obsługiwane — mogą wykonywać połączenia za pomocą agentów
* **Wymagania**: Numer musi być kupiony w Twilio i widoczny w sekcji „Phone Numbers”

### Zweryfikowane identyfikatory dzwoniącego (tylko połączenia wychodzące)

* **Połączenia przychodzące**: Nieobsługiwane — nie mogą odbierać połączeń ani być przypisane do agentów
* **Połączenia wychodzące**: Obsługiwane — mogą wykonywać połączenia za pomocą agentów
* **Wymagania**: Numer musi być zweryfikowany w sekcji „Verified Caller IDs” w Twilio
* **Zastosowanie**: Idealne do użycia istniejącego numeru firmowego w wychodzących połączeniach AI

Więcej o [weryfikowaniu identyfikatorów dzwoniącego na dużą skalę](https://www.twilio.com/docs/voice/api/verifying-caller-ids-scale) znajdziesz w dokumentacji Twilio.

> **Note**
>
> Podczas importowania numeru telefonu ElevenLabs automatycznie wykrywa jego możliwości na podstawie
> konfiguracji w Twilio.

## Przewodnik

### Wymagania wstępne

* [Konto Twilio](https://twilio.com/).
* Jedno z poniższych:
  * Kupiony i skonfigurowany [numer telefonu](https://www.twilio.com/docs/phone-numbers) Twilio (dla połączeń przychodzących i wychodzących)
  * LUB [zweryfikowany identyfikator dzwoniącego](https://www.twilio.com/docs/voice/make-calls#verify-your-caller-id) w Twilio (tylko dla połączeń wychodzących)

#### Zaimportuj numer telefonu Twilio

W panelu ElevenAgents przejdź do karty [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers).

![Strona numerów telefonów ElevenAgents](/docs/_fern-img/7efb681147acd8f04803f84ed7f3289f0e90eb1fb0173e2a825836408cee89d1.webp)

Następnie uzupełnij te dane:

* **Etykieta:** Opisowa nazwa (np. `Linia obsługi klienta`).
* **Numer telefonu:** Numer Twilio, którego chcesz użyć.
* **Twilio SID:** Twój Account SID lub API Key SID Twilio.
* **Twilio Token:** Twój Auth Token lub API Key Secret Twilio.

> **Tip**
>
> **Zalecane: użyj kluczy API dla lepszego bezpieczeństwa.** Zamiast używać danych dostępowych do całego konta, możesz [utworzyć klucz API Twilio](https://www.twilio.com/docs/iam/api-keys) z ograniczonymi uprawnieniami. Po utworzeniu klucza API Twilio podaje **SID** (zaczyna się od `SK`) i **Secret** — wpisz je w powyższe pola.

> **Note**
>
> Account SID i Auth Token znajdziesz [**w konsoli administracyjnej Twilio**](https://www.twilio.com/console), a klucze API utworzysz w [sekcji kluczy API](https://www.twilio.com/console/project/api-keys).

#### Panel ElevenAgents

![Konfiguracja numeru telefonu](/docs/_fern-img/9501110d58bfeca27cb9983bc44035864504bdc2ed9c78d9decbd04802f64418.webp)

#### Konsola administracyjna Twilio

Skopiuj Twilio SID i Auth Token z [konsoli administracyjnej Twilio](https://www.twilio.com/console).

![Dane numeru telefonu](/docs/_fern-img/42da512d1cdfb4ca4504c3162fecfed108580d9488236a0cc6a4a1d23a19da14.webp)

> **Note**
>
> ElevenLabs automatycznie konfiguruje numer telefonu Twilio z właściwymi ustawieniami.

#### Zastosowane ustawienia

![Konfiguracja numeru telefonu Twilio](/docs/_fern-img/b11d57a0aa588964bbd0117d2135c55592569a4bf051f00f17aa3ee632833a47.webp)

> **Info**
>
> **Wykrywanie numeru telefonu**: ElevenLabs automatycznie wykryje, czy twój numer obsługuje:
>
> * **Połączenia przychodzące i wychodzące**: Numery kupione w Twilio
> * **Tylko połączenia wychodzące**: Numery zweryfikowane jako identyfikatory dzwoniącego w Twilio
>
> Jeśli numer nie zostanie znaleziony w żadnej z kategorii, zobaczysz błąd z prośbą o sprawdzenie, czy istnieje na twoim koncie Twilio.

#### Przypisz agenta (tylko numery obsługujące połączenia przychodzące)

Jeśli twój numer telefonu obsługuje połączenia przychodzące, możesz przypisać agenta do obsługi połączeń przychodzących.

![Wybierz agenta do połączeń przychodzących](/docs/_fern-img/b85c122ef8607527041516e789b0a19047cbf85a13cd3237ee5a7670683815a7.webp)

> **Note**
>
> Numery obsługujące tylko połączenia wychodzące (zweryfikowane identyfikatory dzwoniącego) nie mogą być przypisane do agentów i
> będą wyświetlane jako wyłączone na liście agentów.

Przetestuj agenta, dzwoniąc na ten numer telefonu. Agent jest teraz gotowy obsługiwać połączenia przychodzące i rozmawiać z klientami.

> **Tip**
>
> Monitoruj pierwsze połączenia w [panelu historii połączeń](https://elevenlabs.io/app/agents/history), aby upewnić się, że wszystko działa zgodnie z oczekiwaniami.

## Wykonywanie połączeń wychodzących

> **Info**
>
> Zarówno kupione numery Twilio, jak i zweryfikowane identyfikatory dzwoniącego mogą być używane do połączeń wychodzących. Przycisk połączenia
> wychodzącego będzie wyłączony dla numerów, które nie obsługują połączeń wychodzących.

Zaimportowany numer telefonu Twilio możesz też wykorzystać do inicjowania połączeń wychodzących, podczas których agent dzwoni na wskazany numer.

#### Zainicjuj połączenie wychodzące

Na karcie [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers) znajdź zaimportowany numer Twilio i kliknij przycisk **Outbound call**.

![Przycisk połączenia wychodzącego](/docs/_fern-img/953a870b0ab0c0aa30872b3692260f0879f390d4b4b83c7f82e816385504034f.webp)

#### Skonfiguruj połączenie

W oknie połączenia wychodzącego:

1. Wybierz agenta, który poprowadzi rozmowę
2. Wpisz numer telefonu, na który chcesz zadzwonić
3. Kliknij **Send Test Call**, aby zainicjować połączenie

![Konfiguracja połączenia wychodzącego](/docs/_fern-img/f6b01412a68217661028e6924ce90089bdd5eaa693c8aeafbc321c632de921b7.webp)

Po zainicjowaniu odbiorca otrzyma połączenie z twojego numeru Twilio. Gdy odbierze, agent rozpocznie rozmowę.

> **Tip**
>
> Połączenia wychodzące pojawiają się w [panelu historii połączeń](https://elevenlabs.io/app/agents/history)
> obok połączeń przychodzących, dzięki czemu możesz przejrzeć wszystkie rozmowy.

> **Note**
>
> W połączeniach wychodzących agent inicjuje rozmowę, więc upewnij się, że ma skonfigurowane odpowiednie
> wiadomości początkowe, by skutecznie rozpocząć rozmowę.