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 |
|---|---|---|
| Copilot Studio | 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) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - 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) |
| 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) |
| Contact | |
|---|---|
| Name | Arena Interactive Support |
| URL | https://www.arenainteractive.fi/contact |
| 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
- A SmartDialog subscription and account. Please be in contact with sales@arenainteractive.fi
- 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
- Please follow the instructions in Create a custom connector from an OpenAPI definition.
- 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 Whats |
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 Whats |
Send WhatsApp template message. |
| Update Group Contact |
Update Group Contact |
|
Whats |
WhatsApp Opt In for sender and recipient. (deprecated) |
|
Whats |
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
|
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
|
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
|
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
boolean
This is the basic data type 'boolean'.