Notification ServiceNotification Service Settings
Notification Service

Notification Service Settings

Configuration options for the Notification Service, including providers and integration settings for email, SMS, and push notifications.

MPO Version: 1.3.0

Defines the basic notification configuration for the project. This includes the notification options providers for different notification channels such as SMS, email, and push notifications.

interface NotificationServiceSettings = {
  serviceOptions : NotificationServiceOptions;
  smtpSettings : SmtpSettings;
  amazonSNSSettings : AmazonSNSSettings;
  firebaseSettings : FirebaseSettings;
  sendGridSettings : SendGridSettings;
  twilioSettings : TwilioSettings;
  vonageSettings : VonageSettings;
  netGsmSettings : NetGSMSettings;
  oneSignalSettings : OneSignalSettings;
}
FieldDescription
serviceOptionsDefines the global notification configuration for the project. This includes providers for different notification channels and the list of event-driven notification behaviors triggered by Kafka messages.
smtpSettingsSettings for using a custom SMTP server to send emails. Mindbricks includes a managed SMTP server by default. Override this setting if you want to use your own provider.
amazonSNSSettingsSettings for integrating Amazon SNS for messaging and notifications. Mindbricks does not provide a managed SNS setup, so you must supply your own credentials if you choose to use this service.
firebaseSettingsSettings for using Firebase services. Mindbricks does not include Firebase by default, so this setup is required only if Firebase will be used for messaging or real-time features.
sendGridSettingsSettings for integrating SendGrid to send transactional or notification emails. You must register a SendGrid account and provide your API key.
twilioSettingsSettings for using Twilio to send SMS or perform voice operations. Mindbricks does not provide a managed Twilio account, so integration must be configured here.
vonageSettingsSettings for integrating Vonage as an SMS provider. Provide credentials for your Vonage account if this service is used.
netGsmSettingsSettings for using the Turkish SMS provider NetGSM. You must supply your own credentials to use this service in Mindbricks.
oneSignalSettingsSettings for OneSignal push notifications. Mindbricks does not manage OneSignal accounts, so a valid app ID and API key must be provided.

NotificationServiceOptions

MPO Version: 1.3.0

Defines the global notification configuration for the project. This includes providers for different notification channels and the list of event-driven notification behaviors triggered by Kafka messages.

interface NotificationServiceOptions = {
  storedNotice : Boolean;
  smsProvider : SmsProvider;
  emailProvider : EmailProvider;
  pushProvider : PushProvider;
}
FieldDescription
storedNoticeDetermines whether notifications will be persisted and listed within the app. If set to true, notifications are stored in the database and can be retrieved later. If false, notifications are sent transiently during the request cycle and are not stored. Disabling storage can improve performance in simple use cases where tracking historical notifications is unnecessary.
smsProviderSpecifies the SMS provider for project-level notifications. Supported values: amazonsns, fake, netgsm, twilio, vonage.
emailProviderSpecifies the email provider for project-level notifications. Supported values: amazonsns, fake, sendgrid, smtp.
pushProviderSpecifies the push notification provider for the project. Supported values: amazonsns, fake, firebase, onesignal.

SmsProvider

Defines valid SMS providers for project-wide notifications.

const SmsProvider = {
  amazonsns: "amazonsns",
  fake: "fake",
  netgsm: "netgsm",
  twilio: "twilio",
  vonage: "vonage",
};
EnumDescription
amazonsnsUse Amazon SNS for SMS delivery.
fakeUse a mock provider for development/testing.
netgsmUse NetGSM as an SMS gateway (common in Turkey).
twilioUse Twilio for SMS notifications.
vonageUse Vonage (formerly Nexmo) for SMS notifications.

EmailProvider

Defines valid email providers for project-wide notifications.

const EmailProvider = {
  amazonsns: "amazonsns",
  fake: "fake",
  sendgrid: "sendgrid",
  smtp: "smtp",
};
EnumDescription
amazonsnsUse Amazon SNS for sending emails.
fakeUse a mock provider for development/testing.
sendgridUse SendGrid for transactional or bulk email.
smtpUse a custom SMTP server for email delivery.

