Mensagia (Preview)
Mensagia offers reliable SMS, Email and Voice messages for business automation communication.
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 | Mensagia |
| URL | https://mensagia.com/ |
| support@mensagia.com |
| Connector Metadata | |
|---|---|
| Publisher | Mensagia |
| Website | https://mensagia.com/ |
| Privacy policy | https://mensagia.com/legal#privacidad |
| Categories | Communication |
Mensagia offers reliable SMS, Email and Voice messages for business automation communication.
Prerequisites
You will need the following to proceed:
- A Mensagia "API Client" account.
- Make sure you have enough balance in your Mensagia account.
How to get credentials
The API key can be obtained by entering the portal of your Mensagia account.
Get started with your connector
- Register on Mensagia
- Add balance to your account
- Add an API Client account
- Follow these instructions
Known issues and limitations
The GET methods don't allow parameters.
Common errors and remedies
No commor errors and remedies.
FAQ
Please cotact us if you have any questions.
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API Key | securestring | API Key for this API. | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Create a Contact |
Create a contact inside your Mensagia's account. |
| Get 2 Way SMS |
Get a list of 2 Way SMS through your Mensagia account. |
| Get 2 Way SMS's numbers |
Get a list of 2 Way SMS's numbers through your Mensagia account. |
| Send 2 Way SMS |
Send a 2 Way SMS to your contacts through your Mensagia account. |
| Send SMS |
Send SMS's to your contacts through your Mensagia account. |
| Send SMS Campaigns |
Send SMS Campaigns to your contacts through your Mensagia account. |
| Send Transactional Email |
Send a Transactional email to your contacts using your custom templates from Mensagia. |
| Send Voice Message |
This method allows you to carry out Voice campaigns to telephone numbers in Spain. The recipients of the voice campaign can be: agendas, agendas and telephone numbers, or telephone numbers. |
Create a Contact
Create a contact inside your Mensagia's account.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Is in Mail Blacklist
|
in_mail_blacklist | boolean |
Specify if your contact is on the Email blacklist. |
|
|
Is in SMS Blacklist
|
in_sms_blacklist | boolean |
Specify if your contact is on in_voice_blacklist. |
|
|
Is in Voice Blacklist
|
in_voice_blacklist | boolean |
Specify if your contact is on the Voice blacklist. |
|
|
Number
|
number | True | string |
The contact's mobile number without blank spaces, with the international prefix and without the + sign. |
|
Name
|
name | string |
Name of the contact within Mensagia. |
|
|
Email
|
True | string |
Contact email within Mensagia. |
|
|
City
|
city | string |
Location of your contact. |
|
|
Language
|
language | string |
Contact's language in ISO code. |
|
|
Agenda
|
groups | string |
Add your contact to an address book |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Contact ID
|
data.id | integer |
Contact's ID in Mensagia |
|
Contact Number
|
data.number | string |
Contact's Number |
|
Push Operator
|
data.push_operator_destination_id | string |
Contact's Push operator destination |
|
Contact Name
|
data.name | string |
Contact's name |
|
Contact Email
|
data.email | string |
Contact's email |
|
Contact Location
|
data.city | string |
Contact's location |
|
Contact Language
|
data.language | string |
Contact's language |
|
Contact Country
|
data.country_id | integer |
Contact's Country ID |
|
Country Name
|
data.country_name | string |
Contact's country name |
|
Is in SMS Blacklist
|
data.in_sms_blacklist | boolean |
Determines if the contact is in the SMS Blacklist |
|
Is in Voice Blacklist
|
data.in_voice_blacklist | boolean |
Determines if the contact is in the Voice Blacklist |
|
Is in Email Blacklist
|
data.in_mail_blacklist | boolean |
Determines if the contact is in the Email Blacklist |
|
Created At
|
data.created_at | string |
Contact created at |
|
Updated At
|
data.updated_at | string |
Contact updated at |
|
data
|
data.groups.data | array of object |
data |
|
Group ID
|
data.groups.data.id | integer |
Group ID |
|
Group Name
|
data.groups.data.name | string |
Group Name |
|
Total Group's Users
|
data.groups.data.total_users | integer |
Total Group's Users |
|
Group is Busy
|
data.groups.data.busy | integer |
Group is Busy |
|
Group Created At
|
data.groups.data.created_at | string |
Group Created At |
|
Group Updated At
|
data.groups.data.updated_at | string |
Group Updated At |
Get 2 Way SMS
Get a list of 2 Way SMS through your Mensagia account.
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Message ID
|
id | integer |
Message ID |
|
Application ID
|
application_id | string |
Application ID |
|
Configuration ID
|
configuration_id | integer |
Sending header ID |
|
Number
|
number | string |
Number |
|
Type
|
type | string |
Type of SMS (MO or MT) |
|
To Number
|
enduser_number | string |
Receptor's number |
|
Message body
|
message | string |
Message's body |
|
Created At
|
created_at | string |
Created At |
Get 2 Way SMS's numbers
Get a list of 2 Way SMS's numbers through your Mensagia account.
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
data
|
data | array of object | |
|
Message ID
|
data.id | integer |
Message ID |
|
Number
|
data.number | string |
Number |
|
Callback URL
|
data.callback_url | string |
Callback URL |
|
Created At
|
data.created_at | string |
Created At |
|
Total
|
meta.pagination.total | integer |
Total |
|
Count
|
meta.pagination.count | integer |
Count |
|
Per Page
|
meta.pagination.per_page | integer |
Results per page |
|
Current Page
|
meta.pagination.current_page | integer |
Current page |
|
Total Pages
|
meta.pagination.total_pages | integer |
Total pages |
|
links
|
meta.pagination.links | array of string |
links |
Send 2 Way SMS
Send a 2 Way SMS to your contacts through your Mensagia account.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Number
|
number | True | string |
The number 2 Way SMS by which the message is to be sent |
|
To Number
|
enduser_number | True | string |
Receiver's number |
|
Message
|
message | True | string |
Text to be sent (no more than 160 characters). |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Message ID
|
id | integer |
Message ID |
|
Application ID
|
application_id | string |
Application ID |
|
Configuration ID
|
configuration_id | integer |
Sending header ID |
|
Number
|
number | string |
Number |
|
Type
|
type | string |
Type of SMS (MO or MT) |
|
To Number
|
enduser_number | string |
Receptor's number |
|
Message body
|
message | string |
Message's body |
|
Created At
|
created_at | string |
Created At |
Send SMS
Send SMS's to your contacts through your Mensagia account.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Configuration Name
|
configuration_name | True | string |
Select the name that will appear in the header of your SMS. |
|
Message
|
message | True | string |
Text to be sent (no more than 160 characters). |
|
Numbers
|
numbers | True | string |
The mobile number of the recipient of this message. IMPORTANT: The number must have the corresponding country prefix. |
|
Start Date
|
start_date | string |
Sending date in the format 'YYYY-MM-DD hh:mm'. If you don't specify this parameter, the message will be sent immediately. |
|
|
URL Paremeters
|
url_parameters | string |
Link tagging if there is a shortened link, Landing or Form in the message. |
|
|
URL Extrafields Mode
|
url_extrafields_mode | string |
If you include shortened links or landings in your shipments, you can choose what value the custom fields will show when the recipient views the content. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Configuration ID
|
data.configuration_id | integer |
Sending header ID |
|
Message ID
|
data.id | integer |
Message ID |
|
Message Name
|
data.name | string |
Message's name |
|
Message body
|
data.message | string |
Message's body |
|
Price
|
data.price | float |
Message's price |
|
Price with Packs
|
data.price_with_packs | float |
Price with packs |
|
Sender Header
|
data.push_sender_name | string |
Push sender name |
|
Route Name
|
data.route_name | string |
Route name |
|
Messages Sent
|
data.total_messages_sent | integer |
Total messages sent |
|
Messages Sent Packs
|
data.total_messages_sent_with_packs | integer |
Total messages sent with packs |
|
dlrs
|
data.dlrs | array of object |
dlrs |
|
Message ID
|
data.dlrs.message_id | string |
Message ID |
|
To Number
|
data.dlrs.number | string |
Receptor's number |
|
Messages Sent
|
data.dlrs.messages_sent | integer |
Total messages to number |
|
Is in SMS Blacklist
|
data.dlrs.in_SMS_blacklist | boolean |
Determines if the contact is in the SMS Blacklist |
|
Callback URL
|
data.callback_url | string |
Callback URL |
|
Start Date
|
data.start_date | string |
Start Date |
Send SMS Campaigns
Send SMS Campaigns to your contacts through your Mensagia account.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Configuration Name
|
configuration_name | True | string |
Select the name that will appear in the header of your SMS. |
|
Message
|
message | True | string |
Text to be sent (no more than 160 characters). |
|
Campaign's name
|
name | string |
The name of your campaign |
|
|
Available Group
|
available_groups | True | string |
Assign the group to which the campaign will be directed. |
|
Start Date
|
start_date | date-time |
Sending date in the format 'YYYY-MM-DD hh:mm'. If you don't specify this parameter, the message will be sent immediately. |
|
|
Calls per Block
|
smsxblock | integer |
Number of recipients per block. Mandatory in the presence of 'Minutes Per Block'. If the two parameters are sent, the campaign configuration is defined as 'custom configuration' and the value of the parameters 'Days' and 'Time Intervals' will be considered. |
|
|
Minutes per Block
|
minutesxblock | integer |
Every few minutes the block of recipients chosen in 'Calls Per Block' will be sent. Mandatory in the presence of 'Calls Per Block'. If the two parameters are sent, the campaign configuration is defined as 'custom configuration' and the value of the parameters 'Days' and 'Time Intervals' will be considered. |
|
|
Days
|
days | string |
A list of days of the week separated by commas and without spaces on which calls can be made. (1,2,3,4,5,6,7) |
|
|
Time Intervals
|
time_intervals | string |
A list of time intervals separated by commas and without spaces, in which the call can be sent. It will only be taken into account if 'Minutes Per Block' and 'Calls Per Block' are sent.(hh:mm-hh:mm,hh:mm-hh:mm...) |
|
|
URL Paremeters
|
url_parameters | string |
Link tagging if there is a shortened link, Landing or Form in the message. |
|
|
URL Extrafields Mode
|
url_extrafields_mode | string |
If you include shortened links or landings in your shipments, you can choose what value the custom fields will show when the recipient views the content. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Configuration ID
|
data.configuration_id | integer |
Sending header ID |
|
Message ID
|
data.id | integer |
Message ID |
|
Message Name
|
data.name | string |
Message's name |
|
Message body
|
data.message | string |
Message's body |
|
Price
|
data.price | float |
Message's price |
|
Price with Packs
|
data.price_with_packs | float |
Price with packs |
|
Sender Header
|
data.push_sender_name | string |
Push sender name |
|
Route Name
|
data.route_name | string |
Route name |
|
Messages Sent
|
data.total_messages_sent | integer |
Total messages sent |
|
Messages Sent Packs
|
data.total_messages_sent_with_packs | integer |
Total messages sent with packs |
|
dlrs
|
data.dlrs | array of object |
dlrs |
|
Message ID
|
data.dlrs.message_id | string |
Message ID |
|
To Number
|
data.dlrs.number | string |
Receptor's number |
|
Messages Sent
|
data.dlrs.messages_sent | integer |
Total messages to number |
|
Is in SMS Blacklist
|
data.dlrs.in_SMS_blacklist | boolean |
Determines if the contact is in the SMS Blacklist |
|
Callback URL
|
data.callback_url | string |
Callback URL |
|
Start Date
|
data.start_date | string |
Start Date |
Send Transactional Email
Send a Transactional email to your contacts using your custom templates from Mensagia.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
From
|
from | True | string |
An email address that will act as the sender. It must be a sending address created on the platform, or a sending address with a domain validated and authenticated on the platform. |
|
From Name
|
from_name | string |
Send this field if you want to use a different sender name than the one stored in a sending address on the platform if you will use one that is already created. |
|
|
To
|
to | True | string |
The email address to which the shipment is made. |
|
Subject
|
subject | True | string |
The subject to send. |
|
HTML
|
html | string |
The HTML to send. Required without Template parameter. |
|
|
Template
|
template_id | integer |
You can use an email template configured in your Mensagia account to obtain the HTML for sending. If this parameter is sent, the HTML parameter will be ignored. |
|
|
Send At
|
start_date | string |
Shipment date in the format 'YYYY-MM-DD hh:mm'. If you do not send this parameter, the sending will be made immediately. |
|
|
URL Parameters
|
url_parameters | string |
Tagging of links in the content of the email. |
|
|
Attachments
|
attachments | string |
A comma separated list of URLs with the files to attach. You can attach up to 5M in files. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
App Configuration ID
|
data.app_configuration_id | integer |
App Configuration ID |
|
Start Date
|
data.start_date | string |
Start Date |
|
Domain ID
|
data.domain_id | integer |
ID of the registered Domain from which the mail is sent. |
|
Sender Address ID
|
data.sender_address_id | integer |
Sender Address ID |
|
From
|
data.from | string |
Sender of the message. |
|
Sender Name
|
data.from_name | string |
Name of the person sending the message. |
|
Valid Emails
|
data.to.valids | array of string |
Valid Emails, |
|
Discarded Emails
|
data.to.discardeds | array of string |
Discarded Emails, |
|
Blacklisted Emails
|
data.to.blacklisteds | array of string |
Blacklisted, |
|
Subject
|
data.subject | string |
Subject of your email. |
|
attachments
|
data.attachments | array of string |
attachments |
Send Voice Message
This method allows you to carry out Voice campaigns to telephone numbers in Spain. The recipients of the voice campaign can be: agendas, agendas and telephone numbers, or telephone numbers.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
The name for the new voice campaign. |
|
Validated Phone
|
vm_validated_phone_id | True | integer |
The phone that will be used in this voice campaign. |
|
Type Locution
|
type | True | string |
The type of voiceover that will be used in this voice campaign. |
|
Message
|
message | string |
The text to be synthesized to reproduce in the call. Mandatory field if text2speech is the type of speech chosen. |
|
|
Message Language
|
message_language | string |
The code of the language with which you want to synthesize the text that will be reproduced in the call. Mandatory field if text2speech is the type of speech chosen. |
|
|
Voice File
|
voice_file_id | string |
The audio library file that will be used as a voiceover. Mandatory field if file is the type of speech chosen. |
|
|
Numbers
|
numbers | string |
A list of phone numbers separated by commas, without spaces and with the international prefix. |
|
|
Available Groups
|
available_groups | string |
List of contacts to whom the campaign will be sent. |
|
|
Call Timeout
|
vm_timeout | integer |
Maximum call duration in minutes. |
|
|
Max Retries
|
max_retries | integer |
Number of retries to perform if the recipient of the call does not answer. |
|
|
Minutes in retry 1
|
minutes_retry_1 | integer |
Interval in minutes in which the first retry will be made after the first call is not answered. This field is mandatory if "Max Retries" is greater than 1. |
|
|
Minutes in retry 2
|
minutes_retry_2 | integer |
Interval in minutes in which the first retry will be made after the first call is not answered. This field is mandatory if "Max Retries" is greater than 2. |
|
|
Minutes in retry 3
|
minutes_retry_3 | integer |
Interval in minutes in which the first retry will be made after the first call is not answered. This field is mandatory if "Max Retries" is greater than 3. |
|
|
Minutes in retry 4
|
minutes_retry_4 | integer |
Interval in minutes in which the first retry will be made after the first call is not answered. This field is mandatory if "Max Retries" is greater than 4. |
|
|
Ring Timeout
|
ring_timeout | integer |
Time in seconds in which the recipient's phone will ring for you to pick up the call. |
|
|
Response Codes
|
response_codes | string |
(JSON) Response codes that can be pressed by the recipient that will generate an action on the call. |
|
|
Response Codes Timeout
|
response_codes_timeout | integer |
Time in seconds in which the recipient will be able to press a reply code. This field is mandatory in the presence of 'Response Codes' |
|
|
Start Date
|
start_date | string |
Campaign start date in the format 'YYYY-MM-DD hh:mm'. If you don't send this parameter, the campaign will start two minutes after the creation of the new campaign. |
|
|
Calls per Block
|
callsxblock | integer |
Number of recipients per block. Mandatory in the presence of 'Minutes Per Block'. If the two parameters are sent, the campaign configuration is defined as 'custom configuration' and the value of the parameters 'Days' and 'Time Intervals' will be considered. |
|
|
Minutes per Block
|
minutesxblock | integer |
Every few minutes the block of recipients chosen in 'Calls Per Block' will be sent. Mandatory in the presence of 'Calls Per Block'. If the two parameters are sent, the campaign configuration is defined as 'custom configuration' and the value of the parameters 'Days' and 'Time Intervals' will be considered. |
|
|
Days
|
days | integer |
A list of days of the week separated by commas and without spaces on which calls can be made. (1,2,3,4,5,6,7) |
|
|
Time Intervals
|
time_intervals | string |
A list of time intervals separated by commas and without spaces, in which the call can be sent. It will only be taken into account if 'Minutes Per Block' and 'Calls Per Block' are sent.(hh:mm-hh:mm,hh:mm-hh:mm...) |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Sender name
|
data.configuration_id | integer |
Sender's header name |
|
Voice Campaign ID
|
data.id | integer |
Voice campaign ID |
|
Voice Campaign Name
|
data.name | string |
Voice's campaign name |
|
Is Campaign Active
|
data.active | integer |
Determines if the campaign is currently active |
|
State ID
|
data.state_id | integer |
Determines the sending status identification |
|
Status
|
data.state_name | string |
Status name |
|
Voice Message
|
data.message | string |
Body of the message sent |
|
Start Date
|
data.start_date | string |
Scheduled date for sending |
|
Validated Phone ID
|
data.vm_validated_phone_id | integer |
Validated phone ID to send the Campaign |
|
Validated Phone Number
|
data.vm_validated_phone_number | string |
Validated phone number |
|
Agendas
|
data.groups | array of object |
Agendas to which the campaign is directed. |
|
Agenda ID
|
data.groups.id | integer |
Group ID |
|
Agenda Name
|
data.groups.name | string |
Agenda Name |
|
Numbers
|
data.numbers | string |
Numbers to which the campaign is directed. |
|
Timeout
|
data.vm_timeout | integer |
Call's timeout |
|
Max Retries
|
data.max_retries | integer |
Maximum number of call's retries |
|
Minimum Retries Minutes
|
data.min_retry_minutes | integer |
Minimum minutes' interval to wait until the next try. |
|
Max Retries Minutes
|
data.max_retry_minutes | integer |
Maximum minutes' interval to wait until the next try. |
|
Response Codes
|
data.response_codes | array of object |
Response codes assigned to the call. |
|
Code
|
data.response_codes.code | string |
Code's name |
|
Action
|
data.response_codes.action | string |
Code's action |
|
Transfer To
|
data.response_codes.transfer_to | string |
Specifies the number to which the call will be redirected if necessary. |
|
Validated Phone ID
|
data.response_codes.vm_validated_phone_id | string |
Validated phone ID |
|
Response Codes Timeout
|
data.response_codes_timeout | string |
Response Codes Timeout |
|
Callback URL
|
data.callback_url | string |
Callback url |
|
Type
|
data.type | string |
Call's Type |
|
Calls per Block
|
data.callsxblock | integer |
Calls per Block |
|
Minutes per Block
|
data.minutesxblock | integer |
Minutes per Block |
|
Days Allowed
|
data.days_allowed | array of string |
Days allowed to send the voice campaign, |
|
Time Intervals Allowed
|
data.time_intervals_allowed | array of string |
Time intervals allowed to send the voice campaign, |
|
Voice Ring Timeout
|
data.ring_timeout | integer |
Maximum time in which the call ring will sound until the attempt is completed. |