This site is no longer updated.Go to new Conversational Cloud docs

SMS messaging


JAICP supports sending SMS messages right from the script. For that, you have to buy an SMS package. Contact client@just-ai.com for more details.

SMS messages can only be sent to phone numbers registered in Russia.

Supported channels

You can send SMS messages from:

How to use

There are two ways you can configure sending SMS messages:

  • Use the sms reply type in the script. To handle successful or failed SMS message delivery, specify the smsSuccessEvent and smsFailedEvent events.
  • Add the Sms action tag to the script and specify the necessary parameters: the recipient phone number and message text.

Message length

There are character limits for SMS messages:

  • Messages with Arabic, Chinese, Cyrillic, Hindi, Japanese, and Korean characters may contain no more than 70 characters.

    If there is at least one, for example, Arabic character in the message, then the whole message is considered to be in Arabic.

  • Messages with Latin characters only may contain no more than 160 characters.
  • One emoji counts as one character.
  • The following characters count as two characters: \f, ^, {, }, \\, [, ~, ], |, .
  • If the message length exceeds than the allowed length, the message will be segmented when it is sent. Each segment is billed as a separate message, but the recipient will get a single message.

No more than 6 segments can be sent at a time.

Custom SMS sender ID

If you have set a configuration with the i‑Digital provider, you can specify the sender ID. Otherwise, NftService will be displayed as the SMS sender.

To configure a sender ID:

  1. Send an email to client@just-ai.com for more details.
  2. Contact i‑Digital and register a custom SMS sender ID.
  3. Obtain configuration data from i‑Digital and pass it in the providerConfiguration object.

Examples

In this example, the client with the 79123456789 phone number receives an SMS message Your order has been successfully completed when switching to the Confirmation state.

If the SMS message is delivered successfully, the message Thanks for your order! We have sent your order details in an SMS message will be displayed in the chat.

SMS reply type usage
SMS action tag usage
state: Confirmation
    script:
        var reply = {
            "type": "sms",
            "text": "Your order has been successfully completed",
            "destination": "79123456789"
        };
        $response.replies = $response.replies || [];
        $response.replies.push(reply);

    state: Success
        event: smsSuccessEvent
        a: Thanks for your order! We have sent your order details in an SMS message.
state: Confirmation
    Sms:
        text = Your order has been successfully completed.
        destination = 79123456789
        okState = /Confirmation/Success

    state: Success
        a: Thanks for your order! We have sent your order details in an SMS message.