Jetzt bauen
DE
WhatsApp Click-to-Chat

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

Ein WhatsApp-Link ist eine URL, keine API. Hier finden Sie die genauen Formate, den Text-Parameter, einen kostenlosen Generator und die Grenzen des Links.

Jetzt bauen
So funktioniert es

WhatsApp-Link-API: So funktionieren wa.me- und api.whatsapp.com-Links wirklich

Beide öffnen einen Chat, danach übernimmt ein Mensch.

  1. 1Jemand öffnet die URL
  2. 2WhatsApp öffnet den Chat
  3. 3Ein Mensch tippt auf Senden
Definition

Was ist eine WhatsApp-Link-API?

Eine WhatsApp-Link-API gibt es nicht. https://wa.me/<number> und https://api.whatsapp.com/send?phone=<number> sind Click-to-Chat-URLs. Die APIs beginnen dort, wo der Link aufhört.

Ein WhatsApp-Link
Einrichtung
Keine
Beim Klick
Öffnet einen Chat, füllt Text vor
Wer handelt
Ein Mensch tippt auf Senden
Eine WhatsApp-API
Einrichtung
Kontoverknüpfung und ein API-Schlüssel
Beim Aufruf
Sendet, empfängt und listet Nachrichten
Wer handelt
Ihre Software, im Namen des verknüpften Kontos
Format

Wie lautet das genaue Format eines wa.me-Links?

Das dokumentierte Format ist https://wa.me/<number>, mit der vollständigen Telefonnummer im internationalen Format.

Aufbau der URL
https://wa.me/1XXXXXXXXXX
Host. Immer gleich.
Nummer. Ländervorwahl zuerst, nur Ziffern.
Verwendenhttps://wa.me/1XXXXXXXXXX
Nicht verwendenhttps://wa.me/+001-(XXX)XXXXXXX
Vorher entfernen+Führende 0LeerzeichenBindestricheKlammern

Quelle: WhatsApp-Hilfebereich, „How to use click to chat“

Vergleich

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

Beide öffnen dieselbe Unterhaltung. Nur die Position der Nummer ändert sich.

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

Nummer im Pfad. Von WhatsApp dokumentiert.

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

Nummer im Parameter phone. Auf den aktuellen Hilfeseiten nicht auffindbar.

Eine Lücke in der Dokumentation, keine Abkündigung. Erstellen Sie neue Links mit wa.me.

Der Text-Parameter

Wie fügen Sie einem WhatsApp-Link eine vorausgefüllte Nachricht hinzu?

Hängen Sie ?text= und die URL-codierte Nachricht an: https://wa.me/<number>?text=<urlencodedtext>. Der Text bleibt bearbeitbar.

Zu codierende Zeichen
Leerzeichen%20
Zeilenumbruch%0A
&%26
#%23
+%2B

Emojis und alle anderen Zeichen: encodeURIComponent().

Keine Nummer? https://wa.me/?text=... öffnet die Kontaktauswahl.

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.
Kostenloses Tool

Erstellen Sie Ihren WhatsApp-Link

Geben Sie eine Nummer und eine Nachricht ein und kopieren Sie, was Sie brauchen.

Nur Ziffern, Ländervorwahl zuerst.
Optional, weiterhin bearbeitbar.

Läuft in Ihrem Browser. Es wird keine Nummer an einen Server gesendet.

wa.me-Link
https://wa.me/15550123456?text=Hallo!%20Ich%20habe%20eine%20Frage%20zu%20Ihrem%20Produkt.
Variante mit api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Hallo!%20Ich%20habe%20eine%20Frage%20zu%20Ihrem%20Produkt.
Text-Parameter, codiert
Hallo!%20Ich%20habe%20eine%20Frage%20zu%20Ihrem%20Produkt.
HTML-Snippet
<a href="https://wa.me/15550123456?text=Hallo!%20Ich%20habe%20eine%20Frage%20zu%20Ihrem%20Produkt." target="_blank" rel="noopener" aria-label="Chat on WhatsApp with 15550123456">Chat on WhatsApp</a>
Button „Chat on WhatsApp“
<a href="https://wa.me/15550123456?text=Hallo!%20Ich%20habe%20eine%20Frage%20zu%20Ihrem%20Produkt." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chat on WhatsApp</a>

