## SMS integration

The system supports sending SMS messages to customers through two providers: **SerwerSMS** and **SMSAPI**. Each provider is configured separately.

Configuration is available under **Configuration → Modules → SerwerSMS** and **Configuration → Modules → SMSAPI**.

## SerwerSMS

| Field | Description |
|---|---|
| SerwerSMS enabled | Activates or deactivates the integration |
| API token | Token generated in the SerwerSMS Customer Panel under Settings → Interfaces → HTTPS API → API Tokens |
| Sender | SMS sender name (FULL SMS); allowed names are added in the SerwerSMS Customer Panel |
| Remove Polish characters | Replaces Polish diacritic characters with ASCII equivalents before sending |

## SMSAPI

| Field | Description |
|---|---|
| SMSAPI enabled | Activates or deactivates the integration |
| API token | Token generated in the SMSAPI Customer Panel under Settings → Interfaces → HTTPS API → API Tokens |
| Sender | Defines the message type and sender field: a custom name (Pro), `2way`, or `ECO`; leaving empty uses the default type and sender; only names verified in the SMSAPI panel are accepted |
| Remove Polish characters | Replaces Polish diacritic characters with ASCII equivalents before sending |

## Sending SMS

Once the integration is configured, SMS is available as an action in **business rules** — when adding a **Send SMS** action, you select the provider and the message template.

---

## FAQ

### Which SMS provider is recommended?
Both providers are fully supported. The choice depends on your existing account and pricing preferences.

### Can I configure both providers at the same time?
Yes. The modules are independent — you can enable both. When adding an SMS action to a business rule, you select the specific provider.

### Where do I find the API token?
The API token is generated in the provider's customer panel: SerwerSMS → Settings → Interfaces → HTTPS API → API Tokens; SMSAPI — the same path.

### Why is there a "Remove Polish characters" option?
SMS messages containing Polish characters (ą, ę, ó, etc.) are encoded in UCS-2, which reduces the character limit to 70 per message part. Removing diacritics keeps the 160-character limit and reduces sending costs.

### Can SMS messages be sent automatically?
Yes. SMS is available as an action in business rules — for example to automatically notify a customer when an issue step changes.

### How do I verify that an SMS was sent?
Message history is visible on the issue details page in the history section. Detailed delivery logs may also be available in the provider's customer panel.
