{"id":3525,"date":"2026-01-13T15:09:41","date_gmt":"2026-01-13T12:09:41","guid":{"rendered":"https:\/\/docs.unibell.tech\/?page_id=3525"},"modified":"2026-04-09T10:04:18","modified_gmt":"2026-04-09T07:04:18","slug":"smpp-integration","status":"publish","type":"page","link":"https:\/\/docs.unibell.tech\/?page_id=3525","title":{"rendered":"SMPP integration"},"content":{"rendered":"\n<p>The connection is established via our SMS gateway, which allows sending messages using the SMPP protocol versions 3.4 and 5.0.<\/p>\n\n\n\n<p>SMPP server address: <code>smpp.unibell.ru<\/code><\/p>\n\n\n\n<p>Port: <code>5070<\/code><\/p>\n\n\n\n<p>Connections in <code>BOUND_TRX<\/code> mode are supported.<\/p>\n\n\n\n<h2 id=\"Multiple_connections\" class=\"anchor\">Multiple connections<\/h2>\n\n\n\n<p>The server allows only one active connection per login to ensure correct delivery of statuses. Therefore, when a new connection is established, any previously established session with the same login is automatically terminated. At the same time, multiple connections with different logins linked to the same personal account and the same balance can operate simultaneously.<\/p>\n\n\n\n<h2 id=\"SMS\" class=\"anchor\">Sending an SMS message<\/h2>\n\n\n\n<p>To send an SMS message, use the <code>SUBMIT_SM<\/code> command according to the specification.<\/p>\n\n\n\n<p>The following encodings are supported:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>7-bit GSM for Latin text with support for European characters (<code>data_coding=0<\/code>);<\/li>\n\n\n\n<li>8-bit ISO-8859-1 (ASCII) for Latin text or binary data (<code>data_coding=1<\/code>);<\/li>\n\n\n\n<li>UCS2 (UCS-2BE or UTF-16BE) for national alphabets (<code>data_coding=8<\/code>).<\/li>\n<\/ul>\n\n\n\n<p>For an SMS message, the <code>esm_class<\/code> field in <code>SUBMIT_SM<\/code> must be set to 0.<\/p>\n\n\n\n<p>The transmission rate must not exceed 100 messages per second. If this limit is exceeded, a <code>THROTTLING<\/code> error will be returned in <code>SUBMIT_SM_RESP<\/code>. For higher sending rates, multiple incoming connections with different logins should be established.<\/p>\n\n\n\n<p>When automatically returning the status in the <code>DELIVER_SM<\/code> command, standard TLV parameters are transmitted:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Parameter<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>receipted_message_id<\/td><td>SMS message identifier<\/td><\/tr><tr><td>message_state<\/td><td>SMS message status (see <strong><a href=\"https:\/\/docs.unibell.tech\/?page_id=3525#message_state\">Message state<\/a><\/strong> for details)<\/td><\/tr><tr><td>network_error_code<\/td><td>Error code (see <strong><a href=\"https:\/\/docs.unibell.tech\/?page_id=3525#Status-error-codes\">Error codes in status<\/a><\/strong> for details)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 id=\"HLR\" class=\"anchor\">Sending an HLR request<\/h2>\n\n\n\n<p>To send an HLR request, use the <code>SUBMIT_SM<\/code> command. The values of the <code>sourceAddr<\/code> and <code>shortMessage<\/code> fields must be set to <code>HLR<\/code>.<\/p>\n\n\n\n<p>The request result is returned in a standard <code>DELIVER_SM<\/code>, which can be received over the SMPP connection. Standard TLV parameters are transmitted:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Parameter<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>receipted_message_id<\/td><td>HLR request identifier<\/td><\/tr><tr><td>message_state<\/td><td>HLR request status (see <strong>Message state<\/strong> for details)<\/td><\/tr><tr><td>network_error_code<\/td><td>Error code (see <strong>Error codes in status<\/strong> for details)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 id=\"message_state\" class=\"anchor\">Statuses in `message_state`<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Value<\/th><th>Message state<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>1<\/td><td>EVROUTE<\/td><td>Message is in delivery state (in transit)<\/td><\/tr><tr><td>2<\/td><td>DELIVERED<\/td><td>Message delivered to the recipient<\/td><\/tr><tr><td>3<\/td><td>EXPIRED<\/td><td>Message validity period expired; cannot be delivered<\/td><\/tr><tr><td>4<\/td><td>DELETED<\/td><td>Message was deleted<\/td><\/tr><tr><td>5<\/td><td>UNDELIVERABLE<\/td><td>Message cannot be delivered<\/td><\/tr><tr><td>6<\/td><td>ACCEPTED<\/td><td>Message accepted (e.g., manually read on behalf of the subscriber by support)<\/td><\/tr><tr><td>7<\/td><td>UNKNOWN<\/td><td>Message is in an invalid\/unknown state<\/td><\/tr><tr><td>8<\/td><td>REJECTED<\/td><td>Message rejected<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 id=\"Status-error-codes\" class=\"anchor\">Error codes in the status<\/h2>\n\n\n\n<p>Possible error codes in the status of SMS messages or HLR requests (<code>networkErrCode<\/code>).<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Code<\/th><th>Name<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>0<\/td><td>No error<\/td><td>Subscriber exists and is available<\/td><\/tr><tr><td>1<\/td><td>Subscriber does not exist<\/td><td>The specified phone number does not exist<\/td><\/tr><tr><td>6<\/td><td>Subscriber not in network<\/td><td>Subscriber\u2019s phone is switched off or out of network coverage<\/td><\/tr><tr><td>11<\/td><td>No SMS service<\/td><td>Subscriber cannot receive SMS. For example, the service is not activated, the subscriber is roaming in a network without SMS support, or the subscriber\u2019s operator does not have SMS exchange with the current roaming operator. This can also occur with landline numbers that do not receive messages<\/td><\/tr><tr><td>12<\/td><td>Subscriber phone error<\/td><td>Message cannot be delivered due to an error in the phone or SIM card<\/td><\/tr><tr><td>13<\/td><td>Subscriber blocked<\/td><td>Occurs if the subscriber has zero or negative balance, is roaming, or has been blocked by the operator for non-payment or voluntarily. This error can also occur due to SIM card damage or incorrect PIN\/PUK entry<\/td><\/tr><tr><td>21<\/td><td>Service not supported<\/td><td>Subscriber\u2019s device does not support this service<\/td><\/tr><tr><td>100<\/td><td>RejectedByIpBlockedException<\/td><td>Blocking by IP address<\/td><\/tr><tr><td>101<\/td><td>RejectedByFinBlockedException<\/td><td>Financial lockdown<\/td><\/tr><tr><td>102<\/td><td>SmsTemplateRejectedException<\/td><td>The template was not found<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The connection is established via our SMS gateway, which allows sending messages using the SMPP protocol versions 3.4 and 5.0. SMPP server address: smpp.unibell.ru Port: 5070 Connections in BOUND_TRX mode are supported. Multiple connections The server allows only one active connection per login to ensure correct delivery of statuses. Therefore, when a new connection is <a href=\"https:\/\/docs.unibell.tech\/?page_id=3525\" class=\"more-link\">&#8230;<span class=\"screen-reader-text\">  SMPP integration<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"tpl\/http-content.php","meta":{"footnotes":""},"class_list":["post-3525","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3525","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3525"}],"version-history":[{"count":6,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3525\/revisions"}],"predecessor-version":[{"id":3603,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3525\/revisions\/3603"}],"wp:attachment":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3525"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}