FlashingCall (VoiceCode)#

FlashingCall (VoiceCode) Request#

To send the message with FlashingCall type, you need to make a request.

To send VoiceCode, you need to specify the FlashingCall type and send a request, containing the code. The specified code (without accompanying text) will be passed to the operator, who will insert it into the text of the message template.

 1{
 2"login": "YOUR_LOGIN",
 3"password": "YOUR_PASSWORD",
 4"destAddr": "Subscriber's_Number",
 5"message": {
 6   "type": "FLASHINGCALL",
 7   "data": {
 8      "text": "1234",
 9      "ttl": 1
10   }
11}
12}

Parameter

Required

Type

Description

login

yes

string

Partner’s name in the system.

password

yes

string

Partner’s password in the system.

destAddr

yes

string

Subscriber’s phone number.

More details

It contains the country code, operator code and phone number.

For the Russian Federation, the code can be 8, 7 or +7.

Examples: 72101234567, +72101234567, 8-210-123-45-67, 82101234567.

message

yes

object

Parameters of a message being sent.

message/type

yes

enum

Message type.

More details

The value of FLASHINGCALL is transmitted.

message/data

yes

object

Parameters of the data being sent.

message/data/text

yes

string

Message text.

More details

Number of characters: no more than 2000.

The text must contain the code used to call the subscriber number.

message/data/ttl

yes

integer

FLASHINGCALL (Voice Code) message lifetime.

More details

The waiting interval for a response is from 1 to 5 minutes.

Note

If ttl = 0 or if there are no parameter in the request the value is taken from the default settings set when configuring the integration for each client individually.

FlashingCall Request Result#

The result of the request execution for FlashingCall type message will be a call to the subscriber’s phone from a special numbering capacity.
The last digits of the calling number are the code that is sent in the message text.
The sending message code in the text shall consist of 4 or 6 digits.
Response waiting period (ttl) on the call-making is from 1 to 5 minutes.
After sending the message the Service Provider returns a response synchronously.

VoiceCode Request Result#

The result of the VoiceCode type message request will be a call to the subscriber’s phone. When the subscriber picks up the phone, he will hear a voice message that will contain a 4 or 6 digit code.
To activate this service, you should contact the Technical Support Service and agree on the text of the voice message template.

FlashingCall (VoiceCode) Message Sending Errors#

For results with errors, a response HTTP code will differ from 200 (see Error Codes).

1{
2   "error": {
3      "code": 4,
4      "description": "Invalid request"
5   },
6   "extendedDescription": "FlashingCall text should contain a 4-digit code."
7}

Error Codes#

Code

Description

HTTP-code

1

Service is unavailable

503

2

Invalid IP-address

403

3

Too many connections

429

4

Invalid request

400

5

Invalid login

401

6

Invalid password

401

7

serviceNumber is not defined

400

8

destAddr is not correct

406

9

Message type is not correct

406

10

Prohibited sending duplicates

409

11

Invalid TTL

406

100

100

500

FlashingCall (VoiceCode) Delivery Statuses#

To receive FlashingCall (VoiceCode) message statuses you need to set up the Delivery Status Service.

Delivery Error Codes#

Delivery error codes for each message type are provided in the corresponding tab of the Description of Error Codes section.