Skip to content
Last updated

Reseller customization

A reseller is the top-level organizational unit in Namirial Notify. Each reseller represents a branded instance of the platform and owns one or more customer sites. Reseller configuration controls the visual identity, communication defaults, and service capabilities available to all sites under that reseller.


Identity fields

Each reseller has the following core identity properties:

FieldDescription
NameUnique internal identifier for the reseller
DomainWeb domain used for the reseller's application (e.g. notify.example.com)
Email domainDomain used for platform-sent email (e.g. example.com)
External IDOptional external reference identifier
Legal IDOptional legal or tax identifier

Branding and theme

Each reseller defines a visual theme applied across the web interface and outbound communications.

Reseller theme values are currently managed operationally through database configuration, not through a self-service reseller UI.

AttributeDescription
Theme logoBinary image used as the service logo
Primary colorMain brand color (hex or CSS value)
Secondary colorSupporting brand color
Success colorColor used for success states
Info colorColor used for informational states
Warning colorColor used for warning states
Danger colorColor used for error or danger states

Service settings

Reseller-level settings provide defaults for all sites in the reseller. The exact override precedence depends on your deployment configuration. Contact your Namirial representative to confirm which settings are configurable for your reseller environment. The following settings are defined in the reseller configuration:

Reseller configuration is API-first. Use Core API endpoints under /resellers/{name} (for example config and feature endpoints) to manage supported reseller settings.

Identity and communication

Setting keyDescription
ApplicationUrlBase URL of the reseller web application
ApplicationEmailSystem email address for the reseller instance
SupportEmailSupport contact address shown to users
CommsEmailAddress used for general platform communications
ServiceNameDisplay name for the white-labeled service
CompanyLegalNameLegal name of the operating company
CompanyLegalIdLegal or tax identifier of the operating company
CompanyLegalRegInfoLegal registration details
ProgressNotificationsEmailEmail address used for platform progress notifications, if configured.

Email (EviMail)

Setting keyDescription
EviMail:DefaultFromAddressDefault FROM address for outbound EviMail messages
EmailAddSenderWhether sender address is included in outgoing email
EmailOverrideFromWhether the FROM address can be overridden at send time

SMS (EviSMS)

Setting keyDescription
EviSmsDefSourcePhoneDefault source phone number for EviSMS
EviSmsForwardProfileSMS forwarding profile identifier
EviSmsHeaderText prepended to outbound SMS bodies
EviSmsFooterText appended to outbound SMS bodies
EviSms:RcsSendProfileRCS send profile for EviSMS (when RCS is enabled)

EviNotice

Setting keyDescription
EviNotice:SmsProfileSMS delivery profile for EviNotice
EviNotice:SourcePhone:DefaultDefault source phone for EviNotice SMS
EviNotice:AddSenderWhether the sender is included in EviNotice communications
EviNotice:OverrideFromWhether the FROM can be overridden for EviNotice
EviNotice:RcsSendProfileRCS send profile for EviNotice (when RCS is enabled)

EviSign

Setting keyDescription
EviSignProfileSignature profile identifier for EviSign

Authentication and security

Setting keyDescription
MobilePinProfileProfile used for mobile PIN delivery
WhatsAppProfileProfile used for WhatsApp PIN delivery
System:SecondFactor:Email:TemplateTemplate for second-factor authentication requests

These settings are locale-aware. A key such as FloatFooter accepts both a default value (culture *) and culture-specific overrides (e.g. en, es, it, de, fr, pt, ca, ro).

Setting keyDescription
CookiesPolicyUrlURL to the reseller's cookie policy page
GeneralDataProtectionRegulationURL to the GDPR information page
GeneralLegalTermsUrlURL to the general terms and conditions
NewUserAgreementUrlURL to the user registration agreement
FloatFooterHTML or text content for the floating footer shown across the web UI
EviNotice:QERDS:ES:TermsAndConditions:Acceptance:TextQERDS terms acceptance text for Spain (per locale)
EviNotice:QERDS:IT:TermsAndConditions:Acceptance:TextQERDS terms acceptance text for Italy (per locale)

Enabled certification levels

Resellers can restrict which certification levels are available on their sites. Certification levels can be configured per service:

  • EviMail certification levels
  • EviSMS certification levels
  • EviNotice certification levels
  • EviSign certification levels
  • EviPost certification levels

Restricting available levels at the reseller prevents sites from enabling certification levels the reseller is not contractually authorized to offer.


White-label linkage

A reseller can be associated with a white-label configuration via the WhiteLabelId attribute. This links the reseller to an external white-label record used for additional branding or integration configuration.


Forwarding domains and email authentication

To allow sites under a reseller to send EviMail from custom sender addresses, each sender domain must be registered and verified at the site level. Domain verification requires the DNS records provided during onboarding to be in place.

The specific DNS records required for your deployment — including SPF include entries and DKIM CNAME records — are provided by your Namirial representative during onboarding. The domain verification UI guides you through verifying that the required records are in place.

Alternatively, a custom DKIM selector can be registered. The platform returns the TXT record value containing the public key.

Domain verification is performed in the site administration UI under the domain management section. Only site administrators can register domains. Domain status values include Active, New, Failed, Disabled, Deleting, and Legacy. In the UI, New may be shown as Pending and Deleting may be shown as Pending removal. Domains can be used for sending only when their source state allows sending.