Ein Link öffnet einen Chat. Er sendet nichts, und Ihr Produkt sieht die Antwort nie.

Das bauen, was ein Link nicht kann
Kurze Antwort

Sendet ein WhatsApp-Link die Nachricht?

Nein. Nichts wird zugestellt, bevor die Person mit dem Telefon auf Senden tippt.

Chat geöffnet
Text vorausgefüllt
Zugestellt erst nach Tippen auf Senden
Wo der Link aufhört

Was kann ein WhatsApp-Link nicht?

Ein Click-to-Chat-Link ist zustandslos: Ihre App erfährt nie, was danach passiert.

Was der Link kann
  • Link geklickt
  • Chat öffnet sich
  • Nachricht vorausgefüllt
  • Manuelles Senden
Hier endet der Link
Was eine API braucht
  • Antwort empfangen
  • Gesprächsverlauf
  • Webhook-Event
  • Zuordnung pro Nutzer
Kein Zustell- oder Lesestatus
Keine Anhänge
Kein serverseitiger Auslöser
Stiller Fehler bei Nummern ohne WhatsApp
Unterschiedliches Verhalten je nach Gerät
Keine Gruppen, siehe Grenzen der WhatsApp Group API
Eine echte WhatsApp-Integration bauen
Jenseits des Links

Wie gelangt die Antwort zurück in Ihre App?

Sie brauchen eine API, die eine WhatsApp-Sitzung hält. Dafür gibt es zwei Wege.

Meta Cloud APIVerifiziertes Unternehmen
  • Erfordert ein verifiziertes WhatsApp-Business-Konto
  • Abrechnung pro Nachricht seit dem 1. Juli 2025, siehe Preise der WhatsApp Business API
  • Antworten im 24-Stunden-Fenster: seit dem 1. Oktober 2026 monatlich 1.000 kostenlos pro Nummer
Verknüpftes Konto, UnipileKeine Business-Verifizierung
  • Jeder Endnutzer verknüpft sein eigenes WhatsApp-Konto
  • Ihre App handelt im Namen des authentifizierten Nutzers
  • Liest und sendet aus der echten Inbox, Antworten inklusive
  • Dieselbe API wie für LinkedIn, Telegram, Gmail und mehr
Mit Unipile
  1. 1Verknüpfen Sie das Konto per QR-Code oder Kopplungscode
  2. 2Senden Sie aus Ihrer App
  3. 3Empfangen Sie Antworten per Webhook: message_received

Siehe die WhatsApp API von Unipile und WhatsApp-Nachrichten per API senden. Referenz: developer.unipile.com/v1.0/docs/whatsapp.

Mit Unipile bauen
Entscheidung

Link, Cloud API oder verknüpftes Konto: Was brauchen Sie?

Entscheidend ist, wer zuerst schreibt.

Ein Link

Ein Mensch startet den Chat von Ihrer Seite aus.

Auth
Keine
Kosten
Kostenlos
Antworten
Für Ihre App unsichtbar
Generator oben nutzen
Meta Cloud API

Ein verifiziertes Unternehmen sendet Templates.

Auth
Verifiziertes Meta-Business-Konto
Kosten
Pro Nachricht, seit dem 1. Juli 2025
Antworten
Ja, per Webhook
Leitfaden zur Integration der WhatsApp Cloud API
Verknüpftes Konto

Ihr Produkt arbeitet in der eigenen Inbox jedes Nutzers.

Auth
QR-Code oder Kopplungscode
Kosten
Unipile-Tarif, keine Abrechnung pro Nachricht
Antworten
Ja, per Webhook
Vollständiger WhatsApp-API-Leitfaden
Jetzt starten
Implementierung

