Ingestion/SDKs

SDKs & OpenTelemetry

Instrument custom SIP, WebRTC and voice pipelines. Traces, spans, metrics, logs, baggage and context propagation.

OTel · TracesOTel · SpansOTel · MetricsOTel · LogsOTel · BaggageOTel · Trace context

TypeScript / Node.js

@ziplyhuman/sdk

npm i @ziplyhuman/sdk

Python

ziplyhuman

pip install ziplyhuman

Java

beta

com.ziplyhuman:sdk

Maven / Gradle

Go

github.com/ziplyhuman/go-sdk

go get github.com/ziplyhuman/go-sdk

.NET

beta

ZiplyHuman.Sdk

dotnet add package ZiplyHuman.Sdk

Browser JavaScript

@ziplyhuman/browser

npm i @ziplyhuman/browser

React Native

beta

@ziplyhuman/react-native

npm i @ziplyhuman/react-native

Swift

planned

ZiplyHumanSDK

SPM: ZiplyHumanSDK

Kotlin

planned

com.ziplyhuman:android

Gradle implementation

Voice AI semantic conventions

Documented span names and attributes

voice.call

Root span for an entire production conversation

telephony.connect

Carrier / SIP / WebRTC connect path

sip.invite

SIP INVITE transaction

media.stream

RTP / media stream lifecycle

asr.transcribe

Speech-to-text turn or chunk

llm.generate

Model completion for agent response

tts.synthesize

Text-to-speech generation

tool.execute

External tool / function call

workflow.step

Dialog / state-machine step

handoff.initiate

Transfer to human or queue

crm.update

CRM write or lookup side-effect

Attribute families

call

voice.call.idvoice.call.directionvoice.call.providervoice.agent.idvoice.agent.versionvoice.languagevoice.region

telephony

telephony.carriertelephony.sip.call_idtelephony.from.maskedtelephony.to.maskedtelephony.disconnect_reason

asr

asr.providerasr.modelasr.confidenceasr.languageasr.latency_ms

llm

llm.providerllm.modelllm.prompt_tokensllm.completion_tokensllm.latency_msllm.retries

tts

tts.providertts.voicetts.characterstts.latency_ms

tool

tool.nametool.statustool.latency_mstool.error

workflow

workflow.nameworkflow.stepworkflow.state

handoff

handoff.reasonhandoff.queuehandoff.agent_id

Metric names

voice.calls.activevoice.calls.completedvoice.calls.failedvoice.latency.e2evoice.latency.asrvoice.latency.llmvoice.latency.ttsvoice.latency.toolvoice.quality.scorevoice.cost.usdvoice.sentiment.score

Node.js example

import { ZiplyHuman } from "@ziplyhuman/sdk";
import { trace } from "@opentelemetry/api";

const zh = new ZiplyHuman({ apiKey: process.env.ZH_KEY });

const span = trace.getTracer("voice-agent").startSpan("voice.call");
span.setAttribute("voice.call.id", callId);
span.setAttribute("voice.agent.id", agentId);

await zh.events.track("call.started", {
  call: { provider_call_id: providerId, agent_id: agentId },
});

// asr.transcribe / llm.generate / tts.synthesize child spans...
span.end();