WhatsApp Link API: wa.me oraz api.whatsapp.com – wyjaśnienie

Linki typu Kliknij, aby czatować na WhatsApp

API linku WhatsApp: Jak to zrobić wa.me oraz api.whatsapp.com Linki naprawdę działają

Link do WhatsAppa to adres URL, a nie API. Ten przewodnik daje Ci dokładnie wa.me oraz api.whatsapp.com/send formaty, te text parametr, darmowy generator oraz punkt, w którym łącze się kończy, a musi rozpocząć rzeczywista integracja.
7-dniowy bezpłatny okres próbny, karta kredytowa nie jest wymagana
Tylko adres URL
Brak uwierzytelniania, brak kodu
wa.me/1XXXXXXXXXX?text=Cześć...
Cześć! Mam pytanie dotyczące Twojego produktu. Wypełnione wstępnie, nadal edytowalne
Otwiera czat. Człowiek nadal musi nacisnąć wyślij.
Definicja

Czym jest API linków WhatsApp?

Nie ma żadnego API dla linków WhatsApp. https://wa.me/<number> oraz https://api.whatsapp.com/send?phone=<number> to linki typu „kliknij, aby porozmawiać”: kliknięcie jednego z nich otwiera konwersację w WhatsApp. Wymagają one bez uwierzytelniania, bez konta deweloperskiego i bez kodu. Interfejsy API WhatsApp to osobna warstwa, która zaczyna się dokładnie tam, gdzie kończy się link.
Kryterium
API WhatsApp
Formatuj
APIUwierzytelniony punkt końcowy HTTP
Konfiguracja
APIPowiązanie kont, klucz API, biblioteka kliencka
Co się dzieje po kliknięciu / w połączeniu
APIWysyła, odbiera i wyświetla listę wiadomości programowo
Kto gra
APIOprogramowanie działa w imieniu powiązanego konta
Formatuj

Jaki jest dokładny format linku wa.me?

Zudokumentowany format to https://wa.me/<number>, gdzie <number> to pełny numer telefonu w formacie międzynarodowym. Centrum pomocy WhatsApp stwierdza, że należy pominąć wszelkie zera, nawiasy i myślniki.
wa.me-format.txt
Użycie: https://wa.me/1XXXXXXXXXX Nie używaj: https://wa.me/+001-(XXX)XXXXXXX
Co zachować
Kod kraju plus numer abonenta, tylko cyfry. Bez wiodących +.
Co zdjąć
Wiodące zera, spacje, myślniki, nawiasy. Żadne z nich nie należą do ścieżki.
Centrum pomocy WhatsApp, "Jak korzystać z funkcji Kliknij, aby czatować"
Porównanie

Jaka jest różnica między wa.me a api.whatsapp.com/send?

Oba opcje otwierają tę samą rozmowę. wa.me/ czy skrócona forma jest udokumentowana w Centrum Pomocy WhatsApp, z numerem w ścieżce. api.whatsapp.com/send?phone= nadal w powszechnym użyciu jest forma rozszerzona, która przenosi numer jako parametr zapytania.
Anatomia adresu URL, segment po segmencie
https://wa.me/1XXXXXXXXXXCześć
https://api.whatsapp.com/wyślij?phone=1XXXXXXXXXXCześć
Gospodarz
Ścieżka stała
Liczba
Wiadomość
Kryterium
wa.me
api.whatsapp.com/send
Gdzie mieszka ta liczba
wa.meW ścieżce URL
api.whatsapp.comW telefon parametr zapytania
Udokumentowane w Centrum pomocy WhatsApp
wa.meTak, dokładnie w tym formacie
api.whatsapp.comNie znaleźliśmy tego na bieżącej stronie pomocy
Zaobserwowane zachowanie
wa.meOtwiera czat
api.whatsapp.comOtwiera ten sam czat
Luka w dokumentacji, a nie wycofanie z użytku. Nie udało nam się znaleźć aktualnej, oficjalnej strony WhatsApp ani Meta, na której znalazłyby się informacje na temat api.whatsapp.com/send. To nie oznacza, że przestało to działać: oba formaty przekierowują dziś do tej samej konwersacji. Oznacza to, że oficjalne Centrum pomocy WhatsApp obejmuje tylko wa.me. Zbuduj nowe linki w udokumentowanym formacie.
Parametr tekstowy

