1. Epicode Onboarding Guide
Epicode docs
  • IraVoice API
    • IraVoice API (2.0.0)
    • makecall (Make outbound call)
      • Make Call
    • makecalldirect
      • Make Call Direct
    • dropcall
      • Drop Call
    • stopstream
      • Stop Stream
    • bridgecalls
      • Bridge Calls
    • transfercall
      • Transfer Call
    • Schemas
      • BridgeCalls
      • DropCall
      • HTTPValidationError
      • MakeCall
      • MakeCallDirect
      • StopStream
      • TransferCall
      • ValidationError
  • Epicode Onboarding Guide
    • 📞 IraVoice Onboarding Guide
    • Sandbox Environment
    • Get started with BotCompose
  1. Epicode Onboarding Guide

Get started with BotCompose

BotCompose is a VoiceBot orchestration engine designed to integrate seamlessly with existing PBX, UC, and Contact Center platforms. It replaces rigid IVR flows with natural conversational AI while staying flexible, performant, and vendor-agnostic across STT, TTS, and LLM components.
Base URL: https://sandboxwa.epicode.in/api/
To begin using botcompose from our sandbox environment, you will be provided with below details over the mail:
tenant_id
API credentials (Bearer token:xyz)
These credentials should be used exclusively for testing purposes.

Steps to create a voice bot using BotCompose:#

1.
Add Provider Secrets [/add_secret]: Add the STT, TTS, and LLM credentials of the model providers you have procured. 
2.
Create the Voicebot [/add_bot]: Configure and create your voicebot using the required parameters. 
Botcompose API documentation is available on : BotCompose API doc
The  API documentation contains the API requests for a sample voicebot; you can retain or modify these according to your use case.

Testing the Voicebot:#

Once your voicebot is created and configured, you can validate its performance using an IraVoice outbound call.
The outbound call will directly connect to the voicebot you’ve built, allowing end-to-end functional testing.
You will be provided with below details over the mail:
tenant_id
API credentials (Bearer token:xyz)
campaign_name
from_number
Sample CURL request for initiating a MakeCall using a BotCompose-configured voice bot 
1.
MakeCall API documentation is available on https://ld.epicode.in/documentation
2.
API request endpoint for integration testing : https://sandboxld.epicode.in/api/makecall 
3.
For more details on Make Call request parameters: https://support.epicode.in/help/en-gb/15/272
4.
In this Sandbox environment, you have access to 2 channels with a DID number.
5.
To connect to the newly created voicebot, you must specify the following within call_params:   
6.
Include "bot_id" : "<unique-name-of-your-voicebot->" which was created using BotCompose APIs
7.
Remove the fields websocket_host, websocket_port and websocket_app and use  "call_type":"botcompose" field instead.
8.
Set "streaming_useraudio": false if you are using Non-streaming STT.
9.
Should you require access to CDR transcripts from BotCompose, Call Recordings, or the Live Call Monitor, please let us know.

Frequently asked questions#

For common doubts and queries with BotCompose please refer to BotCompose FAQ's.
Epicode Support📞 +91 8203542261
📧support@epicode.in
Modified at 2026-05-14 05:38:55
Previous
Sandbox Environment
Built with