{"__v":23,"_id":"543e9a81fd81651c008e4cdb","category":{"__v":21,"_id":"543bf3e22a30961a00b66eb3","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"},"is_link":false,"parentDoc":null,"project":"542dbe0ecb19820800c1f4d7","user":"542dc547cb19820800c1f4f1","version":{"__v":31,"_id":"542ecc0a6b0eb6080066ca77","forked_from":"542dbe0fcb19820800c1f4da","project":"542dbe0ecb19820800c1f4d7","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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-15T16:02:09.103Z","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":15,"body":"The `<Say>` element reads text to the caller using our text-to-speech engine. The current version of our `<Say>` element supports different options for voices, languages, and genders. \n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"voice\",\n    \"0-1\": \"The gender of the voice that will speak the text. Allowed values are \\\"man\\\" or \\\"woman\\\". The default value is \\\"woman\\\".\",\n    \"1-0\": \"language\",\n    \"1-1\": \"The language used to speak the text.\",\n    \"2-0\": \"loop\",\n    \"2-1\": \"The amount of times the text should be repeated. Allowed values are any integer greater than or equal to 0. \\\"0\\\" indicates an infinite loop.\",\n    \"3-0\": \"loop\",\n    \"3-1\": \"test\",\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Supported Languages v1\"\n}\n[/block]\nThe following languages values are currently supported. The default value is \"en\". \n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"en\",\n    \"0-1\": \"American English\",\n    \"1-0\": \"en-gb\",\n    \"1-1\": \"British English\",\n    \"2-0\": \"es\",\n    \"2-1\": \"Spanish\",\n    \"3-0\": \"fr\",\n    \"3-1\": \"French\",\n    \"4-0\": \"it\",\n    \"4-1\": \"Italian\",\n    \"5-0\": \"de\",\n    \"5-1\": \"German\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Supported Languages v2\"\n}\n[/block]\nThe following language values are currently in beta. Please email our support team at support:::at:::zang.io if you'd like to enable your account to support these languages.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Language Value\",\n    \"h-1\": \"Language Name\",\n    \"0-0\": \"cy-gb\",\n    \"1-0\": \"da-dk\",\n    \"2-0\": \"de-de\",\n    \"3-0\": \"en-au\",\n    \"4-0\": \"en-gb\",\n    \"5-0\": \"en-gb-wls\",\n    \"6-0\": \"en-in\",\n    \"7-0\": \"en-us\",\n    \"8-0\": \"es-es\",\n    \"9-0\": \"es-us\",\n    \"10-0\": \"fr-ca\",\n    \"11-0\": \"fr-fr\",\n    \"12-0\": \"is-is\",\n    \"13-0\": \"it-it\",\n    \"14-0\": \"ja-jp\",\n    \"15-0\": \"nb-no\",\n    \"16-0\": \"nl-nl\",\n    \"17-0\": \"pl-pl\",\n    \"18-0\": \"pt-br\",\n    \"19-0\": \"pt-pt\",\n    \"20-0\": \"ro-ro\",\n    \"21-0\": \"ru-ru\",\n    \"22-0\": \"sv-se\",\n    \"23-0\": \"tr-tr\",\n    \"0-1\": \"Welsh\",\n    \"1-1\": \"Danish\",\n    \"2-1\": \"German\",\n    \"3-1\": \"Australian English\",\n    \"4-1\": \"British English\",\n    \"5-1\": \"Welsh English\",\n    \"6-1\": \"Indian English\",\n    \"7-1\": \"US English\",\n    \"8-1\": \"Castilian Spanish\",\n    \"9-1\": \"US Spanish\",\n    \"10-1\": \"Canadian French\",\n    \"11-1\": \"French\",\n    \"12-1\": \"Icelandic\",\n    \"13-1\": \"Italian\",\n    \"14-1\": \"Japanese\",\n    \"15-1\": \"Norwegian\",\n    \"16-1\": \"Dutch\",\n    \"17-1\": \"Polish\",\n    \"18-1\": \"Brazilian Portuguese\",\n    \"19-1\": \"Portuguese\",\n    \"20-1\": \"Romanian\",\n    \"21-1\": \"Russian\",\n    \"22-1\": \"Swedish\",\n    \"23-1\": \"Turkish\"\n  },\n  \"cols\": 2,\n  \"rows\": 24\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Nesting\",\n  \"body\": \"In addition to the default `<Response>` element, `<Say>` can be nested within a `<Gather>`. Nothing can be nested inside `<Say>` except the text to be read to the caller.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"The maximum text size is 4kb. Commas and periods will cause pauses. may speak things such as abbreviations or times differently than you expect so be sure to double check for correct pronunciation.\",\n  \"title\": \"Text Size\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Example #1\"\n}\n[/block]\nThis InboundXML will repeat “Hello, my name is Michael.” in a man’s voice until the caller hangs up.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Response>\\n    <Say voice=\\\"man\\\" language=\\\"en\\\" loop=\\\"0\\\">Hello, my name is Michael.</Say>\\n</Response>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Example #2\"\n}\n[/block]\nThis InboundXML will repeat “Buenos dias, my nombre is Carolina.” in a woman's voice until the caller hangs up.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Response>\\n  <Say voice=\\\"woman\\\" language=\\\"es\\\" loop=\\\"0\\\">Buenos dias, my nombre is Carolina.</Say>\\n</Response>\\n       \",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"say","type":"basic","title":"<Say>"}
The `<Say>` element reads text to the caller using our text-to-speech engine. The current version of our `<Say>` element supports different options for voices, languages, and genders. [block:parameters] { "data": { "0-0": "voice", "0-1": "The gender of the voice that will speak the text. Allowed values are \"man\" or \"woman\". The default value is \"woman\".", "1-0": "language", "1-1": "The language used to speak the text.", "2-0": "loop", "2-1": "The amount of times the text should be repeated. Allowed values are any integer greater than or equal to 0. \"0\" indicates an infinite loop.", "3-0": "loop", "3-1": "test", "h-0": "Attribute", "h-1": "Description" }, "cols": 2, "rows": 3 } [/block] [block:api-header] { "title": "Supported Languages v1" } [/block] The following languages values are currently supported. The default value is "en". [block:parameters] { "data": { "0-0": "en", "0-1": "American English", "1-0": "en-gb", "1-1": "British English", "2-0": "es", "2-1": "Spanish", "3-0": "fr", "3-1": "French", "4-0": "it", "4-1": "Italian", "5-0": "de", "5-1": "German" }, "cols": 2, "rows": 6 } [/block] [block:api-header] { "title": "Supported Languages v2" } [/block] The following language values are currently in beta. Please email our support team at support@zang.io if you'd like to enable your account to support these languages. [block:parameters] { "data": { "h-0": "Language Value", "h-1": "Language Name", "0-0": "cy-gb", "1-0": "da-dk", "2-0": "de-de", "3-0": "en-au", "4-0": "en-gb", "5-0": "en-gb-wls", "6-0": "en-in", "7-0": "en-us", "8-0": "es-es", "9-0": "es-us", "10-0": "fr-ca", "11-0": "fr-fr", "12-0": "is-is", "13-0": "it-it", "14-0": "ja-jp", "15-0": "nb-no", "16-0": "nl-nl", "17-0": "pl-pl", "18-0": "pt-br", "19-0": "pt-pt", "20-0": "ro-ro", "21-0": "ru-ru", "22-0": "sv-se", "23-0": "tr-tr", "0-1": "Welsh", "1-1": "Danish", "2-1": "German", "3-1": "Australian English", "4-1": "British English", "5-1": "Welsh English", "6-1": "Indian English", "7-1": "US English", "8-1": "Castilian Spanish", "9-1": "US Spanish", "10-1": "Canadian French", "11-1": "French", "12-1": "Icelandic", "13-1": "Italian", "14-1": "Japanese", "15-1": "Norwegian", "16-1": "Dutch", "17-1": "Polish", "18-1": "Brazilian Portuguese", "19-1": "Portuguese", "20-1": "Romanian", "21-1": "Russian", "22-1": "Swedish", "23-1": "Turkish" }, "cols": 2, "rows": 24 } [/block] [block:callout] { "type": "info", "title": "Nesting", "body": "In addition to the default `<Response>` element, `<Say>` can be nested within a `<Gather>`. Nothing can be nested inside `<Say>` except the text to be read to the caller." } [/block] [block:callout] { "type": "warning", "body": "The maximum text size is 4kb. Commas and periods will cause pauses. may speak things such as abbreviations or times differently than you expect so be sure to double check for correct pronunciation.", "title": "Text Size" } [/block] [block:api-header] { "type": "basic", "title": "Example #1" } [/block] This InboundXML will repeat “Hello, my name is Michael.” in a man’s voice until the caller hangs up. [block:code] { "codes": [ { "code": "<Response>\n <Say voice=\"man\" language=\"en\" loop=\"0\">Hello, my name is Michael.</Say>\n</Response>", "language": "xml" } ] } [/block] [block:api-header] { "title": "Example #2" } [/block] This InboundXML will repeat “Buenos dias, my nombre is Carolina.” in a woman's voice until the caller hangs up. [block:code] { "codes": [ { "code": "<Response>\n <Say voice=\"woman\" language=\"es\" loop=\"0\">Buenos dias, my nombre is Carolina.</Say>\n</Response>\n ", "language": "xml" } ] } [/block]