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 |
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.
- 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.
- 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.
- 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
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
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
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 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
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 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
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 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 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 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 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
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 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 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. |
New Message |
When a new message arrives to a 2-Way service. |
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. |
This is the basic data type 'boolean'.