{"__v":22,"_id":"551be4e3a0ee622b0087f69e","category":{"__v":65,"_id":"551546edbc466623002afe72","pages":["551549c0bc466623002afe76","55154afbc859ac2f0001b486","55154daec859ac2f0001b48b","55154f36bc466623002afe7c","551550c5e68daa2f00cff84c","551551d4f854a31900368737","551552e7c859ac2f0001b494","551be4e3a0ee622b0087f69e","5527acc447b71d0d0044e6cd","552f84ad633a5b0d00e99daf","5537533df162750d00bbf7d0","554b3ffd6b448d0d00646d79","55506416fa289c0d0075e4f0","5550aaea00420e0d00d13113","55545865b450630d00041d80","55546906f9a7871700ef8e3c","555c4bf87e271d0d00f3c8c4","5564318c1fa8002300ea4bb0","556ffbd5910c090d00c432b6","557019f4cc189a21001ab258","55703aefcc189a21001ab2a3","5575a3c60b81dc230069c910","558ab69575eaf50d004e4cf3","55b0b41fb3171b3700b1539a","55ba2e48d72d1e1900276ac1","55ba45c804775a2f00628101","55c0b789344dc40d00f55933","55c0b8c837298d0d00088d88","55c0c095344dc40d00f55960","55d43e05b49ab11900328e2e","55d72c8c60fc730d00fc2738","55e6c564d678ad17001589ac","55e9b7780c9b420d0042b275","55f7cf2de32e9b0d00a2d4b6","56094efea7b2590d0089eb95","5613cdbeecbebc21003fa179","5613d8de6a092921004c30b8","5613de7c443514170060dbb6","5613e02823ecf6350009eefc","5613e4271db46e2100e142ad","5614d73c8113d20d00082e3e","561e11ae50e0a62100955946","561e2008efcf8217003adf77","5620f184b244890d001868e0","5620feb740e2c30d0002a899","562105ce40e2c30d0002a8a3","56210b3340e2c30d0002a8b3","56210c74b244890d0018690e","56249a0372ac510d00e49149","56249df185a31117001c53de","56249f0c85a31117001c53e1","5624a9e7c4bf501700bc5ec8","5624b29806e8040d005ed6a0","562507435a86b42300946324","563877854bfb360d00a463c1","5639e0f91846790d0089529a","565327d17d29410d004a0835","565457df04feff210074b17d","56545821ec189235002967af","565485099c4c6d0d00aeda02","5666f1f1f672550d000851ad","566abc7b74d574170070b700","566ad3c7c7c3cd1700265d14","566aede7b5ccc20d00817f71","566aef3147ebaf1900fe65d6"],"project":"54eb50e5615ffc1900305a16","version":"54eb63b859b1172100334fae","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-03-27T12:02:53.314Z","from_sync":false,"order":9,"slug":"advanced-tutorials","title":"Advanced tutorials"},"parentDoc":null,"project":"54eb50e5615ffc1900305a16","user":"54eb4fdedf7add210007b29b","version":{"__v":18,"_id":"54eb63b859b1172100334fae","forked_from":"54eb63a1867e1917009b711d","project":"54eb50e5615ffc1900305a16","createdAt":"2015-02-23T17:30:32.501Z","releaseDate":"2015-02-23T17:30:32.501Z","categories":["54eb63b959b1172100334faf","54eb63b959b1172100334fb0","54eb63b959b1172100334fb1","54eb63b959b1172100334fb2","54ed8dd4ab373e2300f50eae","54ed99b2ab373e2300f50ede","55153a6de68daa2f00cff838","551546edbc466623002afe72","5515472ac28d6125001b8884","55154749c28d6125001b8885","555d9b4106dfec0d00d38ea7","5613e06e433e5735007c7708","5624bbb785a31117001c5403","56669e857cc81e0d00253f8e","568b8d837a42220d00498311","56a632277ef6620d00e2f18a","56d8147c3eb4dd0b00201aac","57a9ce2fac6db30e000d7efd","57a9cf4e944ea60e00dc3f74","58172386715dce0f00da4aa0","582dc59ee1b8692300c0dd03"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"updates":["56bda793fb9be80d0032810c","56bda882752c130d008d19f2"],"next":{"pages":[],"description":""},"createdAt":"2015-04-01T12:30:27.034Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":4,"body":"Unicode (`UTF-8`) messages can be sent either by **textual** or **binary** Send SMS methods.\n\nIf you choose to send Unicode messages over [**textual Send SMS methods**](http://dev.infobip.com/v1/docs/send-single-sms), unconverted Unicode text should be inserted in the `text` parameter:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /sms/1/text/single HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\\n\\n{  \\n   \\\"from\\\":\\\"InfoSMS\\\",\\n   \\\"to\\\":\\\"41793026727\\\",\\n   \\\"text\\\":\\\"Hello world, Καλημέρα κόσμε, コンニチハ\\\"\\n}\",\n      \"language\": \"json\",\n      \"name\": \"\"\n    }\n  ]\n}\n[/block]\nThe Unicode message will be automatically sent to the mobile phone. If you wish to strip Unicode characters from your message check out NON_UNICODE [SMS transliteration](doc:transliteration).\n\nOn the other hand, if you want to send Unicode messages over [**binary Send SMS methods**](http://dev.infobip.com/v1/docs/send-single-binary-sms), the message text should be converted into hexadecimal representation. The hexadecimal content should be inserted in the `hex` parameter and also, you should set `dataCoding` parameter to **8** (`UTF-8`):\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /sms/1/binary/single HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\\n\\n{  \\n   \\\"from\\\":\\\"InfoSMS\\\",\\n   \\\"to\\\":\\\"41793026727\\\",\\n   \\\"binary\\\":{  \\n      \\\"hex\\\":\\\"48 65 6c 6c 6f 20 77 6f 72 6c 64 2c 20 ce 9a ce b1 ce bb ce b7 ce bc e1 bd b3 cf 81 ce b1 20 ce ba e1 bd b9 cf 83 ce bc ce b5 2c 20 e3 82 b3 e3 83 b3 e3 83 8b e3 83 81 e3 83 8f\\\",\\n      \\\"dataCoding\\\":8,\\n      \\\"esmClass\\\":0\\n   }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nWhen used in combination with [Flash SMS](doc:flash-sms) message type, `dataCoding` doesn't need to be adjusted:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /sms/1/binary/advanced HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\\n\\n{\\n   \\\"messages\\\": [{\\n       \\\"from\\\":\\\"InfoSMS\\\",\\n       \\\"destinations\\\":[{\\n          \\\"to\\\":\\\"41793026727\\\"\\n       }],\\n       \\\"binary\\\":{\\n          \\\"hex\\\":\\\"48 65 6c 6c 6f 20 77 6f 72 6c 64 2c 20 ce 9a ce b1 ce bb ce b7 ce bc e1 bd b3 cf 81 ce b1 20 ce ba e1 bd b9 cf 83 ce bc ce b5 2c 20 e3 82 b3 e3 83 b3 e3 83 8b e3 83 81 e3 83 8f\\\",\\n          \\\"dataCoding\\\":8,\\n          \\\"esmClass\\\":0\\n       },\\n       \\\"flash\\\":true\\n   }]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Important:\",\n  \"body\": \"When sending messages with one or more non-GSM characters (for example Unicode), the text of the message is limited to **70 characters**. [Here](http://en.wikipedia.org/wiki/GSM_03.38#GSM_7_bit_default_alphabet_and_extension_table_of_3GPP_TS_23.038_.2F_GSM_03.38) you can find what characters are included in GSM set.\"\n}\n[/block]","excerpt":"Send Unicode SMS messages over textual or binary API methods.","slug":"unicode-messages","type":"basic","title":"Unicode SMS"}

Unicode SMS

Send Unicode SMS messages over textual or binary API methods.

Unicode (`UTF-8`) messages can be sent either by **textual** or **binary** Send SMS methods. If you choose to send Unicode messages over [**textual Send SMS methods**](http://dev.infobip.com/v1/docs/send-single-sms), unconverted Unicode text should be inserted in the `text` parameter: [block:code] { "codes": [ { "code": "POST /sms/1/text/single HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json\n\n{ \n \"from\":\"InfoSMS\",\n \"to\":\"41793026727\",\n \"text\":\"Hello world, Καλημέρα κόσμε, コンニチハ\"\n}", "language": "json", "name": "" } ] } [/block] The Unicode message will be automatically sent to the mobile phone. If you wish to strip Unicode characters from your message check out NON_UNICODE [SMS transliteration](doc:transliteration). On the other hand, if you want to send Unicode messages over [**binary Send SMS methods**](http://dev.infobip.com/v1/docs/send-single-binary-sms), the message text should be converted into hexadecimal representation. The hexadecimal content should be inserted in the `hex` parameter and also, you should set `dataCoding` parameter to **8** (`UTF-8`): [block:code] { "codes": [ { "code": "POST /sms/1/binary/single HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json\n\n{ \n \"from\":\"InfoSMS\",\n \"to\":\"41793026727\",\n \"binary\":{ \n \"hex\":\"48 65 6c 6c 6f 20 77 6f 72 6c 64 2c 20 ce 9a ce b1 ce bb ce b7 ce bc e1 bd b3 cf 81 ce b1 20 ce ba e1 bd b9 cf 83 ce bc ce b5 2c 20 e3 82 b3 e3 83 b3 e3 83 8b e3 83 81 e3 83 8f\",\n \"dataCoding\":8,\n \"esmClass\":0\n }\n}", "language": "json" } ] } [/block] When used in combination with [Flash SMS](doc:flash-sms) message type, `dataCoding` doesn't need to be adjusted: [block:code] { "codes": [ { "code": "POST /sms/1/binary/advanced HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json\n\n{\n \"messages\": [{\n \"from\":\"InfoSMS\",\n \"destinations\":[{\n \"to\":\"41793026727\"\n }],\n \"binary\":{\n \"hex\":\"48 65 6c 6c 6f 20 77 6f 72 6c 64 2c 20 ce 9a ce b1 ce bb ce b7 ce bc e1 bd b3 cf 81 ce b1 20 ce ba e1 bd b9 cf 83 ce bc ce b5 2c 20 e3 82 b3 e3 83 b3 e3 83 8b e3 83 81 e3 83 8f\",\n \"dataCoding\":8,\n \"esmClass\":0\n },\n \"flash\":true\n }]\n}", "language": "json" } ] } [/block] [block:callout] { "type": "warning", "title": "Important:", "body": "When sending messages with one or more non-GSM characters (for example Unicode), the text of the message is limited to **70 characters**. [Here](http://en.wikipedia.org/wiki/GSM_03.38#GSM_7_bit_default_alphabet_and_extension_table_of_3GPP_TS_23.038_.2F_GSM_03.38) you can find what characters are included in GSM set." } [/block]