Zum Hauptinhalt springen
POST
/
api
/
user
/
whatsapp
/
send-freeform
curl -X POST "https://app.famulor.de/api/user/whatsapp/send-freeform" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": 12,
    "recipient_phone": "+1234567890",
    "message": "Thank you for your inquiry! Our team will review your request and get back to you within 2 hours."
  }'

{
  "success": true,
  "conversation_id": 1234,
  "message_id": 567,
  "whatsapp_message_id": 890,
  "message_sid": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "session_status": {
    "is_open": true,
    "can_send_freeform": true,
    "requires_template": false,
    "message": "Session open (23 hr 45 min remaining). Unlimited free-form messages allowed.",
    "minutes_remaining": 1425,
    "expires_at": "2026-02-25T10:30:00+00:00"
  }
}

​
Freiform-WhatsApp-Nachricht senden

Eine Freitext-WhatsApp-Nachricht innerhalb eines aktiven 24-Stunden-Fensters senden
Dieser Endpunkt sendet eine Freiform- (Freitext-) WhatsApp-Nachricht an einen Empfänger. Im Gegensatz zu Template-Nachrichten kann der Inhalt beliebigen Text enthalten, er erfordert jedoch ein aktives 24-Stunden-Messaging-Fenster – der Empfänger muss innerhalb der letzten 24 Stunden eine Nachricht an Ihren WhatsApp-Sender geschickt haben.
Freiform-Nachrichten können nur während eines aktiven 24-Stunden-Fensters gesendet werden. Wenn die Session abgelaufen ist, müssen Sie zunächst eine Template-Nachricht senden, um die Konversation wieder zu starten. Verwenden Sie den Endpunkt Session-Status, um zu prüfen, ob eine Session aktiv ist.
Dieser Endpunkt ist auf 5 Requests pro Sekunde pro Benutzer rate-limitiert.

​
Anfrage-Body

​
sender_id
integer
erforderlich
Die ID des WhatsApp-Senders, von dem gesendet werden soll (erhalten über WhatsApp-Sender abrufen)
​
recipient_phone
string
erforderlich
Die Telefonnummer des Empfängers im internationalen Format (z.B. +1234567890)
​
message
string
erforderlich
Der zu sendende Nachrichteninhalt (max. 4096 Zeichen)

​
Antwort-Felder

​
success
boolean
Ob die Nachricht erfolgreich gesendet wurde
​
conversation_id
integer
Die ID der mit dieser Nachricht verknüpften Konversation
​
message_id
integer
Die ID des Konversations-Nachrichteneintrags
​
whatsapp_message_id
integer
Die ID des WhatsApp-Nachrichteneintrags
​
message_sid
string
Die Twilio Message SID zur Sendungsverfolgung
​
session_status
object
Aktualisierter Session-Status nach dem Versand der Nachricht

​
Error Responses

​
402 Insufficient Balance
​
403 Session Expired
​
404 Not Found
​
503 Sender Offline
curl -X POST "https://app.famulor.de/api/user/whatsapp/send-freeform" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": 12,
    "recipient_phone": "+1234567890",
    "message": "Thank you for your inquiry! Our team will review your request and get back to you within 2 hours."
  }'

{
  "success": true,
  "conversation_id": 1234,
  "message_id": 567,
  "whatsapp_message_id": 890,
  "message_sid": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "session_status": {
    "is_open": true,
    "can_send_freeform": true,
    "requires_template": false,
    "message": "Session open (23 hr 45 min remaining). Unlimited free-form messages allowed.",
    "minutes_remaining": 1425,
    "expires_at": "2026-02-25T10:30:00+00:00"
  }
}

​
24-Hour Messaging Window

WhatsApp enforces a 24-hour messaging window policy:
  1. When a customer sends a message to your WhatsApp Business number, a 24-hour window opens.
  2. During this window, you can send freeform messages without restrictions.
  3. After the window expires, you must use a template message to re-initiate the conversation.
  4. Each new customer message resets the 24-hour timer.
Use the Session Status endpoint to check whether a session is active before attempting to send a freeform message.

​
Notes

  • Maximum message length is 4,096 characters (WhatsApp limit).
  • The sender must be online. Offline senders return a 503 error.
  • Message costs are automatically deducted from your account balance.
  • Rate limit: 5 requests per second per user.