WhatsApp

Ten przewodnik pokazuje, jak zintegrować Quickchat AI Agent z WhatsAppem. Proces składa się z 2 prostych kroków:

• Krok 0 – Wymagania wstępne
• Krok 1 – Połącz WhatsApp

Jeśli napotkasz problemy, przejdź do sekcji Rozwiązywanie problemów i FAQ lub skontaktuj się z nami.

Obejrzyj wideo

Play

Krok 0 – Wymagania wstępne

A. Numer telefonu firmowego

Zdecyduj, którego numeru telefonu użyjesz w WhatsAppie. Więcej informacji znajdziesz w dokumentacji WhatsAppa lub w poniższych FAQ:

Jakiego numeru mogę użyć w WhatsApp Cloud API?

• Musisz posiadać dedykowany numer firmowy, który może odbierać SMS-y lub połączenia głosowe w celu weryfikacji.
• Numer musi być ważny, należeć do Ciebie i mieć numer kierunkowy kraju oraz miasta.

Czy mogę użyć numeru, który jest już w WhatsApp Messengerze?

• Nie. Możesz nadal odbierać połączenia i SMS-y, ale nie użyjesz go w WhatsApp Messengerze.
• Jeśli numer jest używany w Messengerze, najpierw go usuń. Pamiętaj, by zrobić kopię zapasową historii czatów.
• Zbanowane numery trzeba odblokować przed rejestracją.

Czy mogę użyć numeru z aplikacji WhatsApp Business?

• Tak. Jeśli numer działa w aplikacji WhatsApp Business, zwykle możesz go przenieść do Cloud API bez kasowania konta w aplikacji. Szczegóły znajdziesz w dokumentacji Meta o onboardingach Coexistence.

Czy mogę użyć nowego numeru?

• Tak. Jeśli nie chcesz korzystać z obecnego numeru, kup nowy numer (karta SIM lub numer wirtualny). Wirtualne numery oferuje m.in. Hushed.

B. Informacje o firmie

Przygotuj następujące dane (wprowadzisz je podczas integracji z Meta):

• Nazwa firmy
• Strona internetowa
• Kategoria działalności
• Opis firmy

Uwaga

Nawet jeśli jakieś pola wydają się opcjonalne, uzupełnij je rzetelnie. Braki lub błędy mogą opóźnić akceptację lub spowodować ograniczenia konta.

Krok 1 – Połącz WhatsApp

Otwórz Quickchat AI App → Aplikacje zewnętrzne → WhatsApp → kliknij przycisk Połącz WhatsApp i postępuj zgodnie z oknem Meta:

1. Zaloguj się na swoje konto Meta (Facebook).
2. Sprawdź uprawnienia, które udostępnisz Quickchat AI (dostęp do konta WhatsApp Business i do portfolio firmowego), i przejdź dalej.
3. Podaj poprawne dane firmy (Business Portfolio, Business Name, Business Website, kraj itd.).
4. Utwórz lub wybierz swoje konto WhatsApp Business.
5. Wybierz nazwę wyświetlaną i kategorię konta.
6. Dodaj numer firmowy i zweryfikuj go SMS-em lub połączeniem, zgodnie z instrukcjami.
7. Kliknij Confirm, aby nadać Quickchat AI wymagane uprawnienia.
8. Gdy Meta potwierdzi zakończenie konfiguracji, kliknij Finish. W oknie pojawi się potwierdzenie od Quickchat AI, że Twoje konto WhatsApp zostało połączone, a okno zamknie się automatycznie.

Jeśli Meta przyzna Quickchat AI dostęp do więcej niż jednego konta, panel WhatsApp zamiast natychmiast nawiązać połączenie wyświetli Wybierz swoje konto WhatsApp Business. Wybierz konto, na którym ma odpowiadać Twój AI Agent, i kliknij Użyj tego konta. Jeśli ponownie łączysz WhatsApp, bieżąca konfiguracja WhatsApp pozostanie bez zmian, dopóki nie potwierdzisz wyboru.

Po powrocie do Quickchat AI App panel WhatsApp pokazuje Dokończ konfigurację, dopóki nie potwierdzimy udanej wymiany wiadomości na Twoim własnym numerze firmowym. Jeśli panel nie zaktualizuje się po około 30 sekundach, kliknij ikonę odświeżania.

