In diesem Tutorial erfahren Sie, wie Sie die Zustellung von Nachrichten über die API planen.
Es gibt zwei Möglichkeiten, die Zustellung einer Nachricht auf einen späteren Zeitpunkt und/oder Tag zu planen: indem Sie das genaue Datum und die genaue Uhrzeit angeben, zu der die Nachricht gesendet werden soll, oder indem Sie angeben, um wie viele Minuten, Stunden oder Tage die Zustellung verzögert werden soll.
Wenn Sie Nachrichten aus Code heraus senden möchten, können Sie jede Programmiersprache verwenden, um HTTPS-API-Anfragen zu stellen. Unten finden Sie den Live-API-Tester mit sofort nutzbaren Codebeispielen in verschiedenen Programmiersprachen.
Voraussetzungen
- Mindestens eine WhatsApp-Nummer bereits mit der Plattform verknüpft und online.
- Empfängernummer mit internationaler Vorwahl im E164-Format. Beispiel:
+12345678909. Sie können die Telefonnummer hier validieren.
API-Endpunkt
In diesem Tutorial verwenden wir den folgenden API-Endpunkt:
Anfrage vorbereiten
Ziel-API-URL (POST)
https://api.wassenger.com/v1/messages
Erforderliche HTTPS-Header
Content-Type: application/json
Token: ENTER API KEY HERE
Eine Nachricht an einem bestimmten Datum im ISO8601-Format senden
Beispiel für den Request-Body im JSON-Format
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.wassenger.com/v1/messages',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'phone' => '+12345678909',
'message' =>
'This is a scheduled message to be sent to a phone number in 10 minutes',
'deliverAt' => '2025-01-03T10:11:24.323Z',
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Token: API TOKEN GOES HERE',
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo 'cURL Error #:' . $err;
} else {
echo $response;
}
Sie können geplante Nachrichten auch an einen Gruppenchat senden:
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.wassenger.com/v1/messages',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'group' => '${group_ID@g.us}',
'message' =>
'This is a scheduled message to be sent tomorrow to a group chat.Date format is based on ISO 8601 format with default UTC time zone',
'deliverAt' => '2025-01-04T10:01:24.323Z',
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Token: API TOKEN GOES HERE',
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo 'cURL Error #:' . $err;
} else {
echo $response;
}
Zustellung der Nachricht um Minuten, Stunden oder Tage verzögern
Beispiel für den Request-Body im JSON-Format
Gültige Beispielwerte wären: 1m = in 1 Minute, 2h = in 2 Stunden, 15d = in 15 Tagen.
Werte müssen ganze Zahlen sein. Wenn Sie z. B. eine Nachricht für 1,5 Stunden planen möchten, müssen Sie 90m angeben = in 90 Minuten.
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.wassenger.com/v1/messages',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'phone' => '+12345678909',
'message' =>
'This is a scheduled message to be sent to a phone number in 10 minutes',
'schedule' => [
'delayTo' => '1h',
],
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Token: API TOKEN GOES HERE',
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo 'cURL Error #:' . $err;
} else {
echo $response;
}
Alternativ können Sie die Zustellung der Nachricht um eine bestimmte Anzahl von Sekunden verzögern:
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.wassenger.com/v1/messages',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'phone' => '+12345678909',
'message' =>
'This is a scheduled message to be sent to a phone number in 10 minutes',
'schedule' => [
'delayTo' => '180',
],
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Token: API TOKEN GOES HERE',
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo 'cURL Error #:' . $err;
} else {
echo $response;
}
Live-API-Tests
Sie können die API jetzt direkt im Browser ausprobieren, debuggen und live testen, weitere API-Beispiele erkunden und per Klick einsatzbereite Code-Snippets in mehr als 15 verschiedenen Programmiersprachen erhalten 😎
Fragen? Bitte schauen Sie sich die folgenden häufig gestellten Fragen an.
Häufig gestellte Fragen (FAQs)
Wie Sie Nachrichten an mehrere Telefonnummern senden
Sie müssen einfach mehrere API-Anfragen senden, eine pro Zieltelefonnummer.
Wenn Sie beispielsweise eine Nachricht an 10 Telefonnummern senden möchten, sollten Sie 10 unabhängige HTTPS-Anfragen an die API senden.
Es gibt keine Option, mehrere Nachrichten in einer einzigen API-Anfrage zu senden.
Welche Arten von Nachrichten können gesendet werden?
Sie können verschiedene Nachrichtentypen per API senden, einschließlich Text, Bilder, Videos, Emojis, Audio, GIFs, Standorte und Dateien/Dokumente.
Schauen Sie sich weitere Tutorials für mehr Informationen an.
Wie Sie prüfen, ob eine Telefonnummer WhatsApp-Nachrichten empfangen kann
Sie können prüfen, ob eine bestimmte Telefonnummer mit einem WhatsApp-Konto verknüpft ist und Nachrichten empfangen kann.
Die API stellt einen Endpunkt bereit, der validieren kann, ob eine bestimmte Telefonnummer bei WhatsApp existiert oder nicht.
Voraussetzung ist lediglich, dass mindestens eine WhatsApp-Nummer in Ihrem aktuellen Account mit der Plattform verbunden ist.
Weitere Details finden Sie in der API-Endpunktdokumentation hier.
Bevor Sie prüfen, ob eine Telefonnummer bei WhatsApp existiert, können Sie zudem das Format einer Liste von Telefonnummern mit dem Numbers Validator API-Endpunkt validieren und normalisieren. Dieser Endpunkt prüft nur das korrekte E164-Format, er überprüft jedoch nicht, ob die Telefonnummer tatsächlich bei WhatsApp existiert oder nicht.
Hinweis: Die Anzahl der WhatsApp-Prüfungen pro Monat ist abhängig von Ihrem Abonnementplan begrenzt. Bitte sehen Sie sich die Preistabelle für weitere Details zu den Limits an.
Sie suchen weitere Antworten? Schauen Sie sich die erweiterten FAQs an.
Weitere nützliche Ressourcen
API-Dokumentation
Für weitere Details zum API-Endpunkt lesen Sie bitte die Dokumentation, in der Sie alle Informationen zu den akzeptierten Request-Parametern, möglichen Erfolgs- oder Fehlerantworten und einsatzbereiten Codebeispielen in mehreren Programmiersprachen finden.
