> 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. # Rozwiązywanie problemów i FAQ ## Wiadomość zaakceptowana, ale niedostarczona Odpowiedź `200` z endpointu wiadomości wychodzących oznacza, że ElevenLabs zaakceptowało i przekazało żądanie — za dostarczenie nadal odpowiada Meta. Jeśli wiadomość nigdy nie dociera, sprawdź kolejno: 1. **Zatwierdzenie szablonu** — szablon musi mieć status Approved w [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates). Szablony oczekujące lub odrzucone nie są dostarczane. 2. **Płatności** — brak metody płatności lub nieuregulowane płatności na koncie firmowym WhatsApp blokują dostarczanie szablonów (błąd Meta 131042). Dodaj lub zaktualizuj metodę płatności w WhatsApp Manager. 3. **Format parametrów** — wpisy `template_params` muszą być obiektami komponentów (`{"type": "body", "parameters": [...]}`), każdy placeholder w szablonie musi być wypełniony, a nazwane szablony wymagają `parameter_name` przy każdej wartości. Zobacz [parametry szablonu](/docs/pl/eleven-agents/whatsapp/outbound#template-parameters). 4. **Format odbiorcy** — `whatsapp_user_id` zawiera tylko cyfry z kodem kraju, bez `+`. Zobacz [format numeru odbiorcy](/docs/pl/eleven-agents/whatsapp/outbound#recipient-number-format). 5. **Limity marketingowe** — Meta ogranicza liczbę [szablonów marketingowych](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits), które jeden użytkownik może otrzymać w danym czasie (błąd 131049). Szablony użytkowe nie podlegają temu limitowi. ## Problemy z importem * **Nie można zaimportować numeru** — jest zarejestrowany u innego dostawcy WhatsApp lub aktywny w aplikacji WhatsApp Business. Numer można zarejestrować tylko u jednego dostawcy; zobacz [Ograniczenia](/docs/pl/eleven-agents/whatsapp#limitations). * **Twoje WABA nie pojawia się w procesie importu** — upewnij się, że jesteś zalogowany na konto Facebook z dostępem administratora do portfolio firmowego, które jest właścicielem WABA, a potem spróbuj importu ponownie. * **WABA utworzone w aplikacji deweloperskiej Meta** nie mogą być importowane standardową metodą. ### Sprawdź, czy numerem zarządza inny partner Numer, który wygląda na niekwalifikujący się, nie pojawia się w procesie importu lub powoduje błąd podczas importu, często nadal jest zarejestrowany u poprzedniego dostawcy. Partner mający kontrolę nad numerem wyjaśnia zarówno nieudany import, jak i brakujące WABA. 1. Przejdź do [business.facebook.com](https://business.facebook.com) i wybierz portfolio firmowe. 2. Otwórz **Business Settings** > **WhatsApp accounts**. 3. Sprawdź **Phone numbers** na każdym koncie WhatsApp, aż znajdziesz konto zawierające twój numer. 4. Otwórz **Partners**. 5. Odłącz numer od tego partnera (lub usuń całe portfolio firmowe), a potem spróbuj importu ponownie po kilku minutach. ## Agent nie odpowiada na wiadomości przychodzące Potwierdzenie odczytu i wskaźnik pisania pomagają zawęzić przyczynę: są wysyłane, gdy tylko wiadomość zostanie przyjęta do przetworzenia, zanim agent przygotuje odpowiedź. Przy włączonej opcji **Enable typing indicator** (domyślnie) wyślij wiadomość testową i sprawdź, czy została oznaczona jako przeczytana oraz czy pojawił się wskaźnik pisania. **Pojawia się wskaźnik pisania, ale nie przychodzi odpowiedź.** Wiadomość dotarła do ElevenLabs, a agent zaczął działać; błąd występuje podczas tworzenia lub dostarczania odpowiedzi: * Agent wymaga [zmiennej dynamicznej](/docs/pl/eleven-agents/customization/personalization/dynamic-variables), która nie ma wartości. Przychodzące rozmowy WhatsApp zaczynają się bez zmiennych dynamicznych podanych przez użytkownika — wypełnione są tylko zmienne systemowe. Rozwiązaniem jest [webhook inicjujący rozmowę](/docs/pl/eleven-agents/customization/personalization#conversation-initiation-webhooks), który zwraca każdą zmienną wymaganą przez agenta; zobacz [kontekst inicjalizacji](/docs/pl/eleven-agents/whatsapp#initialization-context). Wartości wpisane w sekcji **Dynamic Variables** w edytorze agenta są placeholderami testowymi i nie są używane w produkcji. * Meta odrzuciła odpowiedź agenta — na przykład z powodu limitu dla tej pary firma–użytkownik lub problemu z płatnością na poziomie konta. Zobacz poniżej [opis błędów](#meta-error-reference). Rozmowa nie powiedzie się, jeśli tych wymaganych zmiennych dynamicznych nie ma. **Nie pojawia się wskaźnik pisania.** Wiadomość została odrzucona, zanim dotarła do agenta: * Do numeru nie przypisano agenta lub przełącznik **Enable messaging** jest wyłączony — sprawdź ustawienia konta na [stronie WhatsApp](https://elevenlabs.io/app/agents/whatsapp). * Autoryzacja konta nie jest już ważna — token dostępu wygasł lub został cofnięty po stronie Meta. Zaimportuj konto ponownie na [stronie WhatsApp](https://elevenlabs.io/app/agents/whatsapp). * Obszar roboczy agenta działa w [trybie Zero-Retention](/docs/pl/eleven-api/resources/zero-retention-mode), który całkowicie ignoruje przychodzące wiadomości WhatsApp. * Wiadomość przychodząca ma nieobsługiwany typ (na przykład wideo lub odpowiedź WhatsApp Flow) — zobacz [Ograniczenia](/docs/pl/eleven-agents/whatsapp#limitations). > **Note** > > Jeśli opcja **Enable typing indicator** jest wyłączona dla konta, ta kontrola nie ma zastosowania — > przejrzyj obie listy. ## Pierwsza odpowiedź po szablonie działa nieprawidłowo Jeśli agent ma włączone zastąpienie **First message** na karcie **Security**, może ono kolidować z rozmowami z szablonami wychodzącymi — szablon był już pierwszą wiadomością. Jeśli odpowiedzi na szablony zachowują się nieoczekiwanie, usuń zastąpienie pierwszej wiadomości dla agentów używanych z wiadomościami wychodzącymi WhatsApp. ## Opis błędów Meta Błędy zwracane przez Meta podczas dostarczania są wyświetlane wraz z poradami, jak je rozwiązać, gdy to możliwe. Najczęstsze: | Kod | Znaczenie | Co zrobić | | ------ | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | 131042 | Problem z płatnością na koncie firmowym WhatsApp | Dodaj lub popraw metodę płatności w WhatsApp Manager | | 131056 | Limit dla tej pary firma–użytkownik | Zmniejsz tempo wysyłania wiadomości do tego użytkownika | | 131047 | Wymagane ponowne nawiązanie kontaktu | Okno obsługi klienta zostało zamknięte — ponownie nawiąż kontakt za pomocą szablonu | | 130497 | Firma ma ograniczenia w wysyłaniu wiadomości do użytkowników w kraju | Meta ograniczyła komunikację konta między krajami — rozwiąż problem z pomocą techniczną Meta | | 132000 | Liczba parametrów nie pasuje do szablonu | Wyślij dokładnie parametry określone w szablonie — zobacz [parametry szablonu](/docs/pl/eleven-agents/whatsapp/outbound#template-parameters) | | 132001 | Szablon nie istnieje | Sprawdź nazwę szablonu, kod języka i to, czy szablon jest zatwierdzony | | 131037 | Problem z nazwą wyświetlaną numeru telefonu | Dokończ zatwierdzanie nazwy wyświetlanej w WhatsApp Manager | | 190 | Token dostępu wygasł | Zaimportuj konto ponownie na [stronie WhatsApp](https://elevenlabs.io/app/agents/whatsapp) | Pełną listę znajdziesz w [opisie kodów błędów Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes). ## FAQ #### Jak rozliczane jest korzystanie z WhatsApp? Dwie strony naliczają opłaty niezależnie. **ElevenLabs** pobiera opłaty za użycie agenta — czas rozmowy, wiadomości, zamianę mowy na tekst i zamianę tekstu na mowę dla notatek głosowych oraz użycie LLM — poprzez kredyty w twoim planie, zgodnie ze standardowymi [rozliczeniami ElevenLabs](/docs/pl/overview/administration/billing). **Meta** nalicza osobno opłaty WhatsApp, takie jak wiadomości szablonowe, połączenia wychodzące i prośby o zgodę na połączenie, rozliczane metodą płatności w WhatsApp Manager. Stawki różnią się zależnie od kategorii wiadomości i kraju, a Meta zapowiedziała aktualizacje cen, które wejdą w życie 1 października 2026 r. — zobacz [cennik WhatsApp Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing), aby sprawdzić stawki obowiązujące na twoich rynkach. #### Czy mogę korzystać z ElevenLabs razem z innym dostawcą WhatsApp? Numer może obecnie być zarejestrowany tylko u jednego dostawcy wiadomości. Jeśli zewnętrzny dostawca (na przykład Gupshup) zarządza twoim kontem, nie można go jednocześnie zaimportować do ElevenLabs. Współpracujemy z Meta, aby umożliwić [Multi-Solution Conversations](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations), które pozwalają korzystać z wielu dostawców dla jednego numeru. **Głos przez SIP.** Jeśli chcesz zachować obsługę wiadomości u obecnego dostawcy, a używać agenta ElevenLabs do głosu, już teraz masz taką możliwość: WhatsApp Business Calling obsługuje SIP, więc dostawca udostępniający konfigurację SIP może kierować połączenia WhatsApp z twojego numeru do [trunku SIP](/docs/pl/eleven-agents/phone-numbers/sip-trunking) ElevenLabs. Twój dostawca nadal obsługuje wiadomości na tym numerze; połączenia odbiera twój agent przez SIP. To, czy zadziała, zależy od obsługi routingu połączeń SIP przez dostawcę — [napisz do nas](https://elevenlabs.io/contact-sales), a ocenimy twoją konfigurację. Jeśli prowadzisz własną aplikację WhatsApp na tym samym koncie (zamiast korzystać z zewnętrznego dostawcy), możesz już skonfigurować ElevenLabs tak, by obsługiwało tylko połączenia: wyłącz przełącznik ***Enable messaging*** w ustawieniach konta. #### Jak przekazać rozmowę człowiekowi? Wkrótce. Współpracujemy z Meta nad Coexistence with WhatsApp Business, co pozwoli twojemu zespołowi uczestniczyć w rozmowach na tym samym numerze, którego używa agent. #### Czy tryb Zero-Retention działa z WhatsApp? [Tryb Zero-Retention](/docs/pl/eleven-api/resources/zero-retention-mode) ogranicza nasze możliwości obsługi WhatsApp: wiadomości przychodzące są ignorowane, a połączenia wychodzące są niedozwolone. #### Czy mogę personalizować odpowiedzi na podstawie reklamy WhatsApp klikniętej przez użytkownika? Jeszcze nie. Agent otrzymuje i obsługuje rozmowy rozpoczęte z reklam Click-to-WhatsApp, ale metadane polecenia reklamy Meta (takie jak `ctwa_clid` oraz identyfikatory kampanii lub kreacji) nie są obecnie udostępniane agentowi, zmiennym dynamicznym ani webhookom, więc personalizacja i atrybucja na podstawie reklam nie są natywnie obsługiwane. Jest to śledzone jako prośba o funkcję — jeśli atrybucja reklam jest ważna w twoim przypadku, [napisz do nas](https://elevenlabs.io/contact-sales). #### Jak wysyłać kody weryfikacyjne (OTP)? Użyj szablonu Utility z kodem jako parametrem treści, wysłanego przez [endpoint wiadomości wychodzących](/docs/pl/eleven-agents/whatsapp/outbound). Kategoria szablonów Authentication Meta (z przyciskami kopiowania kodu) nie ma jeszcze specjalnej obsługi. #### Kto jest dostawcą technologii dla mojego konta WhatsApp? Gdy importujesz konto firmowe WhatsApp, ElevenLabs działa jako **Tech Provider** dla tego konta w ramach modelu partnerskiego Meta. ElevenLabs jest partnerem technologicznym Meta, a nie sprzedawcą: Meta nalicza ci bezpośrednio opłaty WhatsApp za pomocą metody płatności w WhatsApp Manager. #### Czy obsługiwana jest rezydencja danych w UE? Rezydencja danych w UE dla ElevenAgents, w tym danych rozmów WhatsApp, jest dostępna w planach Enterprise poprzez odizolowane środowisko UE. Obejmuje to dane obsługiwane przez infrastrukturę ElevenLabs; przesyłanie wiadomości przez WhatsApp podlega umowie zawartej z Meta.