> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zavu.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Senders with the Ruby SDK

> Create, update and list sender profiles via the Zavu Ruby SDK. Combine phone numbers, WhatsApp accounts and webhooks into routing identities.

Senders are phone numbers or identities used to send messages. Each project can have multiple senders with one designated as default.

## List Senders

```ruby theme={null}
result = client.senders.list

result.items.each do |sender|
  puts "#{sender.id} #{sender.name} #{sender.phone_number}"
  puts "(Default sender)" if sender.is_default
end

# With pagination
result = client.senders.list(
  limit: 50,
  cursor: "cursor_xxx"
)
```

## Get Sender

```ruby theme={null}
result = client.senders.get(sender_id: "snd_abc123")

puts result.id
puts result.name
puts result.phone_number
puts result.is_default
```

## Create Sender

```ruby theme={null}
result = client.senders.create(
  name: "Marketing",
  phone_number: "+15551234567",
  set_as_default: true
)

puts result.id # snd_xxx
```

### With Webhook

```ruby theme={null}
result = client.senders.create(
  name: "Marketing",
  phone_number: "+15551234567",
  webhook_url: "https://your-app.com/webhooks",
  webhook_events: ["message.inbound", "message.delivered", "message.failed"]
)

# Webhook secret is only returned on create
if result.webhook&.secret
  puts "Save this secret: #{result.webhook.secret}"
end
```

## Update Sender

```ruby theme={null}
result = client.senders.update(
  sender_id: "snd_abc123",
  name: "Support",
  set_as_default: true
)
```

### Update Webhook Configuration

```ruby theme={null}
result = client.senders.update(
  sender_id: "snd_abc123",
  webhook_url: "https://new-url.com/webhooks",
  webhook_events: ["message.inbound"],
  webhook_active: true
)
```

### Disable Webhook

```ruby theme={null}
result = client.senders.update(
  sender_id: "snd_abc123",
  webhook_active: false
)
```

### Remove Webhook

```ruby theme={null}
result = client.senders.update(
  sender_id: "snd_abc123",
  webhook_url: nil
)
```

## Delete Sender

```ruby theme={null}
client.senders.delete(sender_id: "snd_abc123")
```

<Note>
  You cannot delete the default sender. Set another sender as default first.
</Note>

## Regenerate Webhook Secret

If your webhook secret is compromised, generate a new one:

```ruby theme={null}
result = client.senders.regenerate_webhook_secret(
  sender_id: "snd_abc123"
)

puts "New secret: #{result.secret}"
```

<Warning>
  After regenerating the secret, update your webhook handler to use the new secret. The old secret will no longer work.
</Warning>

## WhatsApp Business Profile

Manage the WhatsApp Business Profile for senders with a connected WhatsApp Business Account.

### Get Profile

```ruby theme={null}
response = client.senders.get_profile("snd_abc123")

puts response.profile.about
puts response.profile.description
puts response.profile.address
puts response.profile.email
puts response.profile.websites
puts response.profile.vertical
puts response.profile.profile_picture_url
```

### Update Profile

```ruby theme={null}
response = client.senders.update_profile("snd_abc123",
  about: "Your trusted online store",
  description: "Best products at competitive prices",
  address: "123 Main St, San Francisco, CA",
  email: "support@example.com",
  websites: ["https://example.com"],
  vertical: "RETAIL"
)
```

### Upload Profile Picture

```ruby theme={null}
response = client.senders.upload_profile_picture("snd_abc123",
  image_url: "https://example.com/logo.png",
  mime_type: "image/png"
)
```

<Note>
  Profile methods are only available for senders with a WhatsApp Business Account connected.
</Note>

## Using Senders in Messages

Specify a sender when sending a message:

```ruby theme={null}
result = client.messages.send(
  to: "+14155551234",
  text: "Hello!",
  zavu_sender: "snd_abc123"
)
```

If no sender is specified, the default sender is used.