Messaging
Netgsm integration: İYS-filtered SMS campaigns and notification texts
Add SMS to OrqLabs with your Netgsm user code, API password and approved sender header. Campaigns go to lead segments at a controlled rate, commercial texts are sent with the İYS filter and delivery reports update each message.
- Connection type
- Username / password
- Scope
- Per organization: all projects share one key
- Capabilities
- send messages, broadcast
- Setup time
- 10 min
What it does in OrqLabs
The Netgsm integration uses Netgsm's REST v2 API. You enter your user code, the password of a user with API access and your approved sender header; Test connection lists the approved headers on the account and checks that yours is one of them. Numbers are converted to 905XXXXXXXXX automatically.
The İYS mode decides which messages go out as commercial: by default campaign messages use the İYS filter for consumers (iysfilter=11) while one-off notifications go out as informational. You can pick 12 for merchant (B2B) sends, or an unfiltered mode for accounts that only send notifications.
Delivery reports are queried from Netgsm every 5 minutes, so messages and campaign stats become delivered or failed with a reason (İYS rejection, blacklist, expiry). With the İYS integration connected, recipients without consent are left out of campaigns entirely.
What you can automate
SMS campaigns
Send personalised texts – with fields such as name and company – to a segment of leads who have a phone number and haven't opted out; messages are queued at 20 per minute by default.
Order and appointment notices
Pick the SMS – Netgsm channel in the Send message node to send order, shipping or appointment reminders one by one.
Delivery tracking
Each text keeps its Netgsm job id; as delivery reports arrive, the message and campaign statuses are updated.
Agents that work with it
AI Chatbot
Auto-replies on WhatsApp, Telegram, Messenger and more
Outreach Agent
Personalised first-touch and follow-up sequences
Nodes that use this integration
In the workflow editor these nodes run with your Netgsm SMS account.
Send message
Sends a message to one person on WhatsApp, Telegram, SMS and more, e.g. delivering a chatbot reply or an appointment reminder.
Broadcast campaign
Sends a personalised message to a group of leads at a controlled pace, e.g. announcing a webinar to qualified leads.
Setup at a glance
In the Netgsm panel, note the user code and password of the user with API access and copy your approved header.
In OrqLabs, go to Integrations → Netgsm SMS → Connect, enter the user code, password and header, and pick the İYS mode.
Use Test connection to confirm your header is approved.
Send a test text to your own number with the Send message node (channel SMS – Netgsm).
Requirements
- A Netgsm subscription, an SMS package and a user with API access.
- An approved sender header (sender name) on Netgsm.
- For commercial texts, an İYS brand set up on your Netgsm account – and consent recorded in İYS for commercial messages to consumers (Turkish Law No. 6563).
What you enter when connecting
- Kullanıcı kodu *
- API şifresi *
- Mesaj başlığı (gönderici adı) *
- İYS modu (ticari ileti)
Good to know
- This integration is one-way: texts sent with an alphanumeric header can't be replied to, and incoming SMS don't reach the Inbox.
- Delivery reports are polled every 5 minutes, not in real time.
- Netgsm charges SMS fees directly to your own account.
Frequently asked questions
Why do campaign texts fail with "İYS rejection"?
For commercial sends, Netgsm doesn't deliver to numbers without consent in İYS. Record the recipient's consent in İYS or remove them from the campaign.
Are notifications and OTP texts filtered by İYS too?
Not in the default İYS mode: one-off messages go out as informational, and only campaign messages count as commercial.
Can I use it alongside Twilio?
Yes. With the SMS channel one of your connected SMS accounts is used; choose SMS – Netgsm to always use Netgsm.
Get started with OrqLabs
Build your first workflow today
Start on the free plan: connect your accounts, pick a template and stay in control with approval steps. No credit card required.