Buduj teraz
PL
Click-to-chat w WhatsApp

API linków WhatsApp: wa.me i api.whatsapp.com w praktyce

Link WhatsApp to adres URL, a nie API. Oto dokładne formaty, parametr text, darmowy generator i miejsce, w którym link przestaje wystarczać.

Buduj teraz
Jak to działa

API linków WhatsApp: jak naprawdę działają linki wa.me i api.whatsapp.com

Oba otwierają czat, a dalej działa już człowiek.

  1. 1Ktoś otwiera adres URL
  2. 2WhatsApp otwiera czat
  3. 3Człowiek naciska „Wyślij”
Definicja

Czym jest API linków WhatsApp?

API linków WhatsApp nie istnieje. https://wa.me/<number> i https://api.whatsapp.com/send?phone=<number> to adresy URL typu click-to-chat. API zaczyna się tam, gdzie kończy się link.

Link WhatsApp
Konfiguracja
Brak
Po kliknięciu
Otwiera czat, wpisuje tekst
Kto działa
Człowiek naciska „Wyślij”
API WhatsApp
Konfiguracja
Połączenie konta i klucz API
Po wywołaniu
Wysyła, odbiera i listuje wiadomości
Kto działa
Oprogramowanie, w imieniu połączonego konta
Format

Jaki jest dokładny format linku wa.me?

Udokumentowany format to https://wa.me/<number>, z pełnym numerem telefonu w formacie międzynarodowym.

Budowa adresu URL
https://wa.me/1XXXXXXXXXX
Host. Zawsze taki sam.
Numer. Najpierw kod kraju, tylko cyfry.
Używajhttps://wa.me/1XXXXXXXXXX
Nie używajhttps://wa.me/+001-(XXX)XXXXXXX
Usuń przed utworzeniem linku+0 na początkuSpacjeMyślnikiNawiasy

Źródło: Centrum pomocy WhatsApp, „How to use click to chat”

Porównanie

Czym różni się wa.me od api.whatsapp.com/send?

Oba otwierają tę samą rozmowę. Zmienia się tylko miejsce numeru.

wa.meUdokumentowany
https://wa.me/1XXXXXXXXXX?text=Hi

Numer w ścieżce. Udokumentowany przez WhatsApp.

api.whatsapp.com/sendNadal powszechny
https://api.whatsapp.com/send?phone=1XXXXXXXXXX&text=Hi

Numer w parametrze phone. Nie znaleźliśmy go na aktualnej stronie pomocy.

To luka w dokumentacji, a nie wycofanie. Nowe linki najlepiej tworzyć na wa.me.

Parametr text

Jak dodać wstępnie wypełnioną wiadomość do linku WhatsApp?

Wystarczy dodać ?text= i wiadomość zakodowaną w URL: https://wa.me/<number>?text=<urlencodedtext>. Tekst nadal można edytować.

Znaki do zakodowania
Spacja%20
Nowa linia%0A
&%26
#%23
+%2B

Emoji i pozostałe znaki: encodeURIComponent().

Bez numeru? https://wa.me/?text=... otwiera wybór kontaktu.

