WhatsApp Link API: wa.me & api.whatsapp.com erklärt

WhatsApp Click-to-Chat-Links

WhatsApp Link API: Anleitung wa.me und api.whatsapp.com Links funktionieren tatsächlich

Ein WhatsApp-Link ist eine URL, keine API. Diese Anleitung gibt Ihnen das genaue wa.me und api.whatsapp.com/send Formate, die text Parameter, ein kostenloser Generator und der Punkt, an dem die Verknüpfung endet und eine tatsächliche Integration beginnen muss.
7 Tage kostenlos testen, keine Kreditkarte erforderlich
Nur eine URL
Keine Authentifizierung, kein Code
wa.me/1XXXXXXXXXX?text=Hallo...
Hallo! Ich habe eine Frage zu Ihrem Produkt. Vorausgefüllt, noch bearbeitbar
Öffnet den Chat. Ein Mensch muss trotzdem noch auf Senden drücken.
Definition

Was ist eine WhatsApp-Link-API?

Es gibt keine WhatsApp-Link-API. https://wa.me/<number> und https://api.whatsapp.com/send?phone=<number> Click-to-Chat-URLs sind Links, bei denen ein Klick darauf einen Chat in WhatsApp öffnet. Sie erfordern keine Authentifizierung, kein Entwicklerkonto und kein Code. Die WhatsApp-APIs sind eine separate Ebene, und sie beginnen genau dort, wo der Link aufhört.
Kriterium
Eine WhatsApp-API
Format
APIEin authentifizierter HTTP-Endpunkt
Einrichtung
APIKontoverknüpfung, ein API-Schlüssel, eine Client-Bibliothek
Was passiert beim Klick / Anruf
APISendet, empfängt und listet Nachrichten programmgesteuert auf
Wer handelt
APIIhre Software handelt im Namen des verknüpften Kontos
Format

Wie lautet das exakte wa.me-Link-Format?

Das dokumentierte Format ist https://wa.me/<number>, wo <number> ist eine vollständige Telefonnummer im internationalen Format. Das WhatsApp-Hilfezentrum besagt, dass Sie Nullen, Klammern oder Bindestriche weglassen müssen.
wa.me-format.txt
Benutzung: https://wa.me/1XXXXXXXXXX Nicht verwenden: https://wa.me/+001-(XXX)XXXXXXX
Was man behalten sollte
Ländercode plus Teilnehmerrufnummer, nur Ziffern. Keine führenden +.
Was zu entfernen ist
Führende Nullen, Leerzeichen, Bindestriche, Klammern. Nichts davon gehört in den Pfad.
WhatsApp-Hilfe, "So verwenden Sie "Direktchat““
Vergleich

Was ist der Unterschied zwischen wa.me und api.whatsapp.com/send?

Beide öffnen dasselbe Gespräch. wa.me/ Ist die Kurzform im Hilfe-Center von WhatsApp dokumentiert, mit der Nummer im Pfad. api.whatsapp.com/send?phone= ist die Langform, die die Nummer als Abfrageparameter übermittelt, immer noch weit verbreitet.
URL-Anatomie, Segment für Segment
https://wa.me/1XXXXXXXXXXHallo
https://api.whatsapp.comSenden?phone=1XXXXXXXXXXHallo
Gastgeber
Fester Pfad
Die Nummer
Die Nachricht
Kriterium
wa.me
api.whatsapp.com/send
Wo die Zahl lebt
wa.meIm URL-Pfad
api.whatsapp.comIm Telefon Abfrageparameter
Im Hilfebereich von WhatsApp dokumentiert
wa.meJa, genau dieses Format
api.whatsapp.comNicht auf der aktuellen Hilfeseite konnten wir finden
Beobachtetes Verhalten
wa.meÖffnet den Chat
api.whatsapp.comÖffnet denselben Chat
Eine Dokumentationslücke, keine Deprecatio. Wir konnten keine aktuelle, offizielle WhatsApp- oder Meta-Seite finden, die dokumentiert api.whatsapp.com/send. Das bedeutet nicht, dass es nicht mehr funktioniert: Beide Formate leiten heute auf dieselbe Unterhaltung weiter. Es bedeutet, dass das WhatsApp-eigene Hilfe-Center nur wa.me. Erstellen Sie neue Links im dokumentierten Format.
Der Textparameter

