OS1 Services
Messaging and Mobile Push Notifications
15min
introduction the messaging service empowers developers by enhancing and streamlining communication across various channels and applications the messaging apis focus on integrating messaging and notification features into apps, supporting multiple communication channels such as sms, email, and whatsapp with customizable templates and multiple service provider options, developers can tailor their messaging solutions to their needs as a subset of the messaging service, the mobile push notifications apis handle push notifications for ios and android based mobile apps while both apis aim to improve communication, the messaging apis target integration across with email, sms, and whatsapp channels in contrast, the mobile push notifications apis focus specifically on delivering notifications to ios and android mobile apps messaging apis messages the send messages apis enable applications to send single and bulk messages using various channels such as sms, email, or whatsapp these apis allow sending single or bulk messages, with the ability to specify templates and placeholders for dynamic content in addition to one way messaging, the apis also support two way messaging, enabling interactive conversations between the application and recipients with the sendtwowaymessage api, developers can send messages that expect a response from the recipient the api allows defining accepted responses and corresponding webhooks to handle each specific response it also supports specifying a default webhook for handling unmatched responses and a timeout for how long responses will be accepted api sendmessages send single or bulk sms, email, and whatsapp messages sendmessagenotifications send one way notification messages to multiple recipients sendtwowaymessages send two way messages and receive responses via callbacks service provider management the service provider management apis enable developers to register and manage external messaging providers, such as amazon pinpoint, aws ses ,and infobip these apis offer capabilities like registering new providers, listing available providers, updating provider configuration, and specifying default provider configuration for tenants apis registerserviceproviders registers new service providers updateserviceproviders updates or deactivates service providers getserviceprovidertypes gets the details of all service provider types supported by the messaging service getserviceprovidertype gets details of a single service provider type getserviceproviders gets all service provider configurations for a tenant getserviceprovider gets a single service provider configuration by name templates management the templates management apis enable app developers to create, update, retrieve, and delete reusable message templates that allow for dynamic content injection using placeholders at both the tenant and app level some of the key capabilities of these apis include registering templates with parameters such as name, body, and supported channels and listing and retrieving existing templates these apis also provide the option to update template status and content apis createtemplate creates a new message template getalltemplates gets all message templates for a tenant gettemplate gets a single template by name updatetemplate updates an existing template updatedefaultexternalref update default external ref for template template as active/inactive tenant config management the tenant configuration management apis enable business administrators to personalize messaging provider configuration and business rules for a tenant these apis allow administrators to register tenant specific settings such as sender ids, footer texts, email domains, etc they also allow the retrieval of the tenant configuration, updating tenant specific business rules and provider activation status per channel, and deleting existing configurations apis registertenantconfig registers the tenant specific configuration updatetenantconfig updates the existing tenant configuration gettenantconfig gets the tenant's configured business rules and settings metering the metering api enables developers to retrieve usage data metrics for messages sent through the platform, sorted by tenant this feature allows message send counts to be broken down by various metrics such as templates, channels, date ranges, and status api getstatistics get the statistics for messages sent notification management createmessagenotification create notification templates getmessagenotifications get list of notifications based on app and mode updatemessagenotificationtemplate update template associated with notification getmessagenotificationdetails get notification group updatemessagenotificationmodes enable or disable modes for the notification mobile push notifications apis developers can use the mobile push notification api endpoints to perform the following operations for app and device registration for mobile notifications mobile app registration registermobileappnotification register a new mobile app notification getallregisteredmobileapps retrieve the details for all registered apps getregisteredmobileapp retrieve the details of a specific app by id updatemobileappregistration update the app notification configuration by id mobile app configuration registration registerappnotificationconfig register an app notification configuration getappnotificationconfig retrieve the app notification configuration by id updateappnotificationconfig update the app notification configuration send mobile push notifications sendmobilepushnotifications send mobile push notifications to android or ios users event deprecating push event ap by end of may deprecating push event ap by end of may the push event to kafka endpoint will be deprecated by the end of may we recommend that developers use the sendmobilepushnotifications endpoint pushevent forward an event to kafka