WhatsApp-Text senden (Meta)

POSThttps://app.sendapp.ai/api/whatsapp-meta/send

Senden Sie eine Freitext-Nachricht über die WhatsApp Cloud API von Meta (type=freetext). Sie können auch eine Mediendatei anhängen oder interaktive Schaltflächen 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.

Parameter

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

Header-Text (für Nachrichten mit Schaltflächen).

footer optional

Footer-Text (für Nachrichten mit Schaltflächen).

buttons optional

Array von Schnellantwort-Schaltflächen, maximal 3. Jede Schaltfläche hat id und title.

Anfrage

# 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"
  }'

<?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());

Antwort (200 OK)

{
  "status": "success",
  "message": "Message sent successfully",
  "message_id": "wamid.HBgLMzkxMjM0NTY3ODkwFQIAERgSN0EwMjBBQkZDRDEyMzQ1Njc4"
}

Fehler

{
  "status": "error",
  "message": "No active WhatsApp Meta instance found"
}