Sosyomaks

Config

Field	Type	Required	Default	Notes
provider	sosyomaks	✅ Yes	—	Selects Sosyomaks (SMS MAX) provider.
username	string	✅ Yes	—	Sosyomaks account email address.
password	string	✅ Yes	—	Sosyomaks account password.
originator	string	✅ Yes	—	Approved SMS sender name (must be registered in your account).
apiUrl	string	❌ No	https://www.sosyomaks.com/api/send/post	API endpoint override.

note

Phone numbers should be sent without leading zero (e.g., 5321234567 ✅, not 05321234567 ❌).

Originator Registration

The originator (sender name) must be registered and approved in your Sosyomaks account. Using an unapproved originator will result in error code 06.

Response Handling

Success Response

• Format: ID: 12345678
• Returns the message ID on successful delivery

Error Codes

Code	Description
01	Invalid username, password, or dealer code
02	Insufficient credit or unpaid invoice balance
03	Undefined Action parameter
05	Missing or invalid XML node
06	Undefined originator (sender name)
07	Missing message code (ID)
09	Invalid date fields
10	SMS could not be sent

Turkish Character Support

The module automatically supports Turkish characters. The Action parameter is sent as 0 to the API, enabling proper handling of Turkish characters without additional configuration.