{"_id":"544e5303b80812080035be44","__v":7,"parentDoc":null,"project":"542dbe0ecb19820800c1f4d7","category":{"_id":"543bf3e22a30961a00b66eb3","__v":21,"pages":["5489d5e61ea5330b007b5a51","5489e243d8dec60b00034297","5489e318aefb240b00d197ef","56cdf622e538330b0021ab5a"],"project":"542dbe0ecb19820800c1f4d7","version":"542ecc0a6b0eb6080066ca77","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-13T15:46:42.097Z","from_sync":false,"order":0,"slug":"inboundxml","title":"InboundXML"},"user":"544a586d27b7fc140078db12","version":{"_id":"542ecc0a6b0eb6080066ca77","forked_from":"542dbe0fcb19820800c1f4da","project":"542dbe0ecb19820800c1f4d7","__v":31,"createdAt":"2014-10-03T16:17:14.165Z","releaseDate":"2014-10-03T16:17:14.165Z","categories":["542ecc0a6b0eb6080066ca78","542ef44f6b0eb6080066cb24","543bf3e22a30961a00b66eb3","5446952b82bd7e08002768a0","544821ae8d7af31a00dd41ce","544a7885f1aefa08006efc69","544c758e11845f0e001ed8de","544e5565b80812080035be55","544e558dbd51b9080037f8ca","5450b045a66f020800dba73d","5450eb6aa66f020800dba945","5450f39ea66f020800dba989","5450f877a66f020800dba9cf","54510356a66f020800dbaa17","5451274514af501a00b50c99","54513345a66f020800dbab24","54513cc014af501a00b50d24","54515eec14af501a00b50db9","54519b1d14af501a00b50ea9","54519b2aa66f020800dbacb4","54524f9704160008005b1d27","54538d2308d1800800473d95","54538d420c09721000a06a03","54538e5608d1800800473d9a","5453ea9547c30114004fb375","5453eb12b077c31c00067bcb","5453eb27b077c31c00067bcd","5453ed5db077c31c00067bde","548075cbe291c51a00e7e096","5922fa475c48c70f00f21453","59244fd41e32eb190028ad8d"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"is_link":false,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-27T14:13:23.150Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":false,"results":{"codes":[]},"settings":"","try":true,"auth":"never","params":[],"url":""},"isReference":false,"order":18,"body":"The `<Sip>` element is nested within the `<Dial>` element, and is used to call SIP addresses. The desired SIP address to call is nested within `<Sip>` `</Sip>`, just as with a number when using the `<Number>` element. However, the opening and closing sip tags (`<Sip>` `</Sip>`) may be omitted completely by simply prefixing the desired SIP address with “sip:” when using it within the `<Dial>` element. For example: `<Dial>sip:username:::at:::domain.com<Dial>`\n\nIf multiple `<Sip>` elements are used, the first call to answer is connected and the rest of the outgoing calls are canceled.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"username\",\n    \"0-1\": \"If provided, will be passed along as sip authentication username.\",\n    \"1-0\": \"password\",\n    \"1-1\": \"If provided, will be passed along as sip authentication password.\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Nesting\",\n  \"body\": \"In addition to the default `<Response>` element, the `<Sip>` element must be nested within the `<Dial>` verb. The `<Sip>` element cannot nest any other elements within itself. It must only nest the SIP address which is to be called.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Examples\"\n}\n[/block]\nThe InboundXML below will call the nested SIP account.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Response>\\n <Dial>\\n  <Sip username=\\\"{someusername}\\\" password=\\\"{somepassword}\\\">[email protected]</Sip>\\n </Dial>\\n</Response>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"sip","type":"basic","title":"<Sip>"}
The `<Sip>` element is nested within the `<Dial>` element, and is used to call SIP addresses. The desired SIP address to call is nested within `<Sip>` `</Sip>`, just as with a number when using the `<Number>` element. However, the opening and closing sip tags (`<Sip>` `</Sip>`) may be omitted completely by simply prefixing the desired SIP address with “sip:” when using it within the `<Dial>` element. For example: `<Dial>sip:[email protected]<Dial>` If multiple `<Sip>` elements are used, the first call to answer is connected and the rest of the outgoing calls are canceled. [block:parameters] { "data": { "h-0": "Attribute", "h-1": "Description", "0-0": "username", "0-1": "If provided, will be passed along as sip authentication username.", "1-0": "password", "1-1": "If provided, will be passed along as sip authentication password." }, "cols": 2, "rows": 2 } [/block] [block:callout] { "type": "info", "title": "Nesting", "body": "In addition to the default `<Response>` element, the `<Sip>` element must be nested within the `<Dial>` verb. The `<Sip>` element cannot nest any other elements within itself. It must only nest the SIP address which is to be called." } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] The InboundXML below will call the nested SIP account. [block:code] { "codes": [ { "code": "<Response>\n <Dial>\n <Sip username=\"{someusername}\" password=\"{somepassword}\">[email protected]</Sip>\n </Dial>\n</Response>", "language": "xml" } ] } [/block]