> 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.

# WhatsApp

## Omówienie

Możesz połączyć konto firmowe WhatsApp z agentem ElevenLabs. Agent może wtedy obsługiwać:

* Rozmowy przez wiadomości — tekst, notatki głosowe, multimedia i [wiadomości interaktywne](/docs/pl/eleven-agents/whatsapp/interactive-messages)
* Połączenia — przychodzące i [wychodzące](/docs/pl/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call)

Agenci na innych kanałach mogą też wysyłać wiadomości WhatsApp przez [narzędzia WhatsApp](/docs/pl/eleven-agents/whatsapp/tools).

Dopiero zaczynasz korzystać z WhatsApp w ElevenLabs? Przejdź do [przewodnika na start](/docs/pl/eleven-agents/whatsapp/getting-started).

## Importowanie konta firmowego WhatsApp

#### Zaimportuj konto

Przejdź na [stronę WhatsApp](https://elevenlabs.io/app/agents/whatsapp) i kliknij ***Importuj konto***:

![Strona WhatsApp](/docs/_fern-img/734d6e0c2af1c50b769700e084368bed2a8c7eccf47aece6cfb6fc5ca7623f44.webp)

#### Autoryzuj ElevenLabs

Otworzy się proces autoryzacji, w którym wybierzesz konto i zezwolisz ElevenLabs na zarządzanie nim:

![Proces autoryzacji WhatsApp](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp)

#### Przypisz agenta

Po zaimportowaniu konta przejdziesz do strony jego ustawień, gdzie możesz przypisać do niego agenta:

![Strona konta WhatsApp](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp)

> **Info**
>
> Jeśli nie przypiszesz agenta do konta, wiadomości przychodzące będą ignorowane, a połączenia przychodzące
> odrzucane. Nadal jednak będziesz mieć możliwość wykonywania połączeń wychodzących.

#### Skonfiguruj WhatsApp Manager

Przejdź do [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/), aby:

* Ustawić zdjęcie profilowe itp.: otwórz stronę ***Numery telefonów***, wybierz numer i przejdź do karty ***Profil***
* Zezwolić na połączenia głosowe: otwórz stronę ***Numery telefonów***, wybierz numer i przejdź do karty ***Ustawienia połączeń***
* Jeśli chcesz wykonywać połączenia wychodzące, dodaj metodę płatności: otwórz stronę ***Przegląd*** i kliknij ***Dodaj metodę płatności***

## Ustawienia konta

Każdy zaimportowany numer ma ustawienia określające zachowanie agenta:

* **Włącz wiadomości** — określa, czy agent odpowiada na wiadomości. Wyłącz tę opcję, aby ElevenLabs obsługiwał tylko połączenia, a wiadomości obsługiwała twoja aplikacja.
* **Włącz odpowiedzi na wiadomości audio** — gdy opcja jest włączona (domyślnie), agent odpowiada na notatki głosowe notatkami głosowymi; gdy jest wyłączona, zawsze odpowiada tekstem.
* **Włącz wskaźnik pisania** — gdy opcja jest włączona (domyślnie), agent oznacza przychodzące wiadomości jako przeczytane i wyświetla wskaźnik pisania podczas tworzenia odpowiedzi.

## Rozmowy przez wiadomości

Rozmowy przez wiadomości WhatsApp kończą się, gdy agent użyje systemowego [narzędzia ***Zakończ rozmowę*** ](/docs/pl/eleven-agents/customization/tools/system-tools/end-call), upłynie ustawiony **\_Maksymalny
czas trwania rozmowy \_** lub domyślny limit bezczynności po ostatniej odpowiedzi agenta.

> **Info**
>
> Rozmowy przez wiadomości WhatsApp mają domyślny 15-minutowy limit bezczynności liczony od
> ostatniej odpowiedzi agenta. Dowiedz się więcej o [limitach czasu rozmów](/docs/pl/eleven-agents/customization/conversation-flow#maximum-conversation-duration).

### Przychodzące

Możesz wysłać wiadomość na firmowe konto WhatsApp, a agent odpowie:

![Rozmowa tekstowa WhatsApp](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp)

Po upływie dowolnego z limitów ElevenAgents wysyła ustawioną **\_Wiadomość o maksymalnym czasie
trwania rozmowy \_**, a następnie zamyka rozmowę. Jeśli wiadomość jest pusta, rozmowa kończy się
bez pożegnania.

Agent rozumie więcej niż zwykły tekst:

* **Odpowiedzi cytowane** — gdy użytkownik przytrzyma wiadomość i na nią odpowie, agent wie, na którą wiadomość odpowiada.
* **Reakcje** — reakcje emoji na wiadomości agenta są przekazywane agentowi.
* **Kliknięcia przycisków szablonu** — gdy użytkownik kliknie przycisk szybkiej odpowiedzi w szablonie, agent widzi, który przycisk został wybrany.
* **Odpowiedzi interaktywne** — kliknięcia [przycisków i list interaktywnych](/docs/pl/eleven-agents/whatsapp/interactive-messages) docierają z wybraną opcją.

> **Note**
>
> Agent odpowiada na każdą przychodzącą wiadomość osobno. Szybko wysłane kolejne wiadomości nie są
> łączone w jedną odpowiedź.

### Wychodzące

Możesz rozpocząć rozmowę, wysyłając zatwierdzony przez Meta szablon wiadomości z panelu lub przez API, a także planować połączenia wychodzące z prośbą o zgodę na połączenie. Informacje o tworzeniu szablonów, przykłady kodu, zasady formatu odbiorców i kampanie zbiorcze znajdziesz w sekcji [Wiadomości wychodzące i szablony](/docs/pl/eleven-agents/whatsapp/outbound).

### Typy wiadomości

Oprócz tekstu możesz też wysyłać:

* audio
  * Przychodzące notatki głosowe są transkrybowane na tekst przed przekazaniem agentowi.
  * Domyślnie agent odpowiada na notatki głosowe notatkami głosowymi wygenerowanymi w skonfigurowanym głosie agenta — dowolnym głosie, w dowolnym języku. Wyłącz ***Włącz odpowiedzi na wiadomości audio*** w ustawieniach konta, aby zawsze odpowiadać tekstem. Jeśli generowanie audio się nie powiedzie, agent odpowie tekstem.
  * Wiadomości audio wiążą się z dodatkowymi opłatami za zamianę mowy na tekst i zamianę tekstu na mowę. Ceny są takie same jak w API STT i TTS.
* obraz
* dokument
* naklejka
* lokalizacja
* kontakt

![Rozmowa audio WhatsApp](/docs/_fern-img/372158bc0f86d62b6742f2bb44a741e5299ee7b95e36e38c3df1f9c06cffe2a0.webp)![Rozmowa ze zdjęciem WhatsApp](/docs/_fern-img/cbfbadb9d0a20f35537ce3bd137eb12b1005a862a7e1cf0155d271502fb713da.webp)![Rozmowa z dokumentem WhatsApp](/docs/_fern-img/2b91d4077ac19a56dda9c5c016a47ed7d574ba2cb77ac89eb8785925bc89fa13.webp)![Rozmowa z lokalizacją WhatsApp](/docs/_fern-img/bcd0d8f7df69d6c381be5be7c7a91ec7752b2b1894a80539823b7d9266beb3dd.webp)![Rozmowa z kontaktami WhatsApp](/docs/_fern-img/75e56544700c87817a7f842943301a95e9e0b1fb84fc87e19139adb77f49ea5a.webp)

## Połączenia

### Przychodzące

Możesz zadzwonić na firmowe konto WhatsApp, a agent odpowie. Podczas połączenia możesz też wysyłać wiadomości tekstowe — zostaną uwzględnione w rozmowie.

### Wychodzące

Połączenia wychodzące wymagają zgody użytkownika, o którą prosisz przez szablon. Informacje o procesie, przykłady kodu i połączenia zbiorcze znajdziesz w sekcji [planowanie połączenia wychodzącego](/docs/pl/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call).

## Personalizacja

Ustawiamy [zmienne dynamiczne](/docs/pl/eleven-agents/customization/personalization/dynamic-variables) `{{system__caller_id}}` i `{{system__called_number}}` na identyfikator użytkownika WhatsApp oraz identyfikator twojego numeru telefonu WhatsApp (lub odwrotnie, zależnie od tego, kto rozpoczął rozmowę). Możesz użyć ich w narzędziu lub [webhooku rozpoczęcia rozmowy](/docs/pl/eleven-agents/customization/personalization#conversation-initiation-webhooks), aby pobrać informacje o użytkowniku podczas rozmowy.

> **Info**
>
> Identyfikator numeru telefonu WhatsApp znajdziesz, przechodząc na [stronę WhatsApp ](https://elevenlabs.io/app/agents/whatsapp), klikając menu obok konta i wybierając
> ***Kopiuj identyfikator numeru telefonu***.

### Kontekst inicjalizacji

Jeśli agent używa [zmiennych dynamicznych](/docs/pl/eleven-agents/customization/personalization/dynamic-variables) innych niż powyższe zmienne systemowe, musisz zaplanować źródło ich wartości. Jeśli agent nie używa zmiennych dynamicznych, ta sekcja cię nie dotyczy.

**Rozmowy przychodzące** rozpoczynają się bez zmiennych dynamicznych podanych przez użytkownika. Obsługiwany sposób przekazywania wartości to [webhook rozpoczęcia rozmowy](/docs/pl/eleven-agents/customization/personalization#conversation-initiation-webhooks): gdy wiadomość WhatsApp rozpoczyna rozmowę, ElevenAgents wywołuje twój endpoint z identyfikatorem użytkownika WhatsApp jako `caller_id` i identyfikatorem twojego numeru telefonu WhatsApp jako `called_number`, a następnie stosuje zmienne dynamiczne zwrócone w odpowiedzi. Webhook powinien zawsze zwracać każdą zmienną wymaganą przez agenta — wartość z CRM, gdy ją masz, lub stałą wartość zastępczą w innym przypadku.

> **Warning**
>
> Wartości wpisane w sekcji **Zmienne dynamiczne** w edytorze agenta to testowe wartości zastępcze do
> podglądu agenta. Nie są używane na produkcji i nie działają jako wartości domyślne dla rozmów
> przychodzących.

**Rozmowy wychodzące** otrzymują wartości z pola `conversation_initiation_client_data.dynamic_variables` [żądania wiadomości wychodzącej lub połączenia](/docs/pl/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments). Wartości te pozostają dla całej rozmowy i są nadal dostępne, gdy użytkownik odpowie. Parametry szablonu są osobnym polem i nie uzupełniają zmiennych dynamicznych.

Wymagana zmienna bez wartości spowoduje błąd rozmowy. Zobacz [brakujące zmienne dynamiczne](/docs/pl/eleven-agents/whatsapp/troubleshooting#the-agent-doesnt-respond-to-inbound-messages) w przewodniku rozwiązywania problemów.

> **Note**
>
> Wartość `system__called_number` to identyfikator **numeru telefonu** WhatsApp, a nie sam numer
> telefonu. Identyfikatory użytkowników WhatsApp również przechodzą na [identyfikatory użytkowników zależne od firmy (BSUID)](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids);
> ElevenAgents obsługuje BSUID, więc rozmowy działają nawet wtedy, gdy Meta podaje identyfikator zamiast
> numeru telefonu użytkownika.

## Ograniczenia

Obecnie nie są obsługiwane:

* **WhatsApp Flows** — nie można wysyłać interaktywnych formularzy, a odpowiedzi Flow nie są przekazywane agentowi.
* **Wiadomości wideo** — przychodzące filmy nie są przekazywane agentowi.
* **Grupowanie wiadomości** — agent odpowiada na każdą wiadomość osobno, zamiast łączyć szybko wysłane kolejne wiadomości.
* **Numery zarządzane przez innego dostawcę** — numer zarejestrowany u innego dostawcy WhatsApp lub aktywny w aplikacji WhatsApp Business nie może zostać zaimportowany. Współpracujemy z Meta, aby włączyć [Multi-Solution Conversations](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations); konfiguracje tylko głosowe mogą już być możliwe przez SIP (zobacz [FAQ](/docs/pl/eleven-agents/whatsapp/troubleshooting#faq)).
* **WABA utworzone w aplikacji deweloperskiej** — nie można ich importować standardowym procesem.
* **Metadane przekierowań reklamowych** — dane atrybucji reklam Click-to-WhatsApp nie są udostępniane agentowi (zobacz [FAQ](/docs/pl/eleven-agents/whatsapp/troubleshooting#faq)).
* **Przekazanie do człowieka** — wkrótce (zobacz [FAQ](/docs/pl/eleven-agents/whatsapp/troubleshooting#faq)).

## FAQ

Odpowiedzi na częste pytania — o ceny, konfiguracje z wieloma dostawcami, przekazanie do człowieka, tryb Zero-Retention, OTP i zgodność — znajdziesz w [Rozwiązywaniu problemów i FAQ](/docs/pl/eleven-agents/whatsapp/troubleshooting).