Jak dodać gotową wiadomość do linku w WhatsApp?

Dołącz ?text= a po nim wiadomość zakodowana w formacie URL: https://wa.me/<number>?text=<urlencodedtext>. Tekst trafia w pole wprowadzania czatu, jest wstępnie wpisany i można go edytować.
wstępnie wypełnione warianty
https://wa.me/1XXXXXXXXXX?text=JestemzainteresowanyTwoimsamochodemnasprzedaż// brak numeru: zamiast tego otwiera selektor kontaktówhttps://wa.me/?text=I'minquiringabouttheapartmentlisting
Bez numeru WhatsApp otwiera listę kontaktów nadawcy zamiast konkretnego czatu. text nadal wypełnia pola automatycznie po wybraniu kontaktu.
Kodowanie, pewne odwzorowania
Postać
Przestrzeń
Nowa linia
&
#
Zakodowane jako
%20
%0A
%26
%23
Warto również wiedzieć: + koduje do %2B. W przypadku wszystkiego innego, w tym emoji, nie Twórz tabeli samodzielnie: wywołaj encodeURIComponent() w JavaScript lub urllib.parse.quote() w Python.
Zbuduj link w kodzie
build-link.js
// JavaScriptconst number = "1XXXXXXXXXX"; const text = "Hi! I have a question."; const link = `https://wa.me/${number}?text=${encodeURIComponent(text)}`;
build_link.py
# Pythonfrom urllib.parse import quote number, text = "1XXXXXXXXXX", "Cześć! Mam pytanie." link = f"https://wa.me/{number}?text={quote(text)}"
Bezpłatne narzędzie

Wygeneruj swój link do WhatsApp

Wpisz numer i wiadomość. Odbierz wa.me link api.whatsapp.com odpowiednik, zakodowany tekst, fragment kodu HTML oraz oficjalny przycisk, wszystko naraz.
Działa w całości w Twojej przeglądarce. Żaden numer nie jest wysyłany na serwer.
Pełny numer międzynarodowy. Bez +, bez 0, bez spacji i myślników.
Opcjonalnie. Trafia do pola wprowadzania czatu, nadaje się jeszcze do edycji przez nadawcę.
link wa.me
https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product.
odpowiednik api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Hi!%20I%20have%20a%20question%20about%20your%20product.
parametr tekstowy, zakodowany
Cześć! Mam pytanie dotyczące waszego produktu.
Gotowy do wklejenia fragment kodu HTML
<a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener" aria-label="Czatuj na WhatsAppie">Czatuj na WhatsAppie</a>
Oficjalny przycisk "Czatuj na WhatsApp"
Czatuj na WhatsAppie
<a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Czatuj na WhatsAppie</a>
Ten link otwiera czat. Nie powoduje wysłania wiadomości, a Twój produkt nie zobaczy odpowiedzi.

Czy link do WhatsAppa wysyła wiadomość?

Nie. Link typu „kliknij, aby porozmawiać” otwiera konwersję i wstępnie wypełnia pole tekstu. Nic nie zostanie wysłane, dopóki osoba trzymająca telefon nie naciśnie przycisku wysyłania.
Szczera część

Czego nie może zrobić link do WhatsApp?

Link typu „kliknij, aby czatować” nie rejestruje stanu. Twój produkt nigdy się nie dowiaduje, czy w link kliknięto, czy wiadomość została wysłana, ani czy odbiorca odpowiedział.
Gdzie kończy się link
Kliknięto w link
Czat się otwiera
Wiadomość wstępnie wypełniona
Ręczne wysyłanie
LinkZatrzymuje siętutaj
Otrzymano odpowiedź
Historia konwersacji
Zdarzenie webhook
Atrybucja dla poszczególnych użytkowników
Brak potwierdzenia dostarczenia lub odczytu
Żadna odpowiedź nie została przekierowana z powrotem do Twojej aplikacji
Brak historii konwersacji
Brak załączników
Brak wyzwalacza po stronie serwera. To wymaga człowieka i kliknięcia
Brak atrybucji na użytkownika w produkcie wielodostępnym
Ciche niepowodzenie, jeśli numer nie ma aktywnego konta WhatsApp
Różne zachowanie na komputerze, WhatsApp Web i telefonie
Brak tworzenia i zarządzania grupami. Link otwiera wyłącznie czat jeden na jeden, zobacz API grupy WhatsApp limity dla wszystkiego, co związane z grupami
Link nie może rejestrować kliknięć, odpowiedzi ani historii. API może. Zbuduj prawdziwą integrację z WhatsApp
Wklej link

Jak przesłać odpowiedź z powrotem do swojej aplikacji?

Potrzebujesz interfejsu API, który utrzymuje sesję WhatsApp. Istnieją dwie ścieżki: Cloud API od Meta, co wymaga zweryfikowanego konta firmowego, lub API powiązanego konta takich jak Unipile, gdzie użytkownik końcowy powiązuje swoje własne konto WhatsApp w imieniu uwierzytelnionego użytkownika, za pomocą kodu QR lub kodu parowania.
Meta Cloud APIZweryfikowana firma
Wymaga zweryfikowanego konta WhatsApp Business
Rozliczenie za wiadomość od 1 lipca 2025 r., zobacz Cennik interfejsu API WhatsApp Business awaria
24-godzinne okno obsługi klienta nadal istnieje, to ono decyduje, co jest darmowe, a nie co jest fakturowane
Stworzony do masowego wysyłania powiadomień na podstawie szablonów
Połączone konto, UnipileBrak weryfikacji
Każdy użytkownik końcowy łączy swoje własne konto WhatsApp w imieniu uwierzytelnionego użytkownika
Za pomocą kodu QR lub kodu parowania, bez weryfikacji Meta Business
Odczytuje i wysyła z faktycznie powiązanej skrzynki odbiorczej, w tym odpowiedzi
Ten sam wzorzec connect, send, list, listen co w LinkedIn, Instagramie, Telegramie, Gmailu, Outlooku i IMAP
connected-account-flow.js
// 1. Powiąż konto w imieniu uwierzytelnionego użytkownika const { qrCodeString } = czekać konta klienta.Połącz WhatsApp();// 2. Wyślij wiadomość po powiązaniu POST /api/v1/chats/{chat_id}/messages{ "tekst": "Cześć! Twoje zamówienie zostało wysłane." }// 3. Odbieraj odpowiedzi przez webhook, bez odpytywania{ "zdarzenie": "odebrano_wiadomość", "chat_id": "chat_182...", "wiadomość": "Czy to jest jeszcze aktualne?"Zamykamy nawias.
Pełny przewodnik wysyłania, ładunki (payloady) i obsługę webhooków można znaleźć w jak wysyłać wiadomości WhatsApp przez API. Odniesienie do punktu końcowego: developer.unipile.com/docs/whatsapp.
Decyzja

Link, Cloud API czy konto powiązane: którego potrzebujesz?

