Telnyx Voice Streaming Go

Telnyx Voice Streaming - Go

Installation

go get github.com/team-telnyx/telnyx-go

Setup

import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)

All examples below assume client is already initialized as shown above.

Forking start

Call forking allows you to stream the media from a call to a specific target in realtime.

POST /calls/{call_control_id}/actions/fork_start

	response, err := client.Calls.Actions.StartForking(
		context.TODO(),
		"call_control_id",
		telnyx.CallActionStartForkingParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)

Forking stop

Stop forking a call.

POST /calls/{call_control_id}/actions/fork_stop

	response, err := client.Calls.Actions.StopForking(
		context.TODO(),
		"call_control_id",
		telnyx.CallActionStopForkingParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)

Streaming start

Start streaming the media from a call to a specific WebSocket address or Dialogflow connection in near-realtime.

POST /calls/{call_control_id}/actions/streaming_start

	response, err := client.Calls.Actions.StartStreaming(
		context.TODO(),
		"call_control_id",
		telnyx.CallActionStartStreamingParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)

Streaming stop

Stop streaming a call to a WebSocket.

POST /calls/{call_control_id}/actions/streaming_stop

	response, err := client.Calls.Actions.StopStreaming(
		context.TODO(),
		"call_control_id",
		telnyx.CallActionStopStreamingParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)

Transcription start

Start real-time transcription.

POST /calls/{call_control_id}/actions/transcription_start

	response, err := client.Calls.Actions.StartTranscription(
		context.TODO(),
		"call_control_id",
		telnyx.CallActionStartTranscriptionParams{
			TranscriptionStartRequest: telnyx.TranscriptionStartRequestParam{},
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)

Transcription stop

Stop real-time transcription.

POST /calls/{call_control_id}/actions/transcription_stop

	response, err := client.Calls.Actions.StopTranscription(
		context.TODO(),
		"call_control_id",
		telnyx.CallActionStopTranscriptionParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)

Webhooks

The following webhook events are sent to your configured webhook URL. All webhooks include telnyx-timestamp and telnyx-signature-ed25519 headers for verification (Standard Webhooks compatible).