Compartilhar via


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/
Email 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

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
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.