WhatsApp-Text senden (Meta)

POST https://app.sendapp.ai/api/whatsapp-meta/send

Sendet eine Freitextnachricht über die WhatsApp Cloud API von Meta (type=freetext). Sie können eine Datei anhängen, bis zu 3 Schnellantwort-Schaltflächen oder eine Schaltfläche mit Link hinzufügen.

24-Stunden-Fenster: Freitextnachrichten können nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden gesendet werden. Außerhalb dieses Fensters müssen Sie eine genehmigte Vorlage verwenden.

Eine Nachricht kann entweder bis zu 3 Schnellantwort-Schaltflächen (buttons) oder eine Link-Schaltfläche (url_button) enthalten: WhatsApp erlaubt nicht beides zusammen. Mit url_button wird eine angehängte Datei zur Kopfzeile der Nachricht (Bild, Video oder Dokument, kein Audio).

Parameter

12 · 4 Pflichtfelder

apikey erforderlich

Ihr API Key.

token erforderlich

Konto-Token.

number erforderlich

Empfängernummer im internationalen Format ohne + (z. B. 1234567890).

type erforderlich

Muss freetext sein.

message optional

Nachrichtentext (oder Bildunterschrift, wenn Sie eine Mediendatei anhängen). Erforderlich, wenn Sie keine Mediendatei übergeben.

media_url optional

Öffentliche URL der anzuhängenden Datei.

media_type optional

Medientyp: image, video, audio oder document. Erforderlich, wenn Sie media_url übergeben.

file_name optional

Dateiname (nur für Dokumente).

header optional

Kopfzeilentext, maximal 60 Zeichen (für Nachrichten mit Schaltflächen).

footer optional

Fußzeilentext, maximal 60 Zeichen (für Nachrichten mit Schaltflächen).

buttons optional

Liste von Schnellantwort-Schaltflächen, maximal 3. Jede Schaltfläche hat eine id und einen title (maximal 20 Zeichen).

url_button optional

Eine Schaltfläche, die einen Link öffnet: Objekt mit display_text (Beschriftung, maximal 20 Zeichen) und url (nur http oder https). Erfordert message; nicht mit buttons kombinierbar.

Brauchen Sie Hilfe bei der Integration? info@sendapp.live

# Einfacher Text curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/send' \ -H 'Content-Type: application/json' \ -d '{ "apikey": "YOUR_API_KEY", "token": "YOUR_ACCOUNT_TOKEN", "number": "1234567890", "type": "freetext", "message": "Hallo! Danke, dass Sie uns kontaktiert haben." }' # Text + Bild curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/send' \ -H 'Content-Type: application/json' \ -d '{ "apikey": "YOUR_API_KEY", "token": "YOUR_ACCOUNT_TOKEN", "number": "1234567890", "type": "freetext", "message": "Hier ist Ihr Gutschein!", "media_url": "https://esempio.com/coupon.jpg", "media_type": "image" }' # Text + Schaltfläche mit Link curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/send' \ -H 'Content-Type: application/json' \ -d '{ "apikey": "YOUR_API_KEY", "token": "YOUR_ACCOUNT_TOKEN", "number": "1234567890", "type": "freetext", "message": "Hier ist unser Katalog", "url_button": { "display_text": "Katalog ansehen", "url": "https://esempio.com/catalogo" } }'

<?php $ch = curl_init('https://app.sendapp.ai/api/whatsapp-meta/send'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode([ 'apikey' => 'YOUR_API_KEY', 'token' => 'YOUR_ACCOUNT_TOKEN', 'number' => '1234567890', 'type' => 'freetext', 'message' => 'Hallo! Danke, dass Sie uns kontaktiert haben.', ]), ]); echo curl_exec($ch);

const res = await fetch('https://app.sendapp.ai/api/whatsapp-meta/send', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ apikey: 'YOUR_API_KEY', token: 'YOUR_ACCOUNT_TOKEN', number: '1234567890', type: 'freetext', message: 'Hallo! Danke, dass Sie uns kontaktiert haben.' }) }); console.log(await res.json());