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.

Po powrocie do Quickchat AI App panel WhatsApp zmieni status na Połączono w ciągu około 30 sekund. Jeśli tak się nie stanie, kliknij ikonę odświeżania w panelu. W przeciwnym razie wróć do sekcji Wymagania wstępne powyżej i upewnij się, że podałeś poprawny numer firmowy i dane firmy.

To wszystko, jesteś online! 🎉 Klienci mogą pisać na Twój numer WhatsApp, a AI Agent odpowie automatycznie.

Wskazówka

Na koniec wyślij wiadomość tekstową na nowo podłączony numer WhatsApp. Powinieneś otrzymać odpowiedź od AI Agenta, a rozmowa pojawi się w skrzynce odbiorczej Quickchat AI App. W tej skrzynce zobaczysz także wiadomość od WhatsApp z linkiem do Setup guidance w WhatsApp Manager. Kliknij link, aby dokończyć onboarding. Jeśli pominiesz którykolwiek z kroków konfiguracji Meta, Quickchat AI wyśle też właścicielowi konta e-mail z przypomnieniem o pozostałych krokach.

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.

• Kliknij Połącz ponownie w panelu WhatsApp i powtórz proces z właściwym kontem Meta Business i odpowiednim kontem WhatsApp.

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

• Oczekiwanie na zatwierdzenie nazwy wyświetlanej: Meta wymaga zatwierdzenia nazwy wyświetlanej Twojego numeru WhatsApp, zanim będzie mógł wysyłać odpowiedzi. Dokończ to w WhatsApp Manager, a następnie wyślij wiadomość testową.
• 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: