​
Overview

Millis provides seamless integration for connecting your phone system to its AI-powered voice agents using SIP. This guide walks you through the process of rerouting phone calls to Millis via SIP.

​
Step-by-Step Process

​
1. Make a POST Request to /register_sip_call

To initiate a call, send a POST request to the /register_sip_call API endpoint. Depending on your location, select either the EU-West or US-West region for lower latency:
  • EU-West: https://api-eu-west.millis.ai/register_sip_call
  • US-West: https://api-west.millis.ai/register_sip_call

​
Request Body

You must include the necessary parameters in your request body, with the option to customize agent behavior and include metadata if needed. Request Body Example: 
{
  "agent_id": "your_agent_id",
  "agent_config": {
    config options for the agent
  },
  "metadata": {
    "key": "value"
  },
  "include_metadata_in_prompt": true
}
Field Details:
  • agent_id: (Optional) The ID of the Millis AI agent that will handle the call.
  • agent_config: (Optional) Configuration options for the agent, allowing you to customize behavior.
    • If both agent_id and agent_config are provided, the parameters in agent_config will override the original parameters for the agent tied to agent_id.
    • You can also provide just agent_config for a temporary configuration, which will be used to construct an agent to handle the call.
  • metadata: (Optional) Any additional information to attach to the session, giving the agent context to enhance its response. To learn more about how metadata works, visit the Metadata Guide.
  • include_metadata_in_prompt: (Optional) Boolean value indicating if the metadata should be included in the agent’s conversational prompt.

​
2. Receive the SIP URI

After making the POST request, you will receive a response containing a call_id and a sip_uri. This sip_uri is the address you will use to route your phone calls to Millis. Response Example: 
{
  "call_id": "unique_call_id",
  "sip": "sip:call-uniqueid@<millis-sip-server>"
}

​
3. Reroute Your Call

Use the provided sip_uri to reroute the call from your phone system to Millis. Your phone system will forward the call audio to Millis, where the voice agent can interact with the caller.