Поделиться через

Mensagia (Preview)

  • Reference

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 [email protected]
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

Operation ID:
CreateContact

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

Operation ID:
Get2WaySmsMessages

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

Operation ID:
Get2WaySms

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

Operation ID:
Send2WaySms

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

Operation ID:
SendSms

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

Operation ID:
SendSmsCampaigns

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

Operation ID:
SendTransactionalEmail

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

Operation ID:
SendVoiceMessage

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.