Business Messages

account = client.business_accounts.list.data.first

# Simple check
if account.window_open?("+33699887766")
  account.send_text(to: "+33699887766", text: "Thanks for reaching out!")
else
  # Window closed — send a template instead
  account.send_template(to: "+33699887766", template_name: "follow_up", template_language: "en_US")
end

info = account.window("+33699887766")
info["open"]            # => true
info["last_inbound_at"] # => "2026-03-06T10:00:00Z"
info["expires_at"]      # => "2026-03-07T10:00:00Z"

account = client.business_accounts.list.data.first

msg = account.send_text(to: "+33699887766", text: "Hello!")
msg.id      # => "msg_01hz..."
msg.status  # => "queued"

msg = account.send_template(
  to: "+33699887766",
  template_name: "order_confirmation",
  template_language: "en_US"
)

# Image
account.send_image(to: "+33699887766", url: "https://example.com/photo.jpg")

# Video
account.send_video(to: "+33699887766", url: "https://example.com/clip.mp4")

# Audio
account.send_audio(to: "+33699887766", url: "https://example.com/voice.ogg")

# Document
account.send_document(to: "+33699887766", url: "https://example.com/invoice.pdf")

# With hash buttons (full control over IDs)
account.send_buttons(
  to: "+33699887766",
  body: "Would you like to proceed?",
  buttons: [
    { id: "confirm", title: "Yes, confirm" },
    { id: "cancel", title: "No, cancel" }
  ]
)

# With string shortcuts (IDs auto-generated as btn_0, btn_1, ...)
account.send_buttons(
  to: "+33699887766",
  body: "Rate your experience:",
  buttons: ["Great", "OK", "Poor"]
)

# In your webhook handler
registry = WhatsrbCloud::EventRegistry.new

registry.on("message.received") do |data|
  if data["message_type"] == "interactive"
    meta = data["message_metadata"]
    case meta["id"]
    when "confirm" then process_confirmation(data)
    when "cancel"  then handle_cancellation(data)
    end
  end
end

messages = client.business_messages(account.id)

msg = messages.create(
  to: "+33699887766",
  message_type: "text",
  content: "Hello!"
)

result = account.messages.list
result.data  # => Array of Message objects
result.meta  # => { "total" => 42 }

msg = account.messages.retrieve("msg_01hz...")
msg.status       # => "delivered"
msg.delivered_at # => 2026-01-01 12:00:05 UTC

msg.queued?    # => true
msg.sent?      # => false
msg.delivered? # => false
msg.read?      # => false
msg.failed?    # => false