Telephony Integration
Apps & Automationtelephony-integrationTelephony Integration is an Agent Skill for apps & automation published in the rapidaai/voice-ai repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Add or modify telephony providers in assistant-api with transport-aware streamers/webhooks, factory wiring, and codec/resampling compatibility.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/rapidaai/voice-ai/blob/HEAD/.claude/skills/telephony-integration/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/telephony-integration, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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
ReceiveCallparses provider webhook payload intoCallInfo.InboundCallreturns provider-specific connect response.NewStreamerpath handles media transport and codec conversion.StatusCallbackand 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
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>