Połączenie z Meta i odebranie wiadomości to tylko część konfiguracji. Panel pokazuje następny krok dla każdego włączonego numeru:

• Czekamy na Twoją pierwszą wiadomość: wyślij wiadomość WhatsApp na pokazany numer z innego telefonu, a następnie kliknij Odśwież. Upewnij się, że piszesz na numer firmowy, z którego będą korzystać Twoi klienci.
• Oczekiwanie na dostarczenie odpowiedzi AI: Quickchat otrzymał Twoją wiadomość, ale WhatsApp nie potwierdził jeszcze dostarczenia odpowiedzi AI. Sprawdź, czy odpowiedź dotarła na drugi telefon. Jeśli nie, sprawdź kredyty AI i ostrzeżenia w panelu, a następnie wyślij kolejną wiadomość testową.
• Odpowiedź AI dostarczona: WhatsApp potwierdził dostarczenie odpowiedzi AI na wiadomość przychodzącą na ten numer firmowy.
• Weryfikacja wymaga uwagi: rozwiąż problemy wskazane w ostrzeżeniach dotyczących połączenia, pozostaw właściwy numer włączony i wyślij nową wiadomość testową.
• Nazwa wyświetlana: każdy numer wymieniony niżej w panelu ma status swojej nazwy wyświetlanej w Meta (Zatwierdzona, W trakcie sprawdzania, Odrzucona, Wygasła lub Brak nazwy wyświetlanej). Trwające sprawdzanie nie wymaga od Ciebie żadnych działań i zwykle kończy się w kilka dni. Jeśli nazwa została odrzucona, wygasła lub jej brakuje, prześlij nową w WhatsApp Manager.
• Numer testowy Meta: numery +1 555 przydzielone przez Meta i numery w środowisku sandbox nie potwierdzają aktywacji Twojego numeru firmowego. Dodaj własny numer w WhatsApp Manager, włącz go w Quickchat, a następnie przetestuj właśnie ten numer.

Panel pokazuje Działa, gdy każdy włączony numer firmowy ma potwierdzoną wymianę wiadomości, a kontrole połączenia nie wykazują problemów. Jeśli włączysz kilka numerów firmowych, przetestuj każdy z nich. Udana wymiana wiadomości na numerze testowym, wysłany szablon lub powiadomienie o wyczerpaniu limitu wiadomości nie kończą tej weryfikacji.

Wskazówka

Podczas testu pozostaw integrację włączoną. Wyślij z innego telefonu wiadomość na każdy właściwy numer firmowy, potwierdź otrzymanie odpowiedzi AI i kliknij Odśwież. Rozmowa powinna również pojawić się w skrzynce odbiorczej Quickchat AI App. Istniejące połączenie może wymagać nowej wymiany testowej, aby potwierdzić dostarczenie odpowiedzi. W tym czasie nadal może odbierać wiadomości i na nie odpowiadać.

Jeśli pozostały kroki onboardingu Meta, wykonaj je w Setup guidance w WhatsApp Manager. Quickchat AI wyśle też właścicielowi konta e-mail z przypomnieniem, jeśli kroki konfiguracji Meta pozostaną niedokończone.

Rozwiązywanie problemów i FAQs

Jak działa cennik WhatsApp Business API?

• Odpowiedzi na zapytania inicjowane przez użytkownika (przychodzące) są traktowane jako wiadomości serwisowe. Pozwalają obsługiwać klientów ręcznie lub za pomocą konwersacyjnej AI.
• Gdy użytkownik napisze do firmy, otwiera się 24-godzinne okno obsługi, w którym można odpowiadać wiadomościami serwisowymi bez opłat. To okno resetuje się po każdej wiadomości użytkownika.
• Po 24 godzinach należy używać zatwierdzonych szablonów (Message Templates) (Marketing, Utility, Authentication itd.) i płacić za wiadomości zgodnie z cennikiem platformy WhatsApp Business.
• Meta kategoryzuje i rozlicza konwersacje. Upewnij się, że konto WhatsApp Business ma ważną metodę płatności dla wiadomości inicjowanych przez firmę lub szablonów.

Przycisk Połącz WhatsApp nie działa, okno Meta się nie otwiera.

