Compartilhar via


SmartDialog

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

This connector can be used to send and recieve SMS messages using the SmartDialog platform.

Prerequisites

  1. A SmartDialog subscription and account. Please be in contact with sales@arenainteractive.fi
  2. OAuth needs to be enabled for your account and a client secret needs to be requested. This can be done by sending us an email at support@arenainteractive.fi.

Setup

  1. Please follow the instructions in Create a custom connector from an OpenAPI definition.
  2. Create a Flow or PowerApp and add a SmartDialog action from the custom section. Sign in with your SmartDialog account.

Supported Actions

  • New Message (Trigger for recieving messages)
  • Send Message
  • Send WhatsApp Message
  • Send Discussion Reply Message
  • Send Reply Message
  • WhatsApp Opt In
  • WhatsApp Opt Out
  • Create WhatsApp Template
  • Get Group Contact
  • Create Group Contact
  • Update Group Contact
  • Delete Group Contact
  • Delete All Group Contacts

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Create group contact

Create group contact

Create WhatsApp template

Create a new WhatsApp template.

Delete All Group Contacts

Delete All Group Contacts

Delete Group Contact

Delete group contact using phone number.

Get Group Contact

Get Group Contact

Send Discussion Reply Message

Send a Discussion Reply Message to recipients.

Send Message

Send a Message to recipients.

Send Reply Message

Send a Replymessage to recipients.

Send WhatsApp Message

Send WhatsApp template message.

Update Group Contact

Update Group Contact

WhatsApp Opt In (deprecated) [DEPRECATED]

WhatsApp Opt In for sender and recipient. (deprecated)

WhatsApp Opt Out (deprecated) [DEPRECATED]

WhatsApp Opt Out for sender and recipient. (deprecated)

Create group contact

Create group contact

Parameters

Name Key Required Type Description
Customer
Customer True string

The Customer to fetch Group Services for.

Group Service
Group Service True string

The Group Service to use.

Active
active boolean

Flag that indicates if the Contact is Active.

Phone
phone True string

Phone number of the Contact.

Email
email string

Email address of the Contact.

Firstname
firstName string

Firstname of the Contact.

Lastname
lastName string

Lastname of the Contact.

Gender
gender string

Gender of the Contact.

Birth Year
birthYear integer

Birth Year of the Contact.

Street Address
streetAddress string

Street Address of the Contact.

Zip Code
zipCode string

Zip Code of the Contact.

City
city string

City of the Contact.

Country Code
countryCode string

3-letter Country Code of the Contact.

Name
name string

Custom property name.

Value
value string

Custom property value.

Phonenumber Regions
phoneNumberRegions array of string

Phonenumber regions to use for parsing numbers. Defaults to Finland if left empty.

Returns

Unique Id of the created Contact.

Contact Id
uuid

Create WhatsApp template

Create a new WhatsApp template.

Parameters

Name Key Required Type Description
Customer
Customer-Id True string

The Customer to create the Template for.

IdentityNumber
IdentityNumber True string

WhatsApp IdentityNumber used for the template.

Displayname
DisplayName True string

Template Displayname.

Content
RawContent True string

Template content.

Template Category
Category True string

Template category.

Template Language
Language True string

2-character code for template language.

Button Type
Type string

Type of Button.

Button Label
Label string

Button Label.

Button Data
Data string

Button data. Url (Url), phone number (Call) or text (QuickReply). Max length is 2000 for Url, and 20 for phone number and text.

Attachment Url
AttachmentUrl string

URL to an example attachment.

Delete All Group Contacts

Delete All Group Contacts

Parameters

Name Key Required Type Description
Customer
Customer True string

The Customer to fetch Group Services for.

Group Service
Group Service True string

The Group Service to use.

Returns

response
boolean

Delete Group Contact

Delete group contact using phone number.

Parameters

Name Key Required Type Description
Customer
Customer True string

The Customer to fetch Group Services for.

Group Service
Group Service True string

The Group Service to use.

Phone
Phone True string

The Phone number of the contact to Delete.

Returns

response
boolean

Get Group Contact

Get Group Contact

Parameters

Name Key Required Type Description
Customer
Customer True string

The Customer to fetch Group Services for.

Group Service
Group Service True string

The Group Service to use.

Phone
Phone True string

The Phone number of the Contact.

Region
Region string

Optional Phonenumber region to use for parsing the Phone number.

Returns

Name Path Type Description
Phone
phone string

Phone number of the Contact.

Email
email string

Email address of the Contact.

Firstname
firstName string

Firstname of the Contact.

Lastname
lastName string

Lastname of the Contact.

Gender
gender string

Gender of the Contact.