Wie fügt man eine vorab ausgefüllte Nachricht zu einem WhatsApp-Link hinzu?

Anhängen ?text= gefolgt von der URL-codierten Nachricht: https://wa.me/<number>?text=<urlencodedtext>. Der Text landet im Chat-Eingabefeld, vorausgefüllt und bearbeitbar.
vorbefüllte-varianten.txt
https://wa.me/1XXXXXXXXXX?text=Ich interessiere mich für Ihr zum Verkauf stehendes Auto// Keine Nummer: stattdessen wird eine Kontaktauswahl geöffnethttps://wa.me/?text=I'minquiringabouttheapartmentlisting
Ohne eine Nummer öffnet WhatsApp die Kontaktliste des Absenders anstelle eines bestimmten Chats. text füllt sich nach Auswahl eines Kontakts immer noch automatisch aus.
Die Kodierung, die bestimmten Zuordnungen
Charakter
Weltraum
Neue Zeile
&
#
Codiert als
%20
%0A
%26
%23
Ebenfalls gut zu wissen: + codiert zu %2B. Für alles andere, einschließlich Emojis, erstellen Sie die Tabelle nicht selbst: Rufen Sie encodeURIComponent() in JavaScript oder urllib.parse.quote() in Python.
Erstelle den Link im Code
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", "Hi! Ich habe eine Frage." link = f"https://wa.me/{number}?text={quote(text)}"
Kostenloses Tool

Generieren Sie Ihren WhatsApp-Link

Geben Sie eine Nummer und eine Nachricht ein. Erhalten Sie wa.me der Link api.whatsapp.com gleichwertig, der verschlüsselte Text, ein HTML-Snippet und der offizielle Button, alles auf einmal.
Läuft vollständig in Ihrem Browser. Es wird niemals eine Nummer an einen Server gesendet.
Vollständige internationale Nummer. Kein +, keine 0, keine Leerzeichen oder Bindestriche.
Optional. Landet im Chat-Eingabefeld und kann vom Sender weiterhin bearbeitet werden.
wa.me-Link
https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product.
t.me
https://api.whatsapp.com/send?phone=15550123456&text=Hi!%20I%20have%20a%20question%20about%20your%20product.
Textparameter, codiert
Hallo! Ich habe eine Frage zu Ihrem Produkt.
HTML-Snippet, bereit zum Einfügen
<a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener" aria-label="Chatten auf WhatsApp">Chatten auf WhatsApp</a>
Offizieller "Chat auf WhatsApp"-Button
Chatten auf WhatsApp
<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=""> Chatten auf WhatsApp</a>
Dieser Link öffnet einen Chat. Er sendet die Nachricht nicht ab, und Ihr Produkt wird die Antwort nicht sehen.

Sendet ein WhatsApp-Link die Nachricht ab?

Nein. Ein Click-to-Chat-Link öffnet das Gespräch und füllt das Textfeld vor. Nichts wird gesendet, bevor die Person, die das Telefon hält, auf Senden drückt.
Der ehrliche Teil

Was kann ein WhatsApp-Link nicht tun?

Ein Click-to-Chat-Link ist zustandslos. Ihr Produkt erfährt nie, ob auf den Link geklickt, ob die Nachricht gesendet oder ob dem Empfänger geantwortet wurde.
Wo das Glied endet
Link geklickt
Chat öffnet sich
Vorausgefüllte Nachricht
Manuell senden
LinkStoppthier
Antwort erhalten
Verlauf der Unterhaltung
Webhook-Ereignis
Nutzerbezogene Zuordnung
Keine Zustell- oder Lesebestätigung
Keine Antwort wurde an Ihre Anwendung zurückgeleitet
Kein Gesprächsverlauf
Keine Anhänge
Kein serverseitiger Trigger. Es braucht einen Menschen und einen Klick
Keine nutzerspezifische Zuordnung in einem Mandantenprodukt
Stiller Fehlschlag, wenn die Nummer kein aktives WhatsApp-Konto hat
Unterschiedliches Verhalten auf Desktop, WhatsApp Web und Mobilgeräten
Keine Gruppenerstellung oder -verwaltung. Ein Link öffnet nur einen Eins-zu-Eins-Chat, siehe WhatsApp-Gruppen-API Grenzen für alles Gruppenbezogene
Ein Link kann keine Klicks, Antworten oder Verläufe melden. Eine API kann das. Erstelle eine echte WhatsApp-Integration
Fügen Sie den Link ein