Użyj łącza, gdy użytkownik inicjuje rozmowę ze strony, którą kontrolujesz. Użyj interfejsu Cloud API, gdy zweryfikowana firma wysyła powiadomienia oparte na szablonach na dużą skalę. Użyj interfejsu API powiązanego konta, gdy Twój produkt musi odczytywać wiadomości ze skrzynki odbiorczej WhatsApp użytkownika i wysyłać je z niej.
Kryterium
Link
Meta Cloud API
Powiązane konto
Kto inicjuje
Linkczłowiek z kontrolowanej przez Ciebie strony
Cloud APITwoja firma wysyła pierwsze, szablonowe
Powiązane kontoZ dowolnej strony ze wskazanej skrzynki odbiorczej
Wymagane uwierzytelnienie
LinkŻaden
Cloud APIZweryfikowane konto biznesowe Meta
Powiązane kontoKod QR lub kod parowania, bez weryfikacji firmy
Koszt
LinkDarmowy
Cloud APIZa wiadomość, od 1 lipca 2025 r.
Powiązane kontoCennik planów Unipile, rozliczenie nie za każdą wiadomość
Otrzymuje odpowiedzi
LinkNie
Cloud APITak, przez webhook
Powiązane kontoTak, przez webhook
Historia konwersacji
LinkNie
Cloud APITak
Powiązane kontoTak
Produkty wielodostępne
LinkPrzerwy, jedna zakodowana na sztywno liczba
Cloud APIWymaga niestandardowego routingu dla każdego numeru firmowego
Powiązane kontoNatywne, jedno powiązane konto na użytkownika końcowego
Czas konfiguracji
LinkProtokół
Cloud APIOd dni do tygodni, Weryfikacja działalności gospodarczej
Powiązane kontoMinuty na godziny
Potrzebuję tylko linku
Użyj generator powyżej. Bez rejestracji, bez konfiguracji.
Wysyłanie powiadomień opartych na szablonach
Odczytywanie i wysyłanie na żądanie użytkownika
Większość produktów wyrasta z tego połączenia w ciągu tygodnia. Zacznij tam, gdzie faktycznie w końcu wylądujesz. Rozpocznij budowanie
Implementacja

Jak umieścić link do WhatsAppa w produkcie?

Wygeneruj łącze po stronie serwera, dla każdego użytkownika z osobna, i nigdy nie umieszczaj numeru telefonu na stałe w kodzie produktu wielodostępnego. Łącze to zwykły element kotwicy, więc jego miejsce jest w warstwie szablonów, a nie w warstwie API.
przycisk-czatu.html
<a href="https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}" cel="_blank" rel="noopener" aria-label="Napisz na WhatsAppie"Czatuj na WhatsAppiea>
Oficjalny przycisk
WhatsApp publikuje gotową odznakę "Czatuj na WhatsAppie", w kolorze zielonym i białym, w kilku ustalonych rozmiarach, przeznaczoną do użytku bez modyfikacji.
Czatuj na WhatsAppie
Kod QR
Każdy generator kodów QR obsługujący adresy URL zamienia wa.me łącze w kod skanowalny do druku, opakowań lub oznaczeń w miejscu sprzedaży.
Mobilny Otwiera aplikację WhatsApp bezpośrednio, z gotowym czatem i wstępnie wypełnionym tekstem.
Komputer stacjonarny, aplikacja zainstalowana Otwiera aplikację desktopową WhatsApp zamiast przeglądarki.
Komputer stacjonarny, brak aplikacji Otwiera WhatsApp Web w przeglądarce i wyświetla monit o logowanie za pomocą kodu QR, jeśli sesja nie jest jeszcze aktywna.
Dlaczego linki psują się w produktach wielodostępnych: pojedynczy, zakodowany na sztywno numer nie pozwala odróżnić Twoich klientów. Generuj link dla konkretnego rekordu użytkownika lub obszaru roboczego za każdym razem, aby zawierał on numer, którego ten użytkownik faktycznie jest właścicielem, a nie numer wklejony raz do szablonu.
Rozwiązywanie problemów

Dlaczego mój link do WhatsAppa nie działa?

Dwie najczęstsze przyczyny to numer telefonu w formacie innym niż międzynarodowy oraz text niezakodowany w adresie URL parametr.
PrzyczynaNumer telefonu nie jest w standardowym formacie międzynarodowym
NaprawićUżyj pełnego numeru międzynarodowego, samych cyfr: nie +, bez wiodących 0, bez spacji, myślników ani nawiasów.
PrzyczynaParametr tekstowy nie został zakodowany w formacie URL
NaprawićPrzekaż wiadomość dalej encodeURIComponent() w JavaScript lub urllib.parse.quote() w Pythonie przed jego dodaniem.
PrzyczynaTen numer nie ma aktywnego konta WhatsApp
NaprawićLink nadal się otwiera, ale czat cicho zawodzi. Najpierw zweryfikuj, czy numer jest faktycznie zarejestrowany w WhatsAppie.
PrzyczynaOtwarto w przeglądarce wewnątrz aplikacji innej firmy
NaprawićPrzeglądarki w aplikacjach społecznościowych lub reklamowych czasami blokują przekierowanie lub obsługują je nieprawidłowo. Zamiast tego otwórz link w przeglądarce systemowej.
PrzyczynaRobot indeksujący podgląd linków zmodyfikował adres URL
NaprawićNiektóre platformy zawijają wychodzące linki we własne przekierowanie, co może powodować usunięcie ciągu zapytania (query string). Przetestuj wersję surową wa.me Bezpośredni adres URL.

