Go

go get github.com/clutchcall/clutchcall-sdk/go

import "github.com/clutchcall/clutchcall-sdk/go/pkg/voice"

package main

import (
	"log"
	"os"

	"github.com/clutchcall/clutchcall-sdk/go/pkg/voice"
)

func main() {
	v, err := voice.New(
		"https://engine.clutchcall.dev",
		os.Getenv("CLUTCHCALL_API_KEY"),
		"org_123",
	)
	if err != nil {
		log.Fatal(err)
	}

	// The three sub-clients are accessors (methods), not fields:
	calls  := v.Calls()
	agents := v.Agents()
	bridge := v.AudioBridge()
	_ = bridge
}

v.RelayHost = "relay.clutchcall.dev"
v.HTTP = &http.Client{Timeout: 10 * time.Second}

call, err := v.Calls().Originate(voice.OriginateArgs{
	To:      "+15551234567",
	From:    "+15558675309",
	TrunkID: "trunk_main",
	Agent:   "healthcare-assistant", // optional
})
if err != nil {
	log.Fatal(err)
}
log.Println(call.Sid, call.Status) // "cs_…", "dialing"

call, err := v.Calls().Get("cs_abc123")
if err != nil {
	log.Fatal(err)
}
log.Println(call.Status)

// Warm-transfer the caller to a human on the PSTN:
if err := call.Transfer(voice.TransferArgs{To: "+15558675309"}); err != nil {
	log.Fatal(err)
}

// …or re-point the call at a different AI agent:
err = call.Transfer(voice.TransferArgs{Agent: "billing-specialist"})

if err := call.Hangup(); err != nil {
	log.Fatal(err)
}

if err := v.Agents().Attach(call.Sid, "healthcare-assistant"); err != nil {
	log.Fatal(err)
}

bridge, err := v.AudioBridge().Attach(call.Sid, voice.AudioBridgeOpts{
	Codec: voice.CodecOpus,
	OnUplink: func(frame []byte, timestampUs uint64) {
		// caller audio arrives here, frame by frame
		process(frame)
	},
})
if err != nil {
	log.Fatal(err)
}
defer bridge.Close()

// Push one encoded frame back to the caller:
bridge.PublishDownlink(reply) // []byte, timestamped for you

call, err := v.Calls().Originate(args)
if err != nil {
	var ve *voice.Error
	if errors.As(err, &ve) {
		// client-side validation problem — bad args
	}
	log.Printf("originate failed: %v", err)
	return
}