SmartDialog (Preview)

SmartDialog is a platform used to send and receive SMS- and WhatsApp messages. It offers a wide variety of smart messaging services.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Arena Interactive Support
URL https://www.arenainteractive.fi/contact
Email support@arenainteractive.fi
Connector Metadata
Publisher Arena Interactive Oy
Website https://www.arenainteractive.fi
Privacy policy https://www.arenainteractive.fi/privacypolicy
Categories Communication;Collaboration

SmartDialog connector allows you to send and receive messages via the SmartDialog platform. Messages include, but are not limited to SMS, MMS and WhatsApp.

Prerequisites

  1. A SmartDialog subscription and account. Please be in contact with sales@arenainteractive.fi
  2. For receiving messages, input sources are needed too. These can be National Shortcodes, International Longcodes or Instant Messaging accounts, like a WhatsApp Business account.

How to get credentials

Contact sales@arenainteractive.fi and sign a contract with Arena Interactive. Once you have an account, proceed to create a One Way messaging service. If you also want to receive inbound messages, you also need a Two Way service with configured address and possible keywords.

Getting started with your connector

Once you have an account you can proceed to send and receive messages from Logic Apps, Power automate and other service. You could for instace trigger new messages from Microsoft CRM when a contact is created or when a case is closed.

Known issues and limitations

Depending on the choice of message types, some restrictions apply. For instance SMS-messages can carry 140 bytes of information per message. If this is exceeded, chaining of messages will be done automatically. Note that the chaining header consumes some data from each message. One example is, using standard GSM alphabet, one message can be 160 characters, but two messages can only carry 306 characters of text due to chaining. Messages are invoice on a part basis, so the previous example would cost two "parts". Using Unicode roughly halves the amount of text each messagepart can carry.

Common errors and remedies

Common errors include authentication errors:

  • Where your SmartDialog user may not be allowed to perfom OAuth2 authentication.
    • Contact your adminstrator or support@arenainteractive.fi to enable this.
  • Where you might provide an serviceId, or a serviceId belonging to another company.
    • Verify the ServiceId

FAQ

  • What phone number format should I use in API requests?

We strongly recommend using international format without prefixes (+, 00) and with no extra characters between digits, for example 358207434242. The API makes an attempt to remove extra characters in numbers and to transform national numbers to international form using the Finnish calling code (358) as default, but depending on input and the desired result this process may not always produce the desired outcome.

  • How many characters will fit into one SMS?

One SMS can hold 140 bytes of data. When sending a concatenated (long) message, the concatenation method reserves six bytes from each SMS, leaving 134 bytes for the rest of the message data in each concatenated SMS. When using the GSM 03.38 character set for text messages, characters are packed into 7-bit septets. 140 bytes (one SMS) can hold 160 of these septets, and 134 bytes (concatenation) can hold 153. Most of the characters in GSM 03.38 take one septet each, but there are a handful of characters (most commonly used of which is the euro character) need two septets each. More information about the GSM character set: http://en.wikipedia.org/wiki/GSM_03.38 With Unicode messages each character takes two bytes. 140 bytes (one SMS) can hold 70 of twobyte sequences, and 134 bytes (concatenation) can hold 67. For binary messages space consumption depends on the message type, but the upper limit of 140 bytes per SMS applies to them too.

  • How long concatenated messages can I send?

The concatenation mechanism of SMS's allows up to 255 concatenated parts, but all receiving devices cannot handle anywhere near this many. We do not recommend sending text messages that are longer than three SMS's nor binary messages that are longer than four SMS's.

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds

Actions

Send Message

Send a Message to recipients.

Send WhatsApp Message

Send WhatsApp template message.

Send Message

Send a Message to recipients.

Parameters

Name Key Required Type Description
Customer
Customer-Id True string

The Customer to use for sending.

Service
Service-Id True string

The Service to use for sending.

Message Sender
Sender True string

The sender of the message, can be alphanumeric, long code or short code (restrictions apply).

Message Content
Content True string

The content of the message.

Message Protocol
Protocol True string

The protocol to use for sending the message.

Send Datetime
SendDateTime date-time

The date and time to send the message. Leave empty to send instantly.

Address
Address True string

Message recipient address.

Attachment Uri
AttachmentUri string

Attachment Uri to be used when sending WhatsApp message that contains an attachment.

Returns

Name Path Type Description
Message Id
MessageId string

Newly created message's identifier.

Message Part Count
MessagePartCount integer

Approximated number of message parts for this message.

Recipients
Recipients array of object

Recipients

Recipient Address
Recipients.Address string

Recipient address (phone number/email/user id etc.).

Recipient Id
Recipients.Id string

Recipient identifier used for receiving delivery status information.

Send WhatsApp Message

Send WhatsApp template message.

Parameters

Name Key Required Type Description
Customer
Customer-Id True string

The Customer to use for sending.

Service
Service-Id True string

The Service to use for sending.

WhatsApp Template
TemplateName True string

The Template to use for sending.

Address
Address True string

Message recipient address.

Template Body Parameters
BodyParameters string

Array of string parameters to be used in the body of the selected template.

Template Header Parameters
HeaderParameters string

Array of string parameters to be used in the header of the selected template.

Type
Type string

The button type. Only one type per template, may contain multiple of the same type.

Text
Data string

The text of the button.

Send Datetime
SendDateTime string

The date and time to send the message. Leave empty to send instantly.

Attachment Uri
AttachmentUri string

The Attachment Uri if the template contains an attachment.

Use SMS Fallback
UseSmsFallback boolean

Should SMS be used as fallback.

Dlr Url
DlrUrl string

Delivery report Url that will recieve a callback when the sendprocess completes.

Returns

Name Path Type Description
Message Id
messageId string

Newly created message's identifier.

Message Part Count
messagePartCount integer

Approximated number of message parts for this message.

recipients
recipients array of object

recipients

Recipient Address
recipients.address string

Recipient address (phone number/email/user id etc.).

Recipient Id
recipients.id string

Recipient identifier used for receiving delivery status information.

Triggers

New Message

When a new message arrives to a 2-Way service.

New Message

When a new message arrives to a 2-Way service.

Parameters

Name Key Required Type Description
Customer
Customer True string

The Customer to use.

Service
Service True string

The 2-Way service to use.

Returns

Name Path Type Description
Message Sender
sender string

The message sender.

Message Recipient
recipient string

The recipient of the message.

Message Content
content string

The content of the received message.

Message Timestamp
timestamp date-time

The timestamp of the message.

Message Protocol
protocol string

The protocol of the received message.

attachments
attachments array of object

attachments

Attachment Filename
attachments.name string

The filename of the attachment.

Attachment Mime Type
attachments.mimeType string

The mime type of the attachment.

Attachment Resource Location
attachments.resourceLocation string

The attachment resource location.