PushProvider

Defines valid push notification providers for project-wide delivery.

const PushProvider = {
  amazonsns: "amazonsns",
  fake: "fake",
  firebase: "firebase",
  onesignal: "onesignal",
};
EnumDescription
amazonsnsUse Amazon SNS to deliver push notifications.
fakeUse a mock provider for development/testing.
firebaseUse Firebase Cloud Messaging (FCM) for push notifications.
onesignalUse OneSignal for cross-platform push delivery.

SmtpSettings

MPO Version: 1.3.0

Defines configuration for using a custom SMTP server to send emails. Mindbricks uses a managed cloud provider by default, but you may configure your own server here.

interface SmtpSettings = {
  useCustomSmptServer : Boolean;
  configuration : SmtpSettingsConfig;
}
FieldDescription
useCustomSmptServerSpecifies whether a custom SMTP server should be used.
configurationThe configuration object for the SMTP server. Leave it null if useCustomSmptServer is false.

SmtpSettingsConfig

MPO Version: 1.3.0

Defines the configuration for a custom SMTP server. This object is used when useCustomSmptServer is set to true. It includes the host, port, authentication, and security details.

interface SmtpSettingsConfig = {
  emailFrom : String;
  emailHost : String;
  emailPort : Integer;
  emailUser : String;
  emailPass : String;
  isSecure : Boolean;
}
FieldDescription
emailFromThe default sender email address used in outgoing messages.
emailHostThe hostname of the SMTP server.
emailPortThe port number used by the SMTP server.
emailUserThe username used for SMTP authentication.
emailPassThe password used for SMTP authentication.
isSecureIndicates whether the SMTP server connection should use SSL/TLS.

AmazonSNSSettings

MPO Version: 1.3.0

Defines configuration for integrating Amazon SNS for messaging and notifications. Mindbricks does not provide a managed SNS setup, so you must supply your own credentials if you choose to use this service.

interface AmazonSNSSettings = {
  useAmazonSNS : Boolean;
  configuration : AmazonSNSSettingsConfig;
}
FieldDescription
useAmazonSNSSpecifies whether Amazon SNS should be enabled for the project.
configurationThe configuration object for the Amazon SNS service. Leave it null if useAmazonSNS is false.

AmazonSNSSettingsConfig

MPO Version: 1.3.0

Defines the configuration for Amazon SNS. This object is used when useAmazonSNS is set to true. It includes the secret key, access key, and region.

interface AmazonSNSSettingsConfig = {
  secretKey : String;
  accessKey : String;
  region : String;
}
FieldDescription
secretKeyThe secret access key for the Amazon SNS service.
accessKeyThe access key ID for the Amazon SNS service.
regionThe AWS region in which the SNS service is hosted.

FirebaseSettings

MPO Version: 1.3.0

Defines configuration for using Firebase services. Mindbricks does not include Firebase by default, so this setup is required only if Firebase will be used for messaging or real-time features.

interface FirebaseSettings = {
  useFirebase : Boolean;
  configuration : FirebaseSettingsConfig;
}
FieldDescription
useFirebaseSpecifies whether Firebase should be enabled.
configurationThe configuration object for the Firebase service. Leave it null if useFirebase is false.

FirebaseSettingsConfig

MPO Version: 1.3.0

Defines the configuration for Firebase. This object is used when useFirebase is set to true. It includes the API key for Firebase services.

interface FirebaseSettingsConfig = {
  firebaseKey : String;
}
FieldDescription
firebaseKeyThe API key used to access Firebase services.

SendGridSettings

MPO Version: 1.3.0

Defines configuration for integrating SendGrid to send transactional or notification emails. You must register a SendGrid account and provide your API key.

interface SendGridSettings = {
  useSendGrid : Boolean;
  configuration : SendGridSettingsConfig;
}
FieldDescription
useSendGridSpecifies whether SendGrid is enabled for the project.
configurationThe configuration object for the SendGrid service. Leave it null if useSendGrid is false.

SendGridSettingsConfig

MPO Version: 1.3.0

