Skip to main content
GET
https://app.famulor.de
/
api
/
user
/
whatsapp
/
session-status
curl -X GET "https://app.famulor.de/api/user/whatsapp/session-status?sender_id=12&recipient_phone=+1234567890" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "has_conversation": true,
  "conversation_id": 1234,
  "customer_name": "John Doe",
  "last_customer_message_at": "2026-02-24T10:30:00+00:00",
  "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"
  }
}

​
WhatsApp-Session-Status abrufen

Den Status des 24-Stunden-Messaging-Fensters für eine WhatsApp-Konversation prüfen
Dieser Endpunkt prüft, ob ein aktives 24-Stunden-Messaging-Fenster zwischen Ihrem WhatsApp-Sender und einem bestimmten Empfänger besteht. Verwenden Sie ihn, um zu entscheiden, ob Sie Freiform-Nachrichten senden können oder zunächst eine Template-Nachricht nutzen müssen.

​
Query-Parameter

​
sender_id
integer
required
Die ID des WhatsApp-Senders (erhalten über WhatsApp-Sender abrufen)
​
recipient_phone
string
required
Die Telefonnummer des Empfängers im internationalen Format (z.B. +1234567890)

​
Antwort-Felder

​
success
boolean
Ob die Anfrage erfolgreich war
​
has_conversation
boolean
Ob bereits eine Konversation mit diesem Empfänger existiert
​
conversation_id
integer
Die Konversations-ID (nur vorhanden, wenn has_conversation true ist)
​
customer_name
string
Der Name des Kunden, sofern verfügbar (nur vorhanden, wenn has_conversation true ist)
​
last_customer_message_at
string
ISO-8601-Timestamp der letzten Nachricht des Kunden (nur vorhanden, wenn has_conversation true ist)
​
session_status
object

​
Fehler-Antworten

​
404 Not Found
curl -X GET "https://app.famulor.de/api/user/whatsapp/session-status?sender_id=12&recipient_phone=+1234567890" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "has_conversation": true,
  "conversation_id": 1234,
  "customer_name": "John Doe",
  "last_customer_message_at": "2026-02-24T10:30:00+00:00",
  "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"
  }
}

​
Typical Workflow

Use this endpoint as part of a message-sending flow:
  1. Check session status before sending a message
  2. If can_send_freeform is true → use Send Freeform Message
  3. If requires_template is true → use Send Template Message

​
Notes

  • The 24-hour window is based on the customer’s last inbound message timestamp.
  • Each new customer message resets the 24-hour timer.
  • This endpoint does not consume any balance — it’s a read-only status check.