Wie bekommen Sie die Antwort zurück in Ihre App?

Sie benötigen eine API, die eine WhatsApp-Sitzung hält. Es existieren zwei Routen: Metas Cloud-API, wofür ein verifiziertes Unternehmenskonto erforderlich ist, oder ein Connected-Account-API wie bei Unipile, wo der Endnutzer sein eigenes WhatsApp-Konto im Namen des authentifizierten Nutzers per QR-Code oder Kopplungscode verknüpft.
Meta Cloud APIVerifiziertes Unternehmen
Erfordert ein verifiziertes WhatsApp Business-Konto
Abgerechnet pro Nachricht seit dem 1. Juli 2025, siehe die Preise für die WhatsApp Business API Aufschlüsselung
Das 24-Stunden-Kundendienstfenster existiert nach wie vor, es bestimmt, was kostenlos ist, nicht, was in Rechnung gestellt wird.
Entwickelt für skalierbare, vorlagenbasierte Benachrichtigungen
Verknüpftes Konto, UnipileKeine Verifizierung
Jeder Endbenutzer verknüpft sein eigenes WhatsApp-Konto im Namen des authentifizierten Benutzers
Per QR-Code oder Kopplungscode, keine Meta-Business-Verifizierung
Liest und sendet E-Mails aus dem aktuell verknüpften Posteingang, einschließlich Antworten.
Dasselbe Verbinden-, Senden-, Listen-, Lauschen-Muster wie LinkedIn, Instagram, Telegram, Gmail, Outlook und IMAP
connected-account-flow.js
// 1. Verknüpfen Sie das Konto im Namen des authentifizierten Benutzers const { qrCodeString } = await Kunde.Konto.WhatsApp verbinden();// 2. Senden Sie eine Nachricht, sobald die Verknüpfung hergestellt ist POST /api/v1/chats/{chat_id}/messages{ "Text": "Hallo! Ihre Bestellung wurde versandt." }// 3. Antworten über einen Webhook empfangen, kein Polling{ "Ereignis": "Nachricht empfangen", "chat_id": "chat_182...", "Nachricht": "Ist das noch da?"}
Den vollständigen Versandleitfaden, Payloads und die Webhook-Verarbeitung finden Sie unter Wie man WhatsApp-Nachrichten über die API sendet. Endpunkt-Referenz: developer.unipile.com/docs/whatsapp.
Entscheidung

Link, Cloud-API oder verbundenes Konto: Was davon brauchen Sie?