build-link.js
const number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}` +
  `?text=${encodeURIComponent(text)}`;
https://wa.me/1XXXXXXXXXX?text=Hi!%20I%20have%20a%20question.
Darmowe narzędzie

Wygeneruj swój link WhatsApp

Wpisz numer i wiadomość, a potem skopiuj to, czego potrzebujesz.

Tylko cyfry, najpierw kod kraju.
Opcjonalnie, nadal do edycji.

Działa w przeglądarce. Żaden numer nie trafia na serwer.

link wa.me
https://wa.me/15550123456?text=Cze%C5%9B%C4%87!%20Mam%20pytanie%20dotycz%C4%85ce%20Pa%C5%84stwa%20produktu.
odpowiednik api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Cze%C5%9B%C4%87!%20Mam%20pytanie%20dotycz%C4%85ce%20Pa%C5%84stwa%20produktu.
parametr text, zakodowany
Cze%C5%9B%C4%87!%20Mam%20pytanie%20dotycz%C4%85ce%20Pa%C5%84stwa%20produktu.
fragment HTML
<a href="https://wa.me/15550123456?text=Cze%C5%9B%C4%87!%20Mam%20pytanie%20dotycz%C4%85ce%20Pa%C5%84stwa%20produktu." target="_blank" rel="noopener" aria-label="Chat on WhatsApp with 15550123456">Chat on WhatsApp</a>
przycisk „Chat on WhatsApp”
<a href="https://wa.me/15550123456?text=Cze%C5%9B%C4%87!%20Mam%20pytanie%20dotycz%C4%85ce%20Pa%C5%84stwa%20produktu." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chat on WhatsApp</a>

Link otwiera czat. Niczego nie wysyła, a produkt nigdy nie zobaczy odpowiedzi.

Zbuduj to, czego link nie potrafi
Krótka odpowiedź

Czy link WhatsApp wysyła wiadomość?

Nie. Nic nie zostanie dostarczone, dopóki osoba z telefonem w ręku nie naciśnie „Wyślij”.

Czat otwarty
Tekst wpisany
Dostarczenie dopiero po naciśnięciu „Wyślij”
Gdzie kończy się link

Czego nie potrafi link WhatsApp?

Link click-to-chat jest bezstanowy: aplikacja nigdy nie dowie się, co wydarzyło się dalej.

Co robi link
  • Kliknięcie linku
  • Otwarcie czatu
  • Wpisanie wiadomości
  • Ręczne wysłanie
Tu link się kończy
Co wymaga API
  • Odbiór odpowiedzi
  • Historia rozmowy
  • Zdarzenie webhook
  • Przypisanie do użytkownika
Brak statusu doręczenia i odczytu
Brak załączników
Brak wyzwalania po stronie serwera
Brak komunikatu o błędzie dla numeru bez WhatsApp
Różne działanie zależnie od urządzenia
Brak grup, zob. limity API grup WhatsApp
Zbuduj prawdziwą integrację z WhatsApp
Poza linkiem

Jak przekazać odpowiedź z powrotem do aplikacji?

Potrzebne jest API, które utrzymuje sesję WhatsApp. Są dwie drogi.

Meta Cloud APIZweryfikowana firma
  • Wymaga zweryfikowanego konta WhatsApp Business
  • Rozliczanie za wiadomość od 1 lipca 2025 r., zob. cennik WhatsApp Business API
  • Odpowiedzi w oknie 24-godzinnym: 1000 bezpłatnych na numer miesięcznie od 1 października 2026 r.
Połączone konto, UnipileBez weryfikacji Business
  • Każdy użytkownik końcowy łączy własne konto WhatsApp
  • Aplikacja działa w imieniu uwierzytelnionego użytkownika
  • Odczytuje i wysyła z prawdziwej skrzynki, łącznie z odpowiedziami
  • To samo API co dla LinkedIn, Telegram, Gmail i innych
Z Unipile
  1. 1Połącz konto kodem QR lub kodem parowania
  2. 2Wysyłaj z aplikacji
  3. 3Odbieraj odpowiedzi przez webhook: message_received

Zob. API WhatsApp od Unipile oraz jak wysyłać wiadomości WhatsApp przez API. Dokumentacja: developer.unipile.com/v1.0/docs/whatsapp.

Zbuduj to z Unipile
Decyzja

Link, Cloud API czy połączone konto: co wybrać?

Decyduje to, kto pisze pierwszy.

Link

Człowiek rozpoczyna czat z poziomu strony.

Dostęp
Brak
Koszt
Bezpłatnie
Odpowiedzi
Niewidoczne dla aplikacji
Użyj generatora powyżej
Meta Cloud API

Zweryfikowana firma wysyła szablony.

Dostęp
Zweryfikowane konto Meta Business
Koszt
Za wiadomość, od 1 lipca 2025 r.
Odpowiedzi
Tak, przez webhook
Przewodnik po integracji WhatsApp Cloud API
Połączone konto

Produkt działa we własnej skrzynce każdego użytkownika.

Dostęp
Kod QR lub kod parowania
Koszt
Plan Unipile, bez opłat za wiadomość
Odpowiedzi
Tak, przez webhook
Kompletny przewodnik po API WhatsApp
Zacznij budować
Wdrożenie

Jak osadzić link WhatsApp w produkcie?

Link należy generować w szablonach dla każdego użytkownika. W produkcie multi-tenant nie wolno wpisywać jednego numeru na sztywno.

Szablon linku
https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}
Numer. Z rekordu użytkownika.
Tekst. Kodowany w URL przy renderowaniu.
Oficjalny przycisk

Zielona plakietka WhatsApp „Chat on WhatsApp”, używana bez zmian.

Kod QR

Każdy generator QR zamieni link wa.me w kod do wydruku.

Gdzie się otwiera
Telefon
Aplikacja WhatsApp
Komputer z aplikacją
Aplikacja desktopowa
Komputer bez aplikacji
WhatsApp Web
Rozwiązywanie problemów

Dlaczego mój link WhatsApp nie działa?

Najczęściej winny jest format numeru lub niezakodowany tekst.

1 Numer nie jest w czystym formacie międzynarodowym
https://wa.me/+001-(XXX)XXXXXXX
https://wa.me/1XXXXXXXXXX

Rozwiązanie: tylko cyfry, najpierw kod kraju.

2 Parametr text nie został zakodowany w URL
?text=Hi there & welcome
?text=Hi%20there%20%26%20welcome

Rozwiązanie: encodeURIComponent() lub urllib.parse.quote().

3 Brak aktywnego konta WhatsApp

Czat się nie otwiera, bez komunikatu o błędzie.

4 Otwarcie w przeglądarce wbudowanej w aplikację

Użyj przeglądarki systemowej.

5 Podgląd linku zmienił adres URL

Parametry zapytania zniknęły. Przetestuj surowy URL.

Buduj na połączonych kontach

API linków WhatsApp - FAQ

Szybkie odpowiedzi dla deweloperów.

Nie. wa.me i api.whatsapp.com/send to adresy URL typu click-to-chat: otwierają czat WhatsApp bez uwierzytelniania i bez kodu. API WhatsApp zaczyna się tam, gdzie kończy się link.

https://wa.me/<number>, gdzie <number> to pełny numer w formacie międzynarodowym, bez zer na początku, nawiasów, spacji i myślników. Na przykład: https://wa.me/1XXXXXXXXXX.

Oba otwierają tę samą rozmowę. wa.me/<number> to krótka forma udokumentowana w Centrum pomocy WhatsApp, z numerem w ścieżce. api.whatsapp.com/send?phone=<number> to długa forma, z numerem jako parametrem zapytania.

Nie. Link otwiera rozmowę i może wstępnie wypełnić pole tekstowe. Nic nie zostanie dostarczone, dopóki osoba z telefonem w ręku nie naciśnie „Wyślij”.

Tak. Wystarczy dodać ?text= i wiadomość zakodowaną w URL, na przykład https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. Tekst można edytować przed wysłaniem. Wypróbuj generator powyżej.

Zwykle numer nie jest w czystym formacie międzynarodowym albo tekst nie został zakodowany w URL. Warto też sprawdzić, czy numer ma konto WhatsApp, i unikać przeglądarek wbudowanych w aplikacje.

Nie. Link wa.me lub api.whatsapp.com/send nie wymaga konta Business ani dostępu do API. Cloud API to osobny produkt wymagający weryfikacji. Zob. kompletny przewodnik po API WhatsApp.

Nie za pomocą linku, bo jest bezstanowy. Można użyć Cloud API od Meta ze zweryfikowanym kontem Business albo Unipile, gdzie każdy użytkownik końcowy łączy własne konto kodem QR lub kodem parowania, a aplikacja działa w imieniu uwierzytelnionego użytkownika. Zob. jak wysyłać wiadomości WhatsApp przez API.

Link czy API? Nasz zespół pomoże w wyborze.

Porozmawiaj z ekspertem