- name
- telephony-integration
- description
- Add or modify telephony providers in assistant-api with transport-aware streamer/webhook implementations, factory wiring, and codec/resampling compatibility.
# Telephony Integration Skill
## Mission
Integrate telephony providers safely across webhook payloads, media streams, callbacks, and cleanup paths.
## Inputs expected from user
1. Transport type: WebSocket, SIP, AudioSocket, or mixed.
2. Inbound/outbound requirements.
3. Codec and sample-rate constraints.
If missing:
- Use nearest baseline (`twilio`, `exotel`, `vonage`, `asterisk`, `sip`).
- Preserve internal LINEAR16 16k and base resampler usage.
## Hard boundaries
In scope:
- `api/assistant-api/internal/channel/telephony/internal/<provider>/...`
- `api/assistant-api/internal/channel/telephony/telephony.go`
- optional: `inbound.go`, `outbound.go`, `type/telephony.go`, `type/streamer.go`
- UI telephony registry/component wiring
Out of scope:
- STT/TTS provider internals
- EOS/VAD internals
- integration-api LLM caller logic
## Runtime flow checklist
1. `ReceiveCall` maps webhook payload to `CallInfo`.
2. `InboundCall` returns provider connect handshake.
3. Streamer `Recv/Send` handles codec and buffer lifecycle.
4. `StatusCallback` maps provider events.
5. Disconnect and directive paths cleanly terminate sessions.
## 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`
- `./skills/telephony-integration/scripts/validate.sh --check-diff --provider <provider>`
## References
- `references/checklist.md`
- `references/telephony-provider-checklist.md`
- `examples/sample.md`
GitHubで見る