How iPaaS.com Thinks About Messages
"Messages" covers two related but distinct things in iPaaS.com. It's worth being clear which one you mean, because they behave differently.
1. The Message record - internal notifications
A Message record is a platform-internal notification that surfaces in the iPaaS.com inbox: errors, each with a type (Transfer, Event, Billing Notification, System Status, Other) and a severity (Verbose, Info, Warning, Error, Critical). Also known as a Notification or Alert.
These are set programmatically by integration or platform code, not configured through subscriber mapping collections.
They are an output/alerting surface - a place operators read exceptions - not a data type you map inbound third-party records onto, and not email or SMS.
Typical use: an integration raises a Warning or Error when a transfer errors, so an operator sees it in the inbox and can act.
2. Cross-system messaging - the Messages API service
Separately, iPaaS.com can broadcast message content from the platform out to third-party systems - for example, routing errors to Slack or Microsoft Teams. This is handled by the Messages API service and is how message content moves between connected systems.
Which is which: the Message record is where you read platform alerts (the in-app inbox). The Messages API service is how iPaaS.com sends message content out to other systems. Same word, two mechanisms.
Related concepts: REST API: Swagger/OpenAPI Reference Guide (Messages service). See also Data Domains.
Background
Messages transmit message-style content between systems and log errors for external notification systems like Slack and Teams.
To view the Messages page, click Data Management > Messages. Here, you can view errors and other messages listed by Name, Type, Description, and Actions.
You can filter messages, search by an external ID, or add messages.
iPaaS.com displays all messages at the bottom of the page.
NOTE: Messages expire based on a system-set expiration date. Error messages expire 24 hours after creation.
The Messages Page
Adding Messages
To add a message:
On the Messages form, click Add Message.
Use the Type dropdown to select the message type, such as Transfer or Other.
Select the severity from the Severity dropdown. Choices are Verbose, Info, Warning, Error, None, or Critical. Select Error if it is a Transfer message. Select Other for non-error message types.
Enter the message text. This is the text displayed on the Messages page. If the Type is Error, the message also appears in the Error Logs.
And any detail in the Details box. For example, add how to fix the error or whom to contact.
Click Apply, and the error will appear on iPaaS.com.
NOTE: The system allows you to enter duplicate messages. In that case, the original and duplicate messages will appear in the messages list.
Editing Messages
You can edit messages and add custom fields and external IDs.
To edit a message:
On the Messages page, click the edit icon under Actions.
Make any changes to the Type, Severity, Text, or Detail.
(Optional) You can add or edit Custom Fields and External IDs. See Custom Fields and External IDs for those procedures.
When complete, click Apply, and the record is updated.
NOTE: Error messages have additional fields.
Additional Fields for Error Messages
Error messages include an Open Link button, which opens a new browser tab to the Activity Logger Details page. The message includes a JSON section for the error that you can use for troubleshooting and a Detail Fields and Links section, with a link to the Activity Logger Details page.