Defines the configuration for SendGrid. This object is used when useSendGrid is set to true. It includes the API key and sender email address.

interface SendGridSettingsConfig = {
  sendGridApiKey : String;
  sendGridFromEmail : String;
}
FieldDescription
sendGridApiKeyThe API key used to authenticate with the SendGrid service.
sendGridFromEmailThe sender email address to be used for outgoing messages.

TwilioSettings

MPO Version: 1.3.0

Defines configuration for using Twilio to send SMS or perform voice operations. Mindbricks does not provide a managed Twilio account, so integration must be configured here.

interface TwilioSettings = {
  useTwilio : Boolean;
  configuration : TwilioSettingsConfig;
}
FieldDescription
useTwilioSpecifies whether Twilio is enabled.
configurationThe configuration object for the Twilio service. Leave it null if useTwilio is false.

TwilioSettingsConfig

MPO Version: 1.3.0

Defines the configuration for Twilio. This object is used when useTwilio is set to true. It includes the Account SID, authentication token, and sender identity.

interface TwilioSettingsConfig = {
  twilioAccountSid : String;
  twilioAuthToken : String;
  twilioSender : String;
}
FieldDescription
twilioAccountSidThe Account SID for your Twilio service.
twilioAuthTokenThe authentication token used with your Twilio account.
twilioSenderThe default sender identity (phone number or name) for Twilio messages.

VonageSettings

MPO Version: 1.3.0

Defines configuration for integrating Vonage as an SMS provider. Provide credentials for your Vonage account if this service is used.

interface VonageSettings = {
  useVonage : Boolean;
  configuration : VonageSettingsConfig;
}
FieldDescription
useVonageSpecifies whether Vonage is enabled.
configurationThe configuration object for the Vonage service. Leave it null if useVonage is false.

VonageSettingsConfig

MPO Version: 1.3.0

Defines the configuration for Vonage. This object is used when useVonage is set to true. It includes the token and sender name/number.

interface VonageSettingsConfig = {
  vonageToken : String;
  vonageSender : String;
}
FieldDescription
vonageTokenThe token used to authenticate with the Vonage service.
vonageSenderThe sender name or number used for Vonage messages.

NetGSMSettings

MPO Version: 1.3.0

Defines configuration for using the Turkish SMS provider NetGSM. You must supply your own credentials to use this service in Mindbricks.

interface NetGSMSettings = {
  useNetGSM : Boolean;
  configuration : NetGSMSettingsConfig;
}
FieldDescription
useNetGSMSpecifies whether NetGSM is enabled for the project.
configurationThe configuration object for the NetGSM service. Leave it null if useNetGSM is false.

NetGSMSettingsConfig

MPO Version: 1.3.0

Defines the configuration for NetGSM. This object is used when useNetGSM is set to true. It includes the username, password, and sender ID.

interface NetGSMSettingsConfig = {
  netGsmUsername : String;
  netGsmPassword : String;
  netGsmSender : String;
}
FieldDescription
netGsmUsernameThe username used to authenticate with NetGSM.
netGsmPasswordThe password used to authenticate with NetGSM.
netGsmSenderThe sender ID or label used for NetGSM messages.

OneSignalSettings

MPO Version: 1.3.0

Defines configuration for OneSignal push notifications. Mindbricks does not manage OneSignal accounts, so a valid app ID and API key must be provided.

interface OneSignalSettings = {
  useOneSignal : Boolean;
  configuration : OneSignalSettingsConfig;
}
FieldDescription
useOneSignalSpecifies whether OneSignal is enabled for push notifications.
configurationThe configuration object for the OneSignal service. Leave it null if useOneSignal is false.

OneSignalSettingsConfig

MPO Version: 1.3.0

Defines the configuration for OneSignal. This object is used when useOneSignal is set to true. It includes the app ID and REST API key.

interface OneSignalSettingsConfig = {
  oneSignalAppId : String;
  oneSignalApiKey : String;
}
FieldDescription
oneSignalAppIdThe OneSignal application ID for the target app.
oneSignalApiKeyThe REST API key for the OneSignal project.
Was this page helpful?
Built with Documentation.AI

Last updated today