Wie binden Sie einen WhatsApp-Link in ein Produkt ein?

Erzeugen Sie ihn pro Nutzer in Ihren Templates. Codieren Sie in einem mandantenfähigen Produkt nie eine einzelne Nummer fest.

Link-Template
https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}
Nummer. Aus dem Nutzerdatensatz.
Text. Beim Rendern URL-codiert.
Offizieller Button

Das grüne „Chat on WhatsApp“-Badge von WhatsApp, unverändert genutzt.

QR-Code

Jeder QR-Generator macht aus einem wa.me-Link einen druckbaren Code.

Wo er sich öffnet
Mobil
Die WhatsApp-App
Desktop, App installiert
Die Desktop-App
Desktop, ohne App
WhatsApp Web
Fehlerbehebung

Warum funktioniert mein WhatsApp-Link nicht?

Meistens liegt es am Nummernformat oder an nicht codiertem Text.

1 Die Nummer ist nicht im reinen internationalen Format
https://wa.me/+001-(XXX)XXXXXXX
https://wa.me/1XXXXXXXXXX

Lösung: nur Ziffern, Ländervorwahl zuerst.

2 Der Text-Parameter wurde nicht URL-codiert
?text=Hi there & welcome
?text=Hi%20there%20%26%20welcome

Lösung: encodeURIComponent() oder urllib.parse.quote().

3 Kein aktives WhatsApp-Konto

Der Chat schlägt stillschweigend fehl.

4 In einem In-App-Browser geöffnet

Nutzen Sie den Systembrowser.

5 Eine Link-Vorschau hat die URL umgeschrieben

Der Query-String ging verloren. Testen Sie die unveränderte URL.

Mit verknüpften Konten bauen

WhatsApp-Link-API - FAQ

Kurze Antworten für Entwickler.

Nein. wa.me und api.whatsapp.com/send sind Click-to-Chat-URLs: Sie öffnen einen WhatsApp-Chat, ohne Authentifizierung und ohne Code. Die APIs von WhatsApp beginnen dort, wo der Link aufhört.

https://wa.me/<number>, wobei <number> die vollständige Nummer im internationalen Format ist, ohne führende Nullen, Klammern, Leerzeichen oder Bindestriche. Zum Beispiel: https://wa.me/1XXXXXXXXXX.

Beide öffnen dieselbe Unterhaltung. wa.me/<number> ist die im WhatsApp-Hilfebereich dokumentierte Kurzform, mit der Nummer im Pfad. api.whatsapp.com/send?phone=<number> ist die Langform, mit der Nummer als Query-Parameter.

Nein. Der Link öffnet die Unterhaltung und kann das Textfeld vorausfüllen. Nichts wird zugestellt, bevor die Person mit dem Telefon auf Senden tippt.

Ja. Hängen Sie ?text= und eine URL-codierte Nachricht an, zum Beispiel https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. Der Text bleibt vor dem Senden bearbeitbar. Testen Sie den Generator oben.

Meistens ist die Nummer nicht im reinen internationalen Format oder der Text wurde nicht URL-codiert. Prüfen Sie außerdem, ob die Nummer WhatsApp nutzt, und vermeiden Sie In-App-Browser.

Nein. Ein wa.me- oder api.whatsapp.com/send-Link braucht weder ein Business-Konto noch API-Zugang. Die Cloud API ist ein separates Produkt mit Verifizierung. Siehe den vollständigen WhatsApp-API-Leitfaden.

Nicht mit einem Link: Er ist zustandslos. Nutzen Sie die Cloud API von Meta mit einem verifizierten Business-Konto oder Unipile, wo jeder Endnutzer sein eigenes Konto per QR-Code oder Kopplungscode verknüpft und Ihre App im Namen des authentifizierten Nutzers handelt. Siehe WhatsApp-Nachrichten per API senden.

Link oder API? Unser Team hilft Ihnen bei der Entscheidung.

Sprechen Sie mit einem Experten