SMS Gateways: Connect Your SMS Provider

​

Outbound SMS Dispatch Pipeline

​

The ISmsMarketingProvider Contract

export interface ISmsMarketingProvider {
  readonly providerType: SmsProviderType;
  
  // Validates API credentials and checks account status
  validate(credentials?: SmsProviderCredentials): Promise<boolean>;
  
  // Lists verified sender IDs, headers, and long numbers
  listSenderNumbers(credentials?: SmsProviderCredentials): Promise<DiscoveredSenderNumber[]>;
  
  // Sends a single or batched SMS message
  sendSms(options: SendSmsOptions, credentials?: SmsProviderCredentials): Promise<SendSmsResult>;
  
  // Parses delivery status reports (DLR)
  parseDeliveryWebhook(headers: Record<string, any>, body: any): SmsWebhookEvent[];
  
  // Parses two-way inbound customer replies
  parseInboundWebhook(headers: Record<string, any>, body: any): InboundSmsPayload | null;
}

​

Supported SMS Gateway Packages

​

Character Encoding & Segment Calculation

• GSM 7-bit Encoding: Standard alphanumeric characters. Up to 160 characters in a single message. Concatenated messages use 153 characters per segment (7 characters reserved for UDH headers).
• UCS-2 (Unicode) Encoding: Used when emojis, currency symbols (such as the Indian Rupee symbol ₹), or non-Latin scripts (Hindi, Arabic, etc.) are present. Single messages are capped at 70 characters. Concatenated messages use 67 characters per segment.

​

Indian Telecom DLT Compliance (TRAI Mandate)

1. Entity Registration: Register your brokerage business on a telecom DLT portal (such as Airtel, Jio, or Vodafone Idea) to receive an Enterprise Entity ID (dltEntityId).
2. Sender Header Registration: Register a 6-character alphabetic header (e.g., SKYLIN or BRKROS).
3. Content Template Registration: Pre-register marketing and transactional message text with dynamic variable syntax {#var#} to receive a Content Template ID (dltTemplateId).
4. Execution in BrokerOS: Configure your Entity ID and Template ID in the SMS Template Registry (/dashboard/marketing/sms/templates). Messages dispatched without an approved DLT template ID are automatically rejected by Indian telecom switchboards.

​

Setting Up an SMS Gateway

1. In the BrokerOS dashboard, navigate to Dashboard -> Marketing -> SMS -> Settings -> Gateway Integrations.
2. Click Add SMS Gateway and select your desired provider.
3. Enter your API credentials (API key, Account SID, or secret token).
4. Configure your primary Sender ID or Virtual Long Number.
5. Click Verify Gateway: BrokerOS performs an automated API handshake and confirms active status.
6. The verified gateway becomes instantly selectable in the Campaign Wizard and SMS Flows Builder.