Migracja API WhatsApp

Ten przewodnik wyjaśnia, jak połączyć z Quoting24 numer, który jest już aktywny na oficjalnych API WhatsApp (WhatsApp Business Platform) u innego dostawcy, bez zmiany numeru.

Sekcja WhatsApp jest widoczna tylko dla administratorów.

Połączenie zawsze zaczyna się w tym samym miejscu w Quoting24: Ustawienia → WhatsApp → WhatsApp Business → Połącz. Przycisk Połącz otwiera wbudowaną rejestrację Meta (Embedded Signup). Od tego momentu Quoting24 jest dostawcą, który odbiera i wysyła wiadomości tego numeru. Przewidzianym trybem jest połączenie przez oficjalne API, opisane w Przegląd WhatsApp.

Którą procedurę wybrać

Meta ma dwa sposoby podłączenia numeru, z którego korzysta już inny dostawca. Zanim klikniesz Połącz, sprawdź portfolio w Meta Business Suite → Ustawienia → Konta.

Co widzisz w Meta Business Suite	Co zrobić
Osobno Konta WhatsApp i Konta do wiadomości (Messaging Accounts)	Model bieżący: udostępnij konto WhatsApp dla Quoting24. Numer zostaje tam, gdzie jest.
Tylko Konta WhatsApp	Model poprzedni: migruj numer kodem SMS lub głosowym.

W modelu bieżącym Meta odrzuca przeniesienie numeru z jednego konta na inne. Odłączenie go od poprzedniego dostawcy nie zwalnia numeru.

Co przygotować

Dostęp administratora do Quoting24.
Dostęp administratora do portfolio Meta (Business Manager), do którego należy numer, z użytkownikiem Facebooka, którego użyjesz w oknie Połącz.
Numer już zarejestrowany na oficjalnych API. Bezpłatnych numerów testowych przydzielonych przez Meta nie da się migrować.
Możliwość odebrania SMS-a lub połączenia głosowego na tym numerze, jeśli Meta poprosi o kod.

Migracja według poprzedniego modelu wymaga też:

nazwy wyświetlanej już zatwierdzonej, bez otwartego wniosku o zmianę nazwy;
weryfikacji dwuetapowej (PIN) wyłączonej na numerze, bez usuwania numeru i bez zamykania konta. Jeśli nie masz dostępu do konta WhatsApp, o wyłączenie poproś obecnego dostawcę.

Model bieżący: udostępnij numer Quoting24

Użyj tej procedury, jeśli w Meta Business Suite widać zarówno Konta WhatsApp, jak i Konta do wiadomości.

Zostaw numer aktywny u obecnego dostawcy do końca. Wcześniejsze odłączenie, gdy przychodzą wiadomości klientów, przerywa odbiór.

W Quoting24 otwórz Ustawienia → WhatsApp.
W wierszu WhatsApp Business kliknij Połącz i zaloguj się jako administrator portfolio Meta.
Wybierz numer już zarejestrowany u innego dostawcy. Meta pokazuje go na liście i nie prosi o nowy kod: numer jest już zarejestrowany.
Meta proponuje portfolio i konto WhatsApp tego numeru. Potwierdź udostępnienie dla Quoting24.
Wpisz nazwę wyświetlaną numeru i kontynuuj. Meta może sprawdzić ją ponownie po aktywacji.
Sprawdź żądane uprawnienia (konto WhatsApp, konto do wiadomości i powiązane zasoby) i potwierdź.
Zamknij okno Meta. W Quoting24 wiersz WhatsApp Business ma stan połączono.

Meta tworzy dla Quoting24 nowe konto do wiadomości w ramach tego samego konta WhatsApp. Poprzedni dostawca pozostaje podłączony, dopóki go nie usuniesz.

Jak skierować wiadomości do Quoting24

Samo udostępnienie nie przenosi wiadomości przychodzących. Dopóki poprzedni dostawca jest partnerem, Meta może nadal dostarczać je do niego.

Gdy wiersz WhatsApp Business w Quoting24 jest połączony:

W Meta Business Suite otwórz Ustawienia → Konta → Konta do wiadomości, wybierz konto, przejdź do Partnerzy i usuń dostęp aplikacji poprzedniego dostawcy.
Otwórz Ustawienia → Konta → Konta WhatsApp, wybierz konto numeru, przejdź do Partnerzy i usuń tam również dostęp tego samego dostawcy.
W tym samym koncie WhatsApp otwórz Routing konwersacji (Conversation routing) i przypisz Quoting24 każdy typ konwersacji.

Na liście partnerów może widnieć nazwa aplikacji Meta powiązanej z Quoting24, a nie napis „Quoting24”. Jeśli nie wiadomo, który dostęp usunąć, zatrzymaj się i zapytaj wsparcie Quoting24, zanim usuniesz partnera.

Gdy zostaje jeden partner, Meta wyłącza routing i dostarcza wiadomości do tego partnera.

Co zostaje w tym modelu

Zostają przy numerze, bo konto WhatsApp się nie zmienia:

numer telefonu
nazwa wyświetlana
ocena jakości
limity wiadomości
status Official Business Account, jeśli był już aktywny