Birth Year
birthYear integer

Birth Year of the Contact.

Street Address
streetAddress string

Street Address of the Contact.

Zip Code
zipCode string

Zip Code of the Contact.

City
city string

City of the Contact.

Country Code
countryCode string

Country Code of the Contact.

Failed Messages
failedMessages integer

Number of failed messages for the Contact.

Custom Properties
customContactProperties array of object

Custom Contact Property collection saved for the Contact.

Name
customContactProperties.name string

Custom contact property name.

Value
customContactProperties.value string

Custom contact property value.

Send Discussion Reply Message

Send a Discussion Reply Message to recipients.

Parameters

Name Key Required Type Description
Customer
CustomerId True string

The Customer to use for sending.

Thread Id
ThreadId True string

Id of the existing Thread to reply to.

Message Content
Content True string

The content of the message.

Customer Data
CustomerData string

Billing/grouping data for this message, optional.

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.

ThreadId
ThreadId string

Identifier of Thread that the message was sent to.

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.

Customer Data
CustomerData string

Billing/grouping data for this message, optional.

Ad Message
AdMessage boolean

Optional overriding flag for marking the message as an ad message

Dlr Url
DlrUrl string

Url for Delivery status callback via http-get. You may add querystring values to url, they will be preserved.

Request Id
RequestId string

Optional unique request id that can be used to identify duplicate requests. If a duplicate request id is detected, sending is cancelled. There is no guarantee that requests with duplicate request ids will be blocked in high throughput/traffic situations. The given requestId will be "remembered" for 7 days.

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 Reply Message

Send a Replymessage to recipients.

Parameters

Name Key Required Type Description
ParentMessage Id
ParentMessageId True string

The Parent message Id to reply to.

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.

Customer Data
CustomerData string

Billing/grouping data for this message, optional.

Ad Message
AdMessage boolean

Optional overriding flag for marking the message as an ad message

Dlr Url
DlrUrl string

Url for Delivery status callback via http-get. You may add querystring values to url, they will be preserved.

Request Id
RequestId string

Optional unique request id that can be used to identify duplicate requests. If a duplicate request id is detected, sending is cancelled. There is no guarantee that requests with duplicate request ids will be blocked in high throughput/traffic situations. The given requestId will be "remembered" for 7 days.

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.

BodyParameters
BodyParameters array of string

BodyParameters

HeaderParameters
HeaderParameters array of string

HeaderParameters

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.

Customer Data
CustomerData string

Billing/grouping data for this message, optional.

Request Id
RequestId string

Optional unique request id that can be used to identify duplicate requests. If a duplicate request id is detected, sending is cancelled. There is no guarantee that requests with duplicate request ids will be blocked in high throughput/traffic situations. The given requestId will be "remembered" for 7 days.

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.

Update Group Contact

Update Group Contact

Parameters

Name Key Required Type Description
Customer
Customer True string

The Customer to fetch Group Services for.

Group Service
Group Service True string

The Group Service to use.

Phone
Phone True string

The Phone number of the contact to update.

Active
active boolean

Flag that indicates if the Contact is Active.

Email
email string

Email address of the Contact.

Firstname
firstName string

Firstname of the Contact.

Lastname
lastName string

Lastname of the Contact.

Gender
gender string

Gender of the Contact.

Birth Year
birthYear integer

Birth Year of the Contact.

Street Address
streetAddress string

Street Address of the Contact.

Zip Code
zipCode string

Zip Code of the Contact.

City
city string

City of the Contact.

Country Code
countryCode string

3-letter Country Code of the Contact.

Name
name string

Custom contact property name.

Value
value string

Custom contact property value.

Phonenumber Regions
phoneNumberRegions array of string

Phonenumber regions to use for parsing numbers. Defaults to Finland if left empty.

Returns

response
boolean

WhatsApp Opt In (deprecated) [DEPRECATED]

WhatsApp Opt In for sender and recipient. (deprecated)

Parameters

Name Key Required Type Description
Sender address
Sender True string

Registered Whatsapp identity number to opt-in to.

Recipient address
Recipient True string

Recipient number to opt-in.

WhatsApp Opt Out (deprecated) [DEPRECATED]

WhatsApp Opt Out for sender and recipient. (deprecated)

Parameters

Name Key Required Type Description
Sender address
Sender True string

Registered Whatsapp identity number to opt-out from.

Recipient address
Recipient True string

Recipent number to remove from opt-in.

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.

Message Id
messageId string

The unique message Id of the received message.

Definitions

uuid

Unique Id of the created Contact.

Unique Id of the created Contact.

Contact Id
uuid

boolean

This is the basic data type 'boolean'.