Verwenden Sie einen Link, wenn ein Mensch das Gespräch von einer von Ihnen kontrollierten Seite aus initiiert. Verwenden Sie die Cloud-API, wenn ein verifiziertes Unternehmen musterte Benachrichtigungen in großem Maßstab sendet. Verwenden Sie eine API für verknüpfte Konten, wenn Ihr Produkt aus dem eigenen WhatsApp-Posteingang des Benutzers lesen und dorthin senden muss.
Kriterium
Link
Meta Cloud API
Verknüpftes Konto
Wer initiiert
LinkEin Mensch, von einer Seite, die du kontrollierst
Cloud-APIIhr Unternehmen sendet zuerst, vorlagenbasiert
Verknüpftes KontoBeide Seiten, aus dem verknüpften Posteingang
Autorisierung erforderlich
LinkNichts
Cloud-APIVerifiziertes Meta Business-Konto
Verknüpftes KontoQR-Code oder Kopplungscode, keine Unternehmensverifizierung
Kosten
LinkKostenlos
Cloud-APIPro Nachricht, seit dem 1. Juli 2025
Verknüpftes KontoUnipile Tarifpreise, nicht pro Nachricht abgerechnet
Erhebt Antworten
LinkNein
Cloud-APIJa, über Webhook
Verknüpftes KontoJa, über Webhook
Verlauf der Unterhaltung
LinkNein
Cloud-APIJa
Verknüpftes KontoJa
Mandantenfähige Produkte
LinkUnterbrechungen, eine fest kodierte Nummer
Cloud-APIBenötigt individuelles Routing pro Geschäftsnummer
Verknüpftes KontoNativ, ein verknüpftes Konto pro Endbenutzer
Einrichtungszeit
LinkProtokoll
Cloud-APITage bis Wochen, Unternehmensverifizierung
Verknüpftes KontoMinuten in Stunden
Ich brauche nur einen Link
Verwenden Sie die Generator oben. Kein Konto, keine Einrichtung.
Versand von templated Benachrichtigungen
Siehe das WhatsApp Cloud API-Integration Leitfaden.
Lesen und Senden gemäß Benutzer
Beginnen Sie mit dem Vollständiger WhatsApp API Guide.
Die meisten Produkte entwachsen dem Link innerhalb einer Woche. Beginnen Sie dort, wo Sie ohnehin landen werden. Beginnen Sie mit dem Bau
Umsetzung

Wie bindet man einen WhatsApp-Link in ein Produkt ein?

Generieren Sie den Link serverseitig pro Nutzer und hardcodieren Sie niemals eine Telefonnummer in einem Mandantenfähigen Produkt. Der Link ist nur ein Anker und gehört daher in Ihre Template-Schicht, nicht in Ihre API-Schicht.
chat-button.html
<a href="https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}" Ziel="_blank" rel="noopener" aria-label="Auf WhatsApp chatten"Auf WhatsApp chattena>
Offizieller Button
WhatsApp veröffentlicht einen vorgefertigten "Chat on WhatsApp"-Badge in Grün und Weiß, in einigen festen Größen, der ohne Änderungen verwendet werden soll.
Chatten auf WhatsApp
QR-Code
Jeder QR-Code-Generator, der eine URL akzeptiert, verwandelt eine wa.me Link in einen scannbaren Code für Print, Verpackungen oder Beschilderungen vor Ort.
Mobil Öffnet die WhatsApp-App direkt mit dem Chat und dem vorgefertigten Text.
Desktop, App installiert Öffnet die WhatsApp-Desktop-App anstelle des Browsers.
Desktop, keine App Öffnet WhatsApp Web im Browser und fordert zur QR-Code-Anmeldung auf, falls die Sitzung nicht bereits aktiv ist.
Warum Links in Mandantenfähigen Produkten abbrechen: Eine einzelne fest codierte Nummer kann Ihre Kunden nicht auseinanderhalten. Generieren Sie den Link jedes Mal aus dem jeweiligen Benutzer- oder Workspace-Datensatz, sodass er genau die Nummer enthält, die dieser Benutzer tatsächlich besitzt, und keine einmalig in eine Vorlage eingefügte Nummer.
Fehlerbehebung

Warum funktioniert mein WhatsApp-Link nicht?

Die beiden häufigsten Ursachen sind eine Telefonnummer, die nicht im einfachen internationalen Format vorliegt, und eine text Parameter, der nicht URL-codiert war.
UrsacheTelefonnummer nicht im internationalen Standardformat
KorrigierenVerwenden Sie die vollständige internationale Nummer, nur Ziffern: nein +, kein führendes 0, keine Leerzeichen, Bindestriche oder Klammern.
UrsacheDer Text-Parameter war nicht URL-kodiert
KorrigierenLeiten Sie die Nachricht durch encodeURIComponent() in JavaScript oder urllib.parse.quote() in Python, bevor sie angehängt wird.
UrsacheDie Nummer hat kein aktives WhatsApp-Konto
KorrigierenDer Link öffnet sich zwar noch, aber der Chat schlägt leise fehl. Überprüfen Sie zuerst, ob die Nummer tatsächlich bei WhatsApp registriert ist.
UrsacheIm In-App-Browser einer Drittanbieter-App geöffnet
KorrigierenIn-App-Browser von Social-Media- oder Werbeplattformen blockieren oder verarbeiten die Weiterleitung manchmal fehlerhaft. Öffnen Sie den Link stattdessen im Standardbrowser des Systems.
UrsacheEin Link-Vorschau-Crawler hat die URL umgeschrieben
KorrigierenEinige Plattformen leiten ausgehende Links über ihre eigene Weiterleitung um, wodurch die Query-Zeichenfolge verloren gehen kann. Testen Sie den rohen wa.me Direkt-URL.