Szablony należą do konta do wiadomości, nie do numeru. Konto utworzone dla Quoting24 startuje puste: szablony poprzedniego dostawcy trzeba odtworzyć w Quoting24 i ponownie zatwierdzić w Meta.

Dopóki nie są zatwierdzone:

z Quoting24 możesz swobodnie odpowiadać tylko w ciągu 24 godzin od ostatniej wiadomości klienta;
w Broadcast API nie ma szablonów do wyboru.

Czaty zapisane w poprzednim oprogramowaniu nie trafiają do ticketów Quoting24. Wiadomości, które przychodzą po połączeniu, stają się ticketami. Czaty już obecne w telefonie klienta zostają w aplikacji WhatsApp klienta.

Model poprzedni: migruj numer

Użyj tej procedury tylko wtedy, gdy w Meta Business Suite widać wyłącznie Konta WhatsApp.

Wyłącz weryfikację dwuetapową

Poproś obecnego dostawcę o wyłączenie kodu PIN numeru albo zrób to sam z portfolio Meta, jeśli masz dostęp.

Numer i konto muszą pozostać aktywne. Usuwa się tylko weryfikację dwuetapową.

Połącz numer z Quoting24

W Quoting24 otwórz Ustawienia → WhatsApp.
W wierszu WhatsApp Business kliknij Połącz i zaloguj się jako administrator portfolio Meta.
Wybierz utworzenie nowego konta WhatsApp. To krok, którym Meta przenosi istniejący numer: to nie jest drugi numer.
Wpisz tę samą nazwę wyświetlaną, już zatwierdzoną dla tego numeru.
Wpisz ten sam numer. Meta informuje, że jest już zarejestrowany na koncie WhatsApp Business albo u innego dostawcy.
Poproś o kod przez SMS lub połączenie głosowe i wpisz go.
Dokończ pozostałe kroki w oknie Meta.

Przeniesienie zwykle kończy się w ciągu kilku minut. W Quoting24 wiersz WhatsApp Business przechodzi w stan połączono. W trakcie odbiór może przerwać się na kilka minut.

Co zostaje, a co trzeba zrobić od nowa

Przy numerze zostają:

nazwa wyświetlana
ocena jakości
status Official Business Account
limity wiadomości

W Quoting24 trzeba zrobić od nowa:

szablony, które należy wysłać ponownie i zatwierdzić w Meta, zanim napiszesz poza oknem 24 godzin i zanim użyjesz Broadcast API;
kampanie poprzedniego dostawcy;
historię czatu tego oprogramowania, która nie jest importowana. Nowe wiadomości przychodzą jako tickety.

Numer już w koegzystencji u innego dostawcy

Jeśli ten sam numer jest używany jednocześnie przez aplikację WhatsApp Business i przez API u innego dostawcy, połączenie API samo nie podłącza ponownie aplikacji na telefonie.

Zrób kopię zapasową czatów w aplikacji WhatsApp Business.
Zarejestruj ten sam numer w aplikacji WhatsApp osobisty: numer znika z aplikacji Business.
Zarejestruj go ponownie w aplikacji WhatsApp Business.
W Quoting24 kliknij Połącz przy WhatsApp Business i dokończ koegzystencję opisaną w WhatsApp Coexistence: w aplikacji Ustawienia → Połączone urządzenia → Połącz urządzenie, a następnie zeskanuj kod QR pokazany przez Quoting24.

Aby przenieść numer wyłącznie na API, bez aplikacji na telefonie, użyj procedury modelu Meta sprawdzonego wyżej.

Po połączeniu

Nowe wiadomości numeru stają się ticketami w Quoting24.
Poza 24 godzinami od ostatniej wiadomości klienta pisze się zatwierdzonym szablonem. Zasady oficjalnego kanału są w Przegląd WhatsApp.
Kampanie tworzy się w Broadcast API, gdy szablony są dostępne w Quoting24.
Aby korzystać też z aplikacji WhatsApp Business na tym samym numerze, potrzebna jest WhatsApp Coexistence.
Grupy i listy broadcast aplikacji nie przechodzą na API.

Gdy procedura się zatrzyma

Meta odrzuca przeniesienie numeru. Portfolio jest w modelu bieżącym: wróć do udostępniania i zostaw numer zarejestrowany u poprzedniego dostawcy, aż Quoting24 pokaże stan połączono.
Kod SMS lub głosowy nie dociera. W poprzednim modelu weryfikacja dwuetapowa jest nadal włączona. Wyłącz ją i kliknij Połącz ponownie.
Nazwa wyświetlana blokuje poprzednią migrację. Meta przyjmuje przejście tylko przy zatwierdzonej nazwie i bez oczekującej zmiany nazwy.
Quoting24 jest połączone, ale wiadomości nie dochodzą. W modelu bieżącym routing nadal wskazuje poprzedniego dostawcę. Sprawdź Partnerzy i Routing konwersacji, zanim odłączysz numer.
Jeśli partnera do usunięcia nie da się rozpoznać, skontaktuj się ze wsparciem Quoting24 i podaj numer oraz ID portfolio Meta.