API linku WhatsApp – Często zadawane pytania

Wszystko, o co deweloperzy pytają w związku z wa.me, api.whatsapp.com, parametrem text i miejscem, w którym link przestaje działać.

Nie istnieje jedno uniwersalne API do linków WhatsApp. wa.me oraz api.whatsapp.com/send adresy URL typu kliknij, aby czatować: otwarcie jednego z nich rozpoczyna konwersję w aplikacji WhatsApp, bez konieczności uwierzytelniania, konta deweloperskiego czy pisania kodu. Własne interfejsy API WhatsApp to osobna warstwa, która zaczyna się dokładnie tam, gdzie kończy się link, w momencie gdy użytkownik musi odpowiedzieć.

Zudokumentowany format to https://wa.me/<number>, gdzie <number> to pełny numer telefonu w formacie międzynarodowym. Centrum pomocy WhatsApp zaleca pominięcie wszelkich wiodących zer, nawiasów, spacji lub myślników, na przykład https://wa.me/1XXXXXXXXXX.

Oba opcje otwierają tę samą rozmowę. wa.me/ czy krótka forma jest udokumentowana w Centrum Pomocy WhatsApp, z numerem w ścieżce URL. api.whatsapp.com/send?phone= czy długa forma, w której numer jest przekazywany jako parametr zapytania, jest nadal powszechnie używana.

Nie. Link typu „kliknij, aby porozmawiać” otwiera konwersację i może wstępnie wypełnić pole tekstowe, ale nic nie zostanie wysłane, dopóki osoba trzymająca telefon nie naciska przycisku wysyłania.

Tak. Dołącz ?text= a następnie zakodowaną w formacie URL wiadomością, na przykład https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. Tekst trafia do pola wprowadzania czatu, jest wstępnie wpisany i nadal można go edytować przed wysłaniem. Wypróbuj go w generator powyżej.

Dwie najczęstsze przyczyny to numer telefonu, który nie jest w standardowym formacie międzynarodowym, oraz text parametr, który nie został zakodowany w formacie URL. Sprawdź również, czy numer ma aktywne konto WhatsApp i czy link nie został otwarty w przeglądarce wewnątrz aplikacji innej firmy.

Nie. A wa.me lub api.whatsapp.com/send link nie wymaga konta firmowego, weryfikacji ani dostępu do API. Platforma WhatsApp Business lub Cloud API to osobny, zweryfikowany produkt dla firm, które muszą wysyłać powiadomienia szablonowe na skalę masową lub odbierać odpowiedzi programowo. Zobacz kompletny przewodnik po API WhatsApp.

Sam link nie może zgłaszać odpowiedzi z powrotem do Twojej aplikacji, jest bezstanowy. Aby czytać i wysyłać wiadomości z rzeczywistej skrzynki odbiorczej, potrzebujesz interfejsu API, który utrzymuje sesję WhatsApp: albo Cloud API od Meta ze zweryfikowanym kontem firmowym, albo API połączonego konta, takiego jak Unipile, gdzie każdy użytkownik końcowy łączy własne konto WhatsApp w imieniu uwierzytelnionego użytkownika za pomocą kodu QR lub kodu parowania. Zobacz jak wysyłać wiadomości WhatsApp przez API.

Nadal nie masz pewności, czy potrzebujesz linku, czy API? Nasz zespół może pomóc Ci podjąć decyzję.

Porozmawiaj z ekspertem
pl_PLPL