WhatsApp-Link-API – FAQ

Alles, was Entwickler über wa.me, api.whatsapp.com, den text-Parameter und wo der Link aufhört, fragen.

Es gibt keine einzelne WhatsApp-Link-API. wa.me und api.whatsapp.com/send Click-to-Chat-URLs sind: Das Öffnen einer solchen URL startet ein Gespräch in WhatsApp, ganz ohne Authentifizierung, Entwicklerkonto oder Code. Die eigenen APIs von WhatsApp sind eine separate Ebene, die genau dort beginnt, wo der Link aufhört, sobald eine Person antworten muss.

Das dokumentierte Format ist https://wa.me/<number>, wo <number> ist die vollständige Telefonnummer im internationalen Format. Das WhatsApp-Hilfezentrum weist an, führende Nullen, Klammern, Leerzeichen oder Bindestriche wegzulassen, zum Beispiel https://wa.me/1XXXXXXXXXX.

Beide öffnen dasselbe Gespräch. wa.me/ ist die Kurzform im WhatsApp-Hilfebereich dokumentiert, wobei die Nummer im URL-Pfad enthalten ist. api.whatsapp.com/send?phone= ist die Langform, die stattdessen die Nummer als Abfrageparameter überträgt, immer noch weit verbreitet.

Nein. Ein Click-to-Chat-Link öffnet das Gespräch und kann das Textfeld vorab ausfüllen, aber es wird nichts gesendet, bis die Person, die das Telefon hält, auf Senden drückt.

Ja. Anhängen ?text= gefolgt von einer URL-codierten Nachricht, zum Beispiel https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. Der Text landet im Chat-Eingabefeld, ist vorausgefüllt und vor dem Senden noch bearbeitbar. Probieren Sie es aus im Generator oben.

Die beiden häufigsten Ursachen sind eine Telefonnummer, die nicht im internationalen Standardformat vorliegt, und eine text Parameter, der nicht URL-kodiert war. Überprüfen Sie außerdem, ob die Nummer ein aktives WhatsApp-Konto hat und ob der Link nicht im In-App-Browser einer Drittanbieter-App geöffnet wurde.

Nein. A wa.me oder api.whatsapp.com/send Der Link erfordert kein Geschäftskonto, keine Verifizierung und keinen API-Zugang. Die WhatsApp Business Platform bzw. Cloud API ist ein separates verifiziertes Produkt für Unternehmen, die standardisierte Benachrichtigungen in großem Umfang versenden oder Antworten programmatisch empfangen müssen. Siehe die Vollständiger WhatsApp API Guide.

Ein Link selbst kann Antworten nicht an Ihre App zurückmelden, er ist zustandslos. Um aus einem tatsächlichen Posteingang zu lesen und an diesen zu senden, benötigen Sie eine API, die eine WhatsApp-Sitzung hält: entweder die Cloud-API von Meta mit einem verifizierten Unternehmenskonto oder eine API für verknüpfte Konten wie Unipile, bei der jeder Endbenutzer im Namen des authentifizierten Benutzers sein eigenes WhatsApp-Konto per QR-Code oder Kopplungscode verknüpft. Siehe Wie man WhatsApp-Nachrichten über die API sendet.

Sie sind sich immer noch nicht sicher, ob Sie einen Link oder eine API benötigen? Unser Team hilft Ihnen gerne bei der Entscheidung.

Sprechen Sie mit einem Experten
de_DEDE