| name | telephony-integration |
| description | Add or modify telephony providers in assistant-api with transport-aware streamers/webhooks, factory wiring, and codec/resampling compatibility. |
Telephony Integration Skill
Mission
Integrate telephony providers safely across webhook signaling, media streaming, context routing, and disconnect handling.
Inputs expected from user
- Transport: WebSocket media stream, SIP RTP/session, AudioSocket TCP, or mixed.
- Inbound and outbound call requirements.
- Codec/sample-rate constraints from provider.
If user does not answer:
- Use nearest baseline provider (
twilio, exotel, vonage, asterisk, sip).
- Preserve internal LINEAR16 16kHz core format and use base resampler paths.
Hard boundaries
In scope:
api/assistant-api/internal/channel/telephony/internal/<provider>/...api/assistant-api/internal/channel/telephony/telephony.go- only if needed:
inbound.go, outbound.go, api/assistant-api/internal/type/telephony.go, streamer.go
- UI telephony provider registration and component files
Out of scope:
- STT/TTS provider internals
- EOS/VAD internals
- integration-api LLM callers
Runtime flow checklist
ReceiveCall parses provider webhook payload into CallInfo.InboundCall returns provider-specific connect response.NewStreamer path handles media transport and codec conversion.StatusCallback and catch-all callback map provider events.- Interruption and end-conversation directives close sessions cleanly.
Transport mapping baselines
- WebSocket media:
twilio, vonage, exotel, asterisk/websocket
- SIP native session:
sip
- TCP AudioSocket:
asterisk/audiosocket
Governed lifecycle
- Classify work as Fast, Standard, or Governed using
DEVELOPMENT_PROCESS.md; use the full gated lifecycle only for Governed work.
- This skill operates only in its assigned phase and path ownership; it may not approve its own plan or code review.
- Governed implementation starts only from a coordinator-attested approved plan; Fast and Standard work follows its lighter documented lifecycle.
- Return changed-file and verification evidence to the coordinator, then route the complete verified diff to the read-only
code-reviewer.
Validation commands
go test ./api/assistant-api/internal/channel/telephony/...go test ./api/assistant-api/internal/adapters/internal/...cd ui && yarn test providers./.claude/skills/telephony-integration/scripts/validate.sh --check-diff --provider <provider>
