Skip to main content

Dergosms Integration

Dergosms is a regional SMS provider available in Kosovo. It delivers SMS messages within Kosovo and is used for OTP phone number verification by Spaaza chains operating in Kosovo.

Contents​

Webhook Configuration​

Webhook config type: dergosms

To configure Dergosms as the SMS provider for a chain, create a webhook configuration with type set to dergosms and event_name set to phone_number_verification. See Configuring an SMS Provider for the general setup steps.

Credentials​

The following fields must be set in the webhook configuration:

  • password — Dergosms authorization token (these tokens do not expire)
  • url — the Dergosms API endpoint URL
  • send_from — the sender name displayed on the SMS

Phone Number Format​

Dergosms requires Kosovo-format phone numbers:

  • No + prefix
  • Must start with the Kosovo country code 383
  • Exactly 11 digits total (e.g. 38344123456)

API Details​

The integration sends a JSON POST request to the configured URL with the following payload structure:

{
  "numbers": ["38344123456"],
  "sendFrom": "SenderName",
  "sendText": "Phone number verification: 123456. This code is valid for a limited time..."
}

Authentication is via an Authorization header containing the token.