{"_id":"542ecc0a6b0eb6080066ca79","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"},"__v":53,"is_link":false,"parentDoc":null,"project":"542dbe0ecb19820800c1f4d7","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"},"user":"542dbdddcb19820800c1f4d6","updates":["577c19d25fd4de0e00cc3b85","57a8a59c2ad1150e009daaf1","582f2f67f5d0123900c326c3","5830926d6f9ee60f0062f334"],"next":{"pages":[],"description":""},"createdAt":"2014-10-02T21:05:19.081Z","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":0,"body":"Zang Cloud is a robust development platform — create what you need, integrate it seamlessly with your current communications systems and go! Getting started with Zang Cloud is easy. The first thing you need to do is [Sign Up](https://www.zang.io/signup) for an account. A trial account comes with complimentary credit to help you get started with the platform and with building/testing your initial application. Developing on the Zang platform is actually free and you're only charged on a per-usage basis. Once you have experimented or tested your use case, you can upgrade to a production account by clicking on the *Request Production Access* button found in the Dashboard of your account. This will unlock the trial account restrictions and also allow you to add funds to your account.\n[block:api-header]\n{\n  \"title\": \"Getting Started with InboundXML\"\n}\n[/block]\nInboundXML describes how Zang should handle a call and SMS. It's basically instructions that tell Zang what to do when you receive an inbound call or SMS. Hence the name InboundXML! Upon receiving a call or SMS, Zang follows the InboundXML instructions, enabling developers to easily build telephony apps with all the same function and power found in traditional phone systems.\n\nOnce you have created your account, you'll want to head right over to Numbers > Buy A Phone Number to purchase a phone number. Feel free to purchase any of the pre-populated numbers or search for a number by area code. Once you have purchased a number, you will be automatically routed to the settings for that number.\n\nEvery number purchased on the Zang platform will have a Voice Request URL and SMS Request URL assigned by default. The URL's are as follows:\n\nVoice Request URL: `http://www.zang.io/ivr/welcome/call`\nSMS Request URL: `http://www.zang.io/ivr/welcome/sms`\n\nLet's go ahead and place a call to your newly purchased Zang number. The result will be a short say message:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Response>\\n\\t<Say>Welcome to your new Zang Account.</Say>\\n\\t<Say voice=\\\"woman\\\">Let us know if we can help you in any way during your development.</Say>\\n</Response>\",\n      \"language\": \"xml\",\n      \"name\": null\n    }\n  ]\n}\n[/block]\nNow let's go ahead and send an SMS to your newly purchased Zang number from an SMS-capable number, preferably your mobile phone. The result will be an outbound-reply from Zang:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Response>\\n\\t<Sms>Welcome to Zang! Let us know if we can help you in any way during your development.</Sms>\\n</Response>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\nThat's all there is to it! Please check out the rest of the documentation and feel free to experiment. If you run into any issues, feel free to contact our support team: support:::at:::zang.io.","excerpt":"","slug":"getting-started","type":"basic","title":"Overview"}
Zang Cloud is a robust development platform — create what you need, integrate it seamlessly with your current communications systems and go! Getting started with Zang Cloud is easy. The first thing you need to do is [Sign Up](https://www.zang.io/signup) for an account. A trial account comes with complimentary credit to help you get started with the platform and with building/testing your initial application. Developing on the Zang platform is actually free and you're only charged on a per-usage basis. Once you have experimented or tested your use case, you can upgrade to a production account by clicking on the *Request Production Access* button found in the Dashboard of your account. This will unlock the trial account restrictions and also allow you to add funds to your account. [block:api-header] { "title": "Getting Started with InboundXML" } [/block] InboundXML describes how Zang should handle a call and SMS. It's basically instructions that tell Zang what to do when you receive an inbound call or SMS. Hence the name InboundXML! Upon receiving a call or SMS, Zang follows the InboundXML instructions, enabling developers to easily build telephony apps with all the same function and power found in traditional phone systems. Once you have created your account, you'll want to head right over to Numbers > Buy A Phone Number to purchase a phone number. Feel free to purchase any of the pre-populated numbers or search for a number by area code. Once you have purchased a number, you will be automatically routed to the settings for that number. Every number purchased on the Zang platform will have a Voice Request URL and SMS Request URL assigned by default. The URL's are as follows: Voice Request URL: `http://www.zang.io/ivr/welcome/call` SMS Request URL: `http://www.zang.io/ivr/welcome/sms` Let's go ahead and place a call to your newly purchased Zang number. The result will be a short say message: [block:code] { "codes": [ { "code": "<Response>\n\t<Say>Welcome to your new Zang Account.</Say>\n\t<Say voice=\"woman\">Let us know if we can help you in any way during your development.</Say>\n</Response>", "language": "xml", "name": null } ] } [/block] Now let's go ahead and send an SMS to your newly purchased Zang number from an SMS-capable number, preferably your mobile phone. The result will be an outbound-reply from Zang: [block:code] { "codes": [ { "code": "<Response>\n\t<Sms>Welcome to Zang! Let us know if we can help you in any way during your development.</Sms>\n</Response>", "language": "xml" } ] } [/block] That's all there is to it! Please check out the rest of the documentation and feel free to experiment. If you run into any issues, feel free to contact our support team: support@zang.io.