OpenParable
Skip to content
← Back to skills

Telephony Integration

Apps & Automation
telephony-integration

Telephony 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

  1. Transport: WebSocket media stream, SIP RTP/session, AudioSocket TCP, or mixed.
  2. Inbound and outbound call requirements.
  3. 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

  1. ReceiveCall parses provider webhook payload into CallInfo.
  2. InboundCall returns provider-specific connect response.
  3. NewStreamer path handles media transport and codec conversion.
  4. StatusCallback and catch-all callback map provider events.
  5. 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>