{"id":6053,"date":"2026-02-13T15:16:54","date_gmt":"2026-02-13T14:16:54","guid":{"rendered":"https:\/\/help.ino.cx\/?post_type=ht_kb&#038;p=6053"},"modified":"2026-10-29T16:26:10","modified_gmt":"2026-10-29T15:26:10","slug":"sip-endpoints","status":"publish","type":"ht_kb","link":"https:\/\/help.ino.cx\/index.php\/help-center\/sip-endpoints\/","title":{"rendered":"SIP endpoints \u2013 Set them up"},"content":{"rendered":"\n<figure class=\"wp-block-image alignright size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"379\" src=\"https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-1-1024x379.png\" alt=\"\" class=\"wp-image-7114\" style=\"width:250px;height:auto\" srcset=\"https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-1-1024x379.png 1024w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-1-300x111.png 300w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-1-767x284.png 767w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-1-50x19.png 50w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-1-60x22.png 60w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-1-100x37.png 100w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-1.png 1080w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em>[Reading time: 5 minutes]<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>This article explains how to connect INO cx to an external telephony system or to an ElevenLabs voice agent with a SIP endpoint, and how to send calls to it from a voice smart routing. For the other actions of a voice smart routing, see&nbsp;<a href=\"https:\/\/help.ino.cx\/index.php\/help-center\/voice-smart-routing-actions\/\">Voice smart routing actions<\/a>.<\/em><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Overview<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A SIP endpoint is the address of a telephony system outside INO cx: your own telephony server, a dedicated SIP trunk, or an ElevenLabs voice agent. You create it once in the Maker, then send calls to it from a voice smart routing with the&nbsp;<strong>Distribution to SIP endpoint<\/strong>&nbsp;action.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The action can also send information about the call along with it, in&nbsp;<strong>custom SIP headers<\/strong>: for example the customer&#8217;s reference, so that the system that receives the call knows who is calling.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">There are two types of SIP endpoint:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">Endpoint type<\/th><th class=\"has-text-align-left\" data-align=\"left\">Use it for<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Generic<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Any telephony system: your own server, a SIP trunk, a private network. You enter every setting yourself.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>ElevenLabs<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">An ElevenLabs voice agent. INO cx prefills the recommended settings and enforces the ones ElevenLabs requires.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em><strong>Note:<\/strong>&nbsp;In most cases, the SIP trunks you need are set up with your platform. You only create a SIP endpoint to send calls to another system.<\/em><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">1.&nbsp;Prerequisites<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A&nbsp;<strong>Smart<\/strong>&nbsp;license.<\/li>\n\n\n\n<li>A role with the rights on&nbsp;<strong>SIP endpoints<\/strong>, and on&nbsp;<strong>Smart routing<\/strong>&nbsp;to use them in a smart routing.<\/li>\n\n\n\n<li>The connection details given by your telephony provider: address, transport, port, user name, password and, if needed, realm.<\/li>\n\n\n\n<li>For ElevenLabs: the user name and password set in the SIP trunk of your ElevenLabs phone number.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">2.&nbsp;The list of SIP endpoints<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">In the Maker, open the&nbsp;<strong>SIP endpoints<\/strong>&nbsp;module. The list shows, for each endpoint:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>SIP endpoint<\/strong>: the address of the server<\/li>\n\n\n\n<li><strong>Endpoint type<\/strong>:&nbsp;<strong>Generic<\/strong>&nbsp;or&nbsp;<strong>ElevenLabs<\/strong><\/li>\n\n\n\n<li><strong>Transport<\/strong>: UDP, TCP or TLS<\/li>\n\n\n\n<li><strong>Port<\/strong><\/li>\n\n\n\n<li><strong>Reference<\/strong><\/li>\n\n\n\n<li><strong>Codec<\/strong><\/li>\n\n\n\n<li><strong>User name<\/strong><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">On each row, the pencil edits the endpoint, the bin deletes it, and the gear menu offers&nbsp;<strong>Duplicate<\/strong>&nbsp;and&nbsp;<strong>History<\/strong>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">3.&nbsp;Creating a SIP endpoint<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click&nbsp;<strong>Create<\/strong>.<\/li>\n\n\n\n<li>Choose the&nbsp;<strong>Endpoint type<\/strong>:&nbsp;<strong>Generic<\/strong>&nbsp;or&nbsp;<strong>ElevenLabs<\/strong>.<\/li>\n\n\n\n<li>Fill in the fields described below.<\/li>\n\n\n\n<li>Click&nbsp;<strong>Add SIP endpoint<\/strong>.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">Field<\/th><th class=\"has-text-align-left\" data-align=\"left\">What to enter<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>SIP endpoint<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">The address of the telephony server: a domain name or an IP address.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Transport<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\"><strong>UDP<\/strong>,&nbsp;<strong>TCP<\/strong>&nbsp;or&nbsp;<strong>TLS<\/strong>, as required by your provider. TLS encrypts the call signaling.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Port<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Prefilled according to the transport:&nbsp;<strong>5060<\/strong>&nbsp;in UDP and TCP,&nbsp;<strong>5061<\/strong>&nbsp;in TLS. Change it only if your provider asks you to.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Audio encryption<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\"><strong>Not encrypted (RTP)<\/strong>&nbsp;or&nbsp;<strong>Encrypted (SRTP)<\/strong>. Encrypted (SRTP) is only available with TLS.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Reference<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">A unique name to recognize the endpoint, for example in smart routings.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Codec<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">The audio format:&nbsp;<strong>alaw<\/strong>,&nbsp;<strong>ulaw<\/strong>&nbsp;or&nbsp;<strong>alaw,ulaw<\/strong>&nbsp;(the default). It must be supported by your provider.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>User name<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">The user name given by your provider, 6 to 20 characters.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Password<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">The password given by your provider, 30 characters maximum.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Realm<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Only if your provider asks for it.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">A few rules on the port and the encryption:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>In TLS, port 5060 is not allowed. Another port than 5061 is allowed, with a warning, because it is not the standard TLS port.<\/li>\n\n\n\n<li>Audio encryption must match your provider&#8217;s setting. If your provider requires encryption, choose&nbsp;<strong>TLS<\/strong>&nbsp;and&nbsp;<strong>Encrypted (SRTP)<\/strong>, otherwise calls fail.<\/li>\n\n\n\n<li>If you switch from TLS to UDP or TCP, the audio encryption goes back to&nbsp;<strong>Not encrypted (RTP)<\/strong>.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">4.&nbsp;Connecting an ElevenLabs voice agent<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">With the&nbsp;<strong>ElevenLabs<\/strong>&nbsp;type, INO cx shows the&nbsp;<strong>Predefined ElevenLabs configuration<\/strong>&nbsp;box and sets up the endpoint for you:<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"483\" height=\"957\" src=\"https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-2.png\" alt=\"\" class=\"wp-image-7115\" srcset=\"https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-2.png 483w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-2-25x50.png 25w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-2-30x60.png 30w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-2-151x300.png 151w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-2-50x100.png 50w\" sizes=\"auto, (max-width: 483px) 100vw, 483px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>SIP endpoint<\/strong>&nbsp;and&nbsp;<strong>Realm<\/strong>&nbsp;are prefilled with the ElevenLabs values, if they are empty. You can change them, for example for an ElevenLabs server with a static IP address.<\/li>\n\n\n\n<li><strong>UDP<\/strong>&nbsp;is not available: choose&nbsp;<strong>TLS<\/strong>&nbsp;(port 5061) or&nbsp;<strong>TCP<\/strong>&nbsp;(port 5060). The port follows the transport and cannot be changed.<\/li>\n\n\n\n<li>In TLS,&nbsp;<strong>Encrypted (SRTP)<\/strong>&nbsp;is selected by default. You can change it.<\/li>\n\n\n\n<li>The codec is set to&nbsp;<strong>alaw,ulaw<\/strong>&nbsp;and cannot be changed.<\/li>\n\n\n\n<li><strong>Realm<\/strong>&nbsp;is required.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Enter in&nbsp;<strong>User name<\/strong>&nbsp;and&nbsp;<strong>Password<\/strong>&nbsp;the credentials set in the SIP trunk of your ElevenLabs phone number.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The audio encryption must be compatible with the&nbsp;<strong>Media encryption<\/strong>&nbsp;setting of your ElevenLabs SIP trunk:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">In INO cx<\/th><th class=\"has-text-align-left\" data-align=\"left\">In ElevenLabs<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Encrypted (SRTP)<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\"><strong>Allowed<\/strong>&nbsp;or&nbsp;<strong>Required<\/strong><\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Not encrypted (RTP)<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\"><strong>Allowed<\/strong>&nbsp;or&nbsp;<strong>Disabled<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em><strong>Warning:<\/strong>&nbsp;If ElevenLabs is set to&nbsp;<strong>Required<\/strong>, the TCP transport cannot be used: calls fail. Choose TLS and Encrypted (SRTP).<\/em><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">5.&nbsp;Sending calls to a SIP endpoint from a smart routing<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open your voice smart routing, in a development version.<\/li>\n\n\n\n<li>Add the&nbsp;<strong>Distribution to SIP endpoint<\/strong>&nbsp;action.<\/li>\n\n\n\n<li>Select the&nbsp;<strong>SIP endpoint<\/strong>&nbsp;in the list. Each endpoint shows its reference, then its address and port, for example&nbsp;<code>ELEVENLABS_FR (sip.rtc.elevenlabs.io:5061)<\/code>.<\/li>\n\n\n\n<li>Enter the&nbsp;<strong>Phone number<\/strong>&nbsp;to call on the SIP endpoint: a number in international format, or a variable.<\/li>\n\n\n\n<li>If needed, add&nbsp;<strong>Custom SIP headers<\/strong>&nbsp;(see below).<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"288\" height=\"851\" src=\"https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image.png\" alt=\"\" class=\"wp-image-7113\" srcset=\"https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image.png 288w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-17x50.png 17w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-20x60.png 20w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-34x100.png 34w, https:\/\/help.ino.cx\/wp-content\/uploads\/2026\/02\/image-102x300.png 102w\" sizes=\"auto, (max-width: 288px) 100vw, 288px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em><strong>Note:<\/strong>&nbsp;An action that identified the SIP endpoint by its code opens without a SIP endpoint: select one in the list before saving.<\/em><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">5.1.&nbsp;Custom SIP headers<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">A custom SIP header sends a piece of information to the SIP endpoint along with the call. Click&nbsp;<strong>Add a SIP header<\/strong>, then fill in:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>SIP header<\/strong>: the name of the header, for example&nbsp;<code>X-Customer-Id<\/code>. Agree on it with the system that receives the call.<\/li>\n\n\n\n<li><strong>Header value<\/strong>: a fixed text, magic variables, or both. For example, a variable holding the customer reference collected earlier in the smart routing.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">You can add up to&nbsp;<strong>3<\/strong>&nbsp;custom headers. With an ElevenLabs endpoint, INO cx adds the&nbsp;<strong>X-Call-ID<\/strong>&nbsp;header on its own, with the ID of the interaction: it is shown first and cannot be changed, and&nbsp;<strong>2<\/strong>&nbsp;custom headers remain available. ElevenLabs can use this ID to link the conversation to the INO cx interaction.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The rules, also listed in the&nbsp;<strong>Custom SIP headers limitations<\/strong>&nbsp;window (link in the yellow box):<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Name<\/strong>: starts with&nbsp;<code>X-<\/code>, then only letters, digits and hyphens, with no hyphen at the end, 32 characters maximum. Some prefixes are reserved. Two headers cannot have the same name.<\/li>\n\n\n\n<li><strong>Value<\/strong>: 64 characters maximum, letters, digits, accents, spaces, hyphens and underscores. No punctuation, no line break.<\/li>\n\n\n\n<li>Keep the values short: identifiers or numbers rather than long texts. If your headers are large, prefer the TCP or TLS transport.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">5.2.&nbsp;When a value is not valid during a call<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The rules on the value are checked again during the call, once the variables are replaced. An invalid value does not block the call: the SIP endpoint is still called, and the header is sent with an error code instead of its value.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">Error code<\/th><th class=\"has-text-align-left\" data-align=\"left\">Cause<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\"><code>ERR_PAYLOAD_EMPTY<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\">The value is empty, for example a variable with no value for this call.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><code>ERR_PAYLOAD_LENGTH<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\">The value is longer than 64 characters.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><code>ERR_PAYLOAD_FORMAT<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\">The value contains forbidden characters, such as punctuation or a line break.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">6.&nbsp;Managing SIP endpoints<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Editing<\/strong>: calls use the new settings as soon as you save, including a new address or port.<\/li>\n\n\n\n<li><strong>Changing the type<\/strong>: if a Generic endpoint with 3 custom headers in an action becomes ElevenLabs, the third header shows a red&nbsp;<strong>Not sent<\/strong>&nbsp;box. It is no longer sent, and the action cannot be saved until you delete one header.<\/li>\n\n\n\n<li><strong>Deleting<\/strong>: a SIP endpoint used by a smart routing action cannot be deleted, even if only an inactive version of the smart routing uses it. Remove it from the smart routings first.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>[Reading time: 5 minutes] This article explains how to connect INO cx to an external telephony system or to an ElevenLabs voice agent with a SIP endpoint, and how to send calls to it from a voice smart routing. For the other actions of a voice smart routing, see&nbsp;Voice smart&#8230;<\/p>\n","protected":false},"author":5,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[107],"ht-kb-tag":[],"class_list":["post-6053","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-configuring"],"_links":{"self":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/6053","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/comments?post=6053"}],"version-history":[{"count":4,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/6053\/revisions"}],"predecessor-version":[{"id":7118,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/6053\/revisions\/7118"}],"wp:attachment":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/media?parent=6053"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=6053"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=6053"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}