Business Accounts

result = client.business_accounts.list

result.data  # => Array of BusinessAccount objects
result.meta  # => { "total" => 1, "plan_limit" => 5 }

account = client.business_accounts.retrieve("acc_01hx...")
account.id             # => "acc_01hx..."
account.waba_id        # => "123456789"
account.business_name  # => "Acme Corp"
account.phone_number   # => "+33612345678"
account.display_name   # => "Acme"
account.status         # => "active"
account.quality_rating # => "GREEN"
account.connected?     # => true

request = client.business_accounts.connect

request.id         # => "con_01hx..."
request.url        # => "https://whatsrb.com/connect/TOKEN"
request.status     # => "pending"
request.expires_at # => "2026-01-01T12:05:00Z"

# Poll until the user completes signup (up to 5 minutes)
account = request.wait_for_account(timeout: 300, interval: 3)
account.business_name # => "Acme Corp"

account = client.business_accounts.connect_manual(
  waba_id:           "123456789",
  phone_number_id:   "987654321",
  business_name:     "Acme Corp",
  display_name:      "Acme",
  phone_number:      "+33612345678",
  meta_access_token: "EAAxxxxxxx"
)

client.business_accounts.delete("acc_01hx...")  # => true

account = client.business_accounts.list.data.first

# Text message
account.send_text(to: "+33699887766", text: "Hello!")

# Template message
account.send_template(
  to: "+33699887766",
  template_name: "order_confirmation",
  template_language: "en_US"
)

# Media messages (within 24h conversation window)
account.send_image(to: "+33699887766", url: "https://example.com/photo.jpg")
account.send_video(to: "+33699887766", url: "https://example.com/clip.mp4")
account.send_audio(to: "+33699887766", url: "https://example.com/voice.ogg")
account.send_document(to: "+33699887766", url: "https://example.com/invoice.pdf")