Voice

Use voice() to send a voice note. It uses the same input shape as attachment: a path, a URL, or a Buffer plus optional metadata.

This page covers audio clips sent inside messages. To place or receive a live call, see Voice calls over SIP.

import { voice } from "spectrum-ts";

// From a file path
await space.send(voice("/path/to/note.m4a"));

// From a buffer - duration in seconds is optional but useful for waveform UIs
await space.send(voice(buffer, {
  name: "note.m4a",
  mimeType: "audio/mp4",
  duration: 12,
}));

Platforms that don’t support voice notes typically downgrade to a regular audio attachment. If the MIME type can’t be inferred and options.mimeType is omitted, the builder throws at send time.

Voice

Resolved voice content delivered alongside the message.

Field	Type	Description
`mimeType`	`string`	The audio MIME type, such as `audio/mp4`.
`name`	`string` (optional)	Filename for the underlying clip.
`duration`	`number` (optional)	Length in seconds.
`size`	`number` (optional)	Byte length, when known up front.
`read()`	`() => Promise<Buffer>`	Materialize the bytes.
`stream()`	`() => Promise<ReadableStream>`	Stream the bytes. Prefer this for large clips.

Attachments

Contacts

⌘I

Get started

Core concepts

Content

Providers

Advanced

Integrations

Best Practices

Troubleshooting