Search by

kwtsms / kwtsms-krayin

kwtsms

kwtSMS for Krayin CRM: send SMS from workflows

Package info

github.com/kwtsms/kwtsms-krayin

pkg:composer/kwtsms/kwtsms-krayin

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-11-06 23:06 UTC

This package is auto-updated.

Last update: 2026-11-08 03:25:20 UTC


README

Send SMS from Krayin CRM workflows through kwtSMS, the SMS gateway for Kuwait and the Gulf.

Features

  • A new workflow action, Send SMS to person, for lead and person workflows (created, updated, and any condition Krayin workflows support).
  • The text uses Krayin's own placeholders, for example {%leads.title%} or {%persons.name%}.
  • Sends to the person's first contact number (a number labelled "mobile" wins when there is one).
  • English and Arabic. Test mode: queued on kwtSMS, never delivered; their credits are held until you delete them from the Sending Queue in your kwtSMS account.
  • A failed SMS never stops the workflow; it is written to the Laravel log.
  • The API password is stored encrypted and never shown again on the settings page (Krayin itself keeps settings in plain text, so the module moves the password to an encrypted entry when you save).

Requirements

  • Krayin CRM 2.x (tested on 2.2.0; Laravel 12, PHP 8.3).
  • A kwtSMS account with API access. Free test account.

Installation

composer require kwtsms/kwtsms-krayin
php artisan optimize:clear

Setup

  1. Go to Settings > Configuration > kwtSMS and enter the API username and password of your kwtSMS account (not your mobile number), your Sender ID (default KWT-SMS) and, for a first try, turn on test mode.
  2. Go to Settings > Automation > Workflows, create or edit a workflow for Leads or Persons, add the action Send SMS to person and type the SMS text.

Phone numbers on persons should be in international format, for example 965XXXXXXXX.

Arabic

Arabic messages are sent as Unicode: one SMS page holds 70 Arabic characters, against 160 English ones. Keep Arabic texts short to save credits.

Troubleshooting

Failed messages are logged as [kwtSMS] workflow SMS failed with the kwtSMS error code: ERR003 wrong API login, ERR010 zero balance, ERR008 banned Sender ID, ERR024 the server IP is not in your kwtSMS API IP whitelist.

Development

php tests/run.php     # unit tests with Krayin stand-ins, no network

Support

Help: https://www.kwtsms.com/support.html | FAQ: https://www.kwtsms.com/faq/ | support@kwtsms.com

Security

See SECURITY.md.

License

MIT, (c) kwtSMS