curl -X POST "https://suasofia.online/api/user/whatsapp/send-freeform" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": 12,
    "recipient_phone": "+1234567890",
    "message": "Obrigado pela sua consulta! Nossa equipe revisará seu pedido e retornará em até 2 horas."
  }'

const response = await fetch(
  'https://suasofia.online/api/user/whatsapp/send-freeform',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      sender_id: 12,
      recipient_phone: '+1234567890',
      message: 'Obrigado pela sua consulta! Nossa equipe revisará seu pedido e retornará em até 2 horas.'
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://suasofia.online/api/user/whatsapp/send-freeform',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'sender_id': 12,
        'recipient_phone': '+1234567890',
        'message': 'Obrigado pela sua consulta! Nossa equipe revisará seu pedido e retornará em até 2 horas.'
    }
)

print(response.json())

{
  "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": "Sessão aberta (23 hr 45 min restantes). Mensagens freeform ilimitadas permitidas.",
    "minutes_remaining": 1425,
    "expires_at": "2026-02-25T10:30:00+00:00"
  }
}

{
  "success": false,
  "error": "Insufficient balance. Please top up your account.",
  "error_code": "INSUFFICIENT_BALANCE"
}

{
  "success": false,
  "error": "A janela de mensagens de 24 horas está fechada. O cliente deve responder primeiro, ou use uma mensagem de template.",
  "error_code": "SESSION_EXPIRED",
  "session_status": {
    "is_open": false,
    "can_send_freeform": false,
    "requires_template": true,
    "message": "Sessão expirada. Envie um template ou aguarde o cliente responder.",
    "expired_at": "2026-02-23T10:30:00+00:00"
  }
}

{
  "success": false,
  "error": "Sender not found or does not belong to you",
  "error_code": "SENDER_NOT_FOUND"
}

{
  "success": false,
  "error": "Formato de número de telefone inválido. Use o formato E.164 (ex: +14155551234).",
  "error_code": "INVALID_PHONE"
}

{
  "success": false,
  "error": "Remetente não está online. Status atual: Offline",
  "error_code": "SENDER_OFFLINE"
}