Telephony (VoIP)

Connect Twilio, Ringostat, or Binotel for AI-powered phone calls

Supported Providers

Provider	Inbound Calls	Outbound Calls	SMS	Webhook Auto-Setup
Twilio	Yes	Yes	Yes	Automatic
Ringostat	Yes	Yes	No	Manual
Binotel	Yes	Yes	No	Manual

Setup

Twilio

Credentials

You need two values from the Twilio Console:

Field	Where to find
Account SID	Dashboard → Account Info
Auth Token	Dashboard → Account Info

Steps

1. Add Integration

   Go to Integrations → Add Integration → select Twilio from the Telephony category.

2. Enter Credentials

   Choose a company, give the integration a name (e.g., “Main Phone Line”), and enter your Account SID and Auth Token.

3. Verify & Select Number

   Click Test Connection. Revol fetches your available phone numbers. Select the number to use.

4. Save

   Revol automatically configures the webhook URL on the selected Twilio number. Incoming calls and SMS are routed to your agent.

Twilio webhook URLs are configured automatically. You don’t need to set anything in the Twilio Console.

Ringostat

Credentials

Field	Where to find
API Key (Auth-key)	Ringostat Dashboard → API Settings
Project ID	Ringostat Dashboard → Project Settings

Steps

1. Add Integration

   Go to Integrations → Add Integration → select Ringostat.

2. Enter Credentials

   Enter your API Key and Project ID.

3. Verify

   Revol fetches your SIP accounts to confirm the connection.

4. Configure Webhook

   In the Ringostat dashboard, set the webhook URL displayed in Revol after verification.

Binotel

Credentials

Field	Where to find
API Key	Binotel Dashboard → Settings → API
API Secret	Binotel Dashboard → Settings → API

Steps

1. Add Integration

   Go to Integrations → Add Integration → select Binotel.

2. Enter Credentials

   Enter your API Key and API Secret.

3. Verify

   Revol fetches your internal phone numbers to confirm the connection.

4. Configure Webhook

   In the Binotel dashboard, set the webhook URL displayed in Revol after verification.

Binotel webhooks are validated by IP allowlist. Only requests from Binotel’s servers are accepted in production.

Agent Tools

After connecting a VoIP provider, the following tools are automatically provisioned:

Tool	Twilio	Ringostat	Binotel	Description
make_call	Yes	Yes	Yes	Initiate an outbound call with optional greeting message
send_sms	Yes	—	—	Send an SMS message (auto-selects sender number)
get_call_history	Yes	Yes	Yes	Retrieve recent call logs with filters (phone, status, date range)

These tools become available in the agent’s Tools tab and can be added to workflow nodes.

Voice Call Flow

When an incoming call arrives, Revol processes it through the assigned agent’s workflow:

1. Incoming Call

   VoIP provider sends a webhook notification to Revol with caller information.

2. Greeting

   Revol generates an audio greeting using Text-to-Speech (configurable voice and language) and plays it to the caller.

3. Speech-to-Text

   Caller’s speech is captured and transcribed using Whisper or Google STT.

4. AI Processing

   Transcribed text is sent to the agent’s workflow. The agent processes it through LLM nodes, knowledge base lookups, and tool calls.

5. Text-to-Speech

   Agent’s text response is converted to audio using OpenAI TTS with configurable voice and speed.

6. Response

   Audio is played back to the caller. The conversation continues in a loop until the call ends.

Using Tools in Workflow Nodes

To make your agent use VoIP tools during conversations:

1. Go to the agent’s Workflow tab
2. Create or select a custom node (LLM-powered)
3. In the node settings, enable the VoIP tools (e.g., make_call, get_call_history)
4. The LLM will automatically decide when to call these tools based on the conversation context

For example, if a customer asks “Can you call me back at [phone]?”, the agent will use the make_call tool to initiate an outbound call.

Webhook Security

Provider	Validation Method
Twilio	HMAC-SHA1 signature verification (X-Twilio-Signature header)
Ringostat	Structural parameter validation
Binotel	IP allowlist (Binotel server IPs only in production)

All VoIP webhooks are rate-limited to 120 requests per minute per channel.