• Jeśli przeglądarka blokuje wyskakujące okno, zezwól na wyskakujące okna dla Quickchat AI App i kliknij Spróbuj ponownie. Możesz też kliknąć Kontynuuj w Meta w tej karcie, aby ukończyć tę samą konfigurację bez wyskakującego okna.

Quickchat nie mógł potwierdzić połączenia z WhatsApp

Quickchat wyświetla ten komunikat odzyskiwania, gdy okno Meta nie zwróci wyniku i nadal nie może zweryfikować połączenia. Nie oznacza to, że Meta nie wprowadziła żadnych zmian.

1. Upewnij się, że masz rolę administratora w firmie Meta, do której należy konto WhatsApp Business. Jeśli nie, poproś administratora o połączenie go ze swojego konta na Facebooku.
2. Kliknij Spróbuj ponownie. Jeśli bloker zakłóca działanie okna Meta, użyj okna prywatnego z wyłączonymi rozszerzeniami lub kliknij Kontynuuj w Meta w tej karcie.
3. Jeśli numer jest aktywny w WhatsApp Messengerze, najpierw go tam usuń lub użyj innego numeru. Jeśli jest aktywny w aplikacji WhatsApp Business, skorzystaj z onboardingu Coexistence firmy Meta.
4. Jeśli konto WhatsApp Business korzysta z Aircall, Twilio, 360dialog, MessageBird lub innego dostawcy, dodaj Quickchat AI jako partnera w ustawieniach firmowych Meta:
   1. Otwórz ustawienia firmowe Meta i przejdź do Konta → Konta WhatsApp.
   2. Wybierz konto WhatsApp Business, otwórz Partnerzy i kliknij Dodaj partnerów.
   3. Wprowadź Business ID Quickchat AI: 270696274483463.
   4. Przyznaj uprawnienie Zarządzaj kontami WhatsApp, wróć do Quickchat AI i odśwież status.

Odłącz innego dostawcę tylko wtedy, gdy Meta nie pozwala korzystać z obu partnerów na tym koncie. Jeśli nie masz pewności, przed odłączeniem aktywnego dostawcy wiadomości skontaktuj się z pomocą techniczną.

Weryfikacja numeru nie powiodła się.

• Upewnij się, że numer może odbierać SMS-y/połączenia i nie jest zajęty przez inny proces rejestracji, którego Meta nie dopuszcza równolegle. Jeśli numer działa w Business App, spróbuj onboardingu przez Coexistence.

Połączyłem niewłaściwe konto.

• Połącz ponownie zachowuje konto, które jest już połączone. Aby przenieść AI Agenta na inne konto WhatsApp Business, kliknij Rozłącz w panelu WhatsApp, a następnie ponownie Połącz WhatsApp i wybierz w oknie Meta właściwe konto Meta Business oraz odpowiednie konto WhatsApp.

Nie udało się ustalić, które konto WhatsApp Business połączyć

• Twoje logowanie Meta ma kilka kont WhatsApp Business z numerami telefonu i Quickchat nie mógł ustalić, które masz na myśli. Napisz na support@quickchat.ai, podając numer, który chcesz połączyć, a dokończymy konfigurację za Ciebie.

Wiadomości nie pojawiają się w skrzynce odbiorczej Quickchat AI.

• Sprawdź, czy w oknie zobaczyłeś końcowy komunikat “WhatsApp account connected!”.
• Upewnij się, że połączyłeś właściwe konto WhatsApp i wybrałeś poprawnego AI Agenta.
• Karta Czekamy na Twoją pierwszą wiadomość podaje numer, na którym odpowiada Twój AI Agent. Upewnij się, że napisałeś dokładnie na ten numer i że jest on włączony w panelu, a następnie kliknij Odśwież.
• Jeśli wysyłasz wiadomości po 24 godzinach bez odpowiedzi użytkownika, użyj zatwierdzonych szablonów i sprawdź, czy w WhatsApp Manager dodano metodę płatności.

Odpowiedzi WhatsApp mojego AI nie są wysyłane.

Jeśli odpowiedzi Twojego AI nie mogą zostać dostarczone, Quickchat AI wyświetli alert “Odpowiedzi WhatsApp nie są wysyłane” na panelu WhatsApp w Aplikacjach zewnętrznych oraz powiadomienie na Twoim dashboardzie. Najczęstsze przyczyny i rozwiązania:

• Niezatwierdzona nazwa wyświetlana numeru testowego Meta: Meta wstrzymuje odpowiedzi z numeru +1 555 przydzielonego przez Meta, dopóki jego nazwa wyświetlana nie zostanie zatwierdzona. Alert nazwy wyświetlanej w panelu robi się czerwony i wskazuje numer. Poczekaj na zakończenie sprawdzania (zwykle kilka dni) lub, jeśli nazwa została odrzucona, prześlij nową w WhatsApp Manager, a następnie wyślij wiadomość testową. Nazwa wyświetlana wciąż sprawdzana na Twoim własnym numerze sama w sobie nie blokuje odpowiedzi; panel pokazuje ją jako informację.
• Połączenie wygasło lub zostało cofnięte: Twoje połączenie WhatsApp nie jest już ważne. Otwórz panel WhatsApp i kliknij Połącz ponownie, aby wznowić wysyłanie odpowiedzi.
• Numer z ograniczeniami: Meta ograniczyła Twój numer WhatsApp (jakość lub zasady). Sprawdź jego status w WhatsApp Manager, aby przywrócić wysyłanie.

Alert zniknie automatycznie, gdy kolejna odpowiedź zostanie wysłana pomyślnie.

Szablony lub wiadomości inicjowane przez firmę nie działają.

• Upewnij się, że Twoje Message Templates są zatwierdzone i że w WhatsApp Manager jest aktywna metoda płatności.
• Nowi nadawcy zaczynają z limitami wysyłek, które rosną wraz z jakością i weryfikacją. Jeśli osiągniesz limit, sprawdź wskazówki Meta dotyczące Messaging Limits.
• Gdy dostarczalność jest ograniczana, monitoruj limity i rating jakości w WhatsApp Manager.

Jak stworzyć własny link do WhatsApp oraz przycisk “Chat on WhatsApp”?

• Skorzystaj z tego poradnika WhatsApp.
• Lub pobierz oficjalne przyciski WhatsApp i użyj jednego z tych przykładów przycisków:

<!-- Wbudowany przycisk WhatsApp -->
<!-- Zaktualizuj WHATSAPP_PHONE_NUMBER oraz nazwę/ścieżkę pliku -->
<a
  aria-label="Rozmawiaj na WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Rozmawiaj na WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

lub

<!-- Pływający przycisk WhatsApp -->
<!-- Zaktualizuj WHATSAPP_PHONE_NUMBER oraz nazwę/ścieżkę pliku -->
<a
  aria-label="Rozmawiaj na WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Rozmawiaj na WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

Jak wygenerować własny kod QR do WhatsAppa?

• Wejdź na WhatsApp Manager → Numery telefonów → wybierz numer firmowy → Linki do wiadomości → Utwórz link do wiadomości.
• Alternatywnie możesz to zrobić w aplikacji mobilnej WhatsApp Business. Zobacz ten poradnik WhatsApp.

Czy po połączeniu przez Coexistence można później się rozłączyć?

• Tak, w dowolnym momencie. W aplikacji WhatsApp Business przejdź do Ustawienia → Konto → Platforma biznesowa → Rozłącz.
• Numer pozostaje aktywny w aplikacji Business, a kontakty i dotychczasowa historia czatów pozostają bez zmian.
• Dostęp Quickchat AI przez API zostaje natychmiast zakończony.
• Możesz też wstrzymać integrację bez rozłączania, po prostu zatrzymując wiadomości wychodzące z Quickchat AI.

Jaki dostęp Quickchat AI otrzymuje do naszego konta WhatsApp Business?

• Ograniczony dostęp przez API, bez własności konta. Twoje konto WhatsApp Business (WABA) pozostaje w Twoim Meta Business Managerze. W modelu udostępniania WABA firmy Meta to Ty jesteś właścicielem zasobów, a Quickchat AI jest dodawany jako partner, którego możesz w każdej chwili usunąć w Business Managerze.
• Gdy integracja jest aktywna, możemy wysyłać i odbierać wiadomości przez Cloud API oraz odbierać zdarzenia wiadomości przez webhook.
• Nie możemy zamknąć, przenieść ani zmienić marki Twojego konta, zmienić rozliczeń ani usunąć administratorów.

Potrzebujesz pomocy?

Porozmawiaj z Quickchat Support AI na WhatsAppie:
📱 +1 302-405-9992 — Rozpocznij czat

Lub zeskanuj kod QR: