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. 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.
4. Format odbiorcy — whatsapp_user_id zawiera tylko cyfry z kodem kraju, bez +. Zobacz format numeru odbiorcy.
5. Limity marketingowe — Meta ogranicza liczbę szablonów marketingowych, 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.
• 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 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, 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ę, który zwraca każdą zmienną wymaganą przez agenta; zobacz kontekst inicjalizacji. 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.

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.
• Autoryzacja konta nie jest już ważna — token dostępu wygasł lub został cofnięty po stronie Meta. Zaimportuj konto ponownie na stronie WhatsApp.
• Obszar roboczy agenta działa w trybie Zero-Retention, 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.

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:

Pełną listę znajdziesz w opisie kodów błędów Meta.

FAQ