Skip to content

frejun-tech/teler-vapi-node-bridge

Repository files navigation

Teler-Vapi-Node-Bridge

A reference Node integration between Teler and VAPI in Node, based on Media Streaming Bridge over WebSockets.

What is Teler?

Teler is a programmable voice API by FreJun. It handles carriers, phone numbers, and real-time audio streaming so you can connect AI models directly to phone calls. → frejun.ai

Setup

  1. Clone and configure:

    git clone https://github.com/frejun-tech/teler-vapi-node-bridge.git
    cd teler-vapi-node-bridge
    cp .env.example .env
    # Edit .env with your actual values
  2. Run with Docker:

    docker compose up -d --build

Environment Variables

Variable Description Default
VAPI_ASSISTANT_ID Your VAPI assistant ID Required
VAPI_API_KEY Your VAPI API key Required
VAPI_SAMPLE_RATE Audio sample rate of VAPI 8000
VAPI_MESSAGE_BUFFER_SIZE Messages to buffer before relay 50
TELER_API_KEY Your Teler API key Required
TELER_SAMPLE_RATE Audio sample rate of Teler 8k
TELER_CHUNK_SIZE Chunk size of Teler audio 500
NGROK_AUTHTOKEN Your ngrok auth token Required

API Endpoints

  • GET / - Health check with server domain
  • GET /health - Service status
  • GET /ngrok-status - Current ngrok status and URL
  • POST /api/v1/calls/initiate-call - Start a new call with dynamic phone numbers
  • POST /api/v1/calls/flow - Get call flow configuration
  • WebSocket /api/v1/calls/media-stream - Audio streaming
  • POST /api/v1/webhooks/receiver - Teler webhook receiver

Call Initiation Example

curl -X POST "https://your_ngrok_domain/api/v1/calls/initiate-call" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+918064xxx",
    "to_number": "+919967xxx"
  }'

Features

  • Bi-directional media streaming - Bridges audio between Teler and Vapi (Voice API) over WebSockets.
  • Real-time audio handling - Receives live audio chunks from Teler, processes them, and forwards to Vapi; streams responses back to Teler.
  • Dockerized setup - Comes with Dockerfile and docker-compose.yaml for easy local development and deployment.
  • Dynamic ngrok URL detection - Automatically detects current ngrok domain

About

Reference Node integration for Teler and VAPI using WebSocket-based media streaming.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors