Practical, step-by-step guides for every channel, language, and use case. From your first API call to production-ready automation flows — we've written the playbook.
No setup wizard. No 30-minute onboarding call. Just your login credentials, a few lines of code, and a delivered message.
1
Create your account
Contact Ritorica to create your account. Your login and password are issued by your account manager — the same credentials work for HTTP(S), SMPP, and the web dashboard.
2
Get your login credentials
Your account manager provides a login and password. Keep them server-side — never expose them in frontend code or public repositories. The same credentials are used for all protocols.
3
Send a test SMS
Make a single HTTP POST to http.ritorica.com/multi.php with your login, password, phone number, and message text. The response is XML confirming how many messages were queued.
4
Go live
Top up your balance and you're live — same endpoint, same credentials. Use want_sms_ids=1 to get message IDs back for delivery tracking.
body := strings.NewReader(
"login=YOUR_LOGIN&password=YOUR_PASSWORD" +
"&phones=447911123456&originator=Ritorica" +
"&message=Hello+from+Ritorica%21&want_sms_ids=1",
)
req, _ := http.NewRequest("POST", "https://http.ritorica.com/multi.php", body)
req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
// resp.StatusCode == 200, parse XML body
Channel Setup
Connect Each Channel
Each messaging channel has its own approval process, template rules, and delivery behaviour. These guides walk you through every step.
Beginner
SMS — Single & Bulk Sending
Send transactional or marketing SMS globally via HTTP(S) POST to http.ritorica.com/multi.php. Covers single send, bulk with comma-separated phones, personalised messages per recipient, Unicode/Cyrillic encoding, message concatenation, scheduled sending, and alphanumeric sender IDs.
15 min read
HTTP(S) · SMPP
Intermediate
WhatsApp Business API Setup
Get your WhatsApp Business account approved through Ritorica, configure message templates, set up delivery callbacks for inbound messages, and send your first template message. Contact your account manager to get started.
30 min read
Platform · Callbacks
Intermediate
Viber Business Messaging
Configure a Viber Business account through Ritorica, create rich messages with images and CTA buttons, set up Viber Bots for two-way conversations, and handle delivery reports. Contact your account manager to enable.
25 min read
Platform · Callbacks
Intermediate
Push Notifications — Web & Mobile
Send web and mobile push notifications via the Ritorica Push Platform. Covers subscription management for iOS (APNs) and Android (FCM), silent pushes, and rich notifications. Contact your account manager to enable push for your account.
35 min read
Platform · HTTP(S)
Beginner
Telegram Gateway
Send transactional messages via Telegram without managing a bot yourself. Covers channel setup through Ritorica, message delivery, and OTP via Telegram as a channel fallback. Contact your account manager to enable.
20 min read
Platform · HTTP(S)
Intermediate
Delivery Callbacks & Status Events
Receive real-time delivery status updates automatically. Set up a script on your server and share the URL with Ritorica — the platform will POST status events (sms_id, status, delivery_date, error_code) to your endpoint after every status change.
20 min read
All channels
Flow Recipes
Build Complete Messaging Flows
End-to-end implementation guides for the most common business messaging workflows — copy the pattern, adapt to your stack.
Intermediate
OTP & Two-Factor Authentication Flow
Build a complete 2FA system: generate secure OTPs server-side, send via SMS using the Ritorica HTTP API, track the Checked status when the subscriber enters the code, and implement expiry and rate limiting. Includes code samples in Python and Node.js.
40 min read
SMS · WhatsApp
Intermediate
Abandoned Cart Recovery Sequence
Trigger a WhatsApp message with product image 1 hour after cart abandonment, SMS follow-up at 3 hours, and a final push notification at 24 hours. Covers webhook triggers, template variables, and opt-out handling.
45 min read
WhatsApp · SMS · Push
Beginner
Appointment Reminder System
Schedule automated SMS + WhatsApp reminders at configurable intervals before an appointment. Includes confirm/cancel/reschedule reply handling and calendar sync patterns.
30 min read
SMS · WhatsApp
Intermediate
Bulk Campaign with Personalisation
Send personalised SMS campaigns to millions of contacts using the individual_messages parameter. Covers mailing list management via list.php, per-recipient message text, send pacing with the gap parameter, delivery tracking, and unsubscribe management.
35 min read
Viber · SMS · Email
Advanced
Omnichannel Fallback Routing
Build a channel waterfall: try WhatsApp first, fall back to Viber if undelivered within 60s, then SMS as the final guarantee. Covers delivery event listening, timeout logic, and cost optimisation strategies.
50 min read
WhatsApp · Viber · SMS
Advanced
Dormant User Re-engagement Sequence
Identify inactive users via API query, build a personalised multi-step sequence across Push, Viber, and SMS, and measure reactivation rates. Includes A/B testing setup and suppression list handling.
55 min read
Push · Viber · SMS
Need Help with Your Integration?
Our developer support team answers technical questions within 4 hours. Or browse the full API reference for endpoint details, error codes, and rate limits.