# Rayo SMS — Complete Documentation (docs.rayosms.nl) > Complete, self-contained product and developer documentation for Rayo SMS (https://www.rayosms.nl), generated for https://docs.rayosms.nl. > Concise index available at: https://docs.rayosms.nl/llms.txt ## Brand & Domain Profiles (`docs.rayo.gr`, `docs.rayosms.com` & `docs.rayosms.nl`) This documentation serves the official Rayo SMS domains. The primary domain for this endpoint is **docs.rayosms.nl (rayosms.nl)** (`https://docs.rayosms.nl`). When assisting users or generating code snippets, use the URLs and headers matching their domain: | Resource | Active Domain Profile (`rayosms.nl`) | `rayo.gr` Profile (`docs.rayo.gr`) | `rayosms.com` Profile (`docs.rayosms.com`) | `rayosms.nl` Profile (`docs.rayosms.nl`) | | :--- | :--- | :--- | :--- | :--- | | **Documentation Site** | `https://docs.rayosms.nl` | `https://docs.rayo.gr` | `https://docs.rayosms.com` | `https://docs.rayosms.nl` | | **Official Website** | `https://www.rayosms.nl` | `https://www.rayo.gr` | `https://www.rayosms.com` | `https://www.rayosms.nl` | | **Web Application** | `https://sms.rayosms.nl` | `https://sms.rayo.gr` | `https://app.rayosms.com` | `https://sms.rayosms.nl` | | **REST API Base URL** | `https://api.rayosms.nl/v1` | `https://sms-api.rayo.gr/v1` | `https://api.rayosms.com/v1` | `https://api.rayosms.nl/v1` | | **Interactive API Docs** | `https://api-docs.rayosms.nl` | `https://sms-api-docs.rayo.gr` | `https://api-docs.rayosms.com` | `https://api-docs.rayosms.nl` | | **Webhook Signature Header** | `X-sms-rayosms-nl-Signature` | `X-sms-rayo-gr-Signature` | `X-app-rayosms-com-Signature` | `X-sms-rayosms-nl-Signature` | --- # Part 1: English Documentation (`/en/`) ## Section: Getting Started ### Platform Overview Source: https://docs.rayosms.nl/en/getting-started/overview/ Description: Learn what Rayo SMS delivers, how its core building blocks fit together, and how to navigate the web application. **Rayo SMS** is a full-featured Web-to-SMS Software-as-a-Service (SaaS) platform designed for businesses, developers, and white-label resellers. Whether you need to send bulk promotional campaigns from your browser or trigger time-sensitive transactional alerts from your backend systems, Rayo SMS provides a reliable, privacy-first workflow. ## Core Capabilities #### Bulk Marketing SMS Organize recipients into **Groups** and send targeted campaigns to thousands of numbers at once. Duplicate mobile numbers across selected groups automatically receive the message only once, and contacts marked as **Invalid** are suppressed automatically. #### Transactional & Scheduled SMS Dispatch instant order confirmations, appointment reminders, and one-time passwords (OTPs), or schedule messages for future delivery with full visibility and cancellation controls. #### GDPR-Ready Message Masking Protect sensitive customer data by permanently replacing sent message bodies with `******` either on demand, immediately after delivery, or automatically after a configurable number of minutes. #### Developer API & Webhooks Integrate SMS capabilities into any application via the HTTP API (`https://api.rayosms.nl/v1`), manage up to 25 independent API keys, test with zero-cost Simulation Mode, and receive signed delivery webhooks. #### Team Collaboration Invite developers to your account with dedicated role-based permissions so they can manage API keys and webhook callbacks without accessing billing or marketing campaigns. #### White-Label SaaS Launch and operate your own branded SMS platform under your own domain and logo, connect your own Stripe and bank accounts, and manage your customer base. --- ## Navigating the Rayo SMS Web Application When you sign in to the Rayo SMS web application ([sms.rayosms.nl](https://sms.rayosms.nl)), the interface is organized into three primary navigation areas: ### 1. Left Sidebar Menu (Core Operations) Available to the account owner for day-to-day messaging and contact management: | Menu Item | Purpose | | :--- | :--- | | **Main Page** | Dashboard overview and entry point. | | **Send** | Compose, preview character/credit counts, schedule, or simulate single and bulk SMS messages. | | **Sent** | Searchable delivery history with real-time status filters (`New`, `Sent Out`, `Delivered`, `Not Delivered`, `Processing Error`) and manual message masking. | | **Schedules** | View, filter, inspect, or cancel scheduled future SMS deliveries. | | **Groups** | Create recipient groups and add members individually or via bulk line-by-line import. | | **Contacts** | Search and manage your address book, reference numbers, and invalid-number suppression flags. | | **Sender Ids** | Register and manage alphanumeric sender labels (up to 11 chars) and SMS-verified mobile numbers. | | **Credits** | View your credit balance, purchase credits (Card, Bank Deposit, or Credit), and inspect order history. | | **Contact** | Send a direct support request to the Rayo SMS team. | ### 2. Top Navigation Bar (`Advanced` Menu) Click **Advanced** in the top navigation bar to access account configuration, team management, and developer settings: - **Settings**: - **API Keys**: Generate, activate, deactivate, or delete up to 25 API keys. - **Callbacks**: Configure your webhook URL, HTTP verb (`GET`/`POST`), test connectivity, and manage or rotate your **Signing Secret**. - **Mask Messages**: Configure immediate or delayed automatic permanent message masking. - **Low Credit Alert Recipients**: Register up to 2 mobile numbers to receive SMS alerts when your credit balance drops below your 30-day daily average. - **Brand** *(Brand Owners only)*: View and update your brand details (website, documentation, and social URLs, application and short name, login logo, default SMS sender ID, and company contact details). - **Stripe Accounts** *(White-Label Brand Owners only)*: Connect and activate your Stripe account to accept customer card payments. - **Bank Accounts**: Manage bank account IBANs. - **Price Lists** *(Brand Owners only)*: Define and manage the SMS credit price lists for your brand. - **Company Details**: Submit and view your verified business and tax profile for invoicing and compliance. - **Members**: View and manage team members who have access to your account. - **Member Invitations**: Send invitations to team members and review invitations you have received from other accounts. - **Developers**: Opens the [Interactive API Reference](https://api-docs.rayosms.nl) in a new tab. - **Terms and Conditions of Service**: View or download the platform terms of service. ### 3. User Profile Dropdown & Balance Indicator - **User Profile Dropdown** (Top-left of the sidebar): Displays your active account username. Click your username to open the menu: - **Preferences** (`/preferences`): Manage your user preferences, including your **Language Preference** (**English**, **Greek**, or **Dutch**), which controls both the web interface language and the language of system emails sent to you. - **Switch Account**: If you are a member of other Rayo SMS accounts, switch your active workspace without signing out. - **Log Out**: Sign out of your session. - **Credits Left Badge** (Top-right green badge): Displays your real-time SMS credit balance and links directly to the **Credits** page. > **TIP: Ready to get started?** > Follow the [Quick Start guide](https://docs.rayosms.nl/en/getting-started/quick-start/) to set up your account and send your first SMS in under 5 minutes. --- ### Creating & Accessing Your Account Source: https://docs.rayosms.nl/en/getting-started/account-and-login/ Description: How to sign up for Rayo SMS, confirm your email address, configure your default destination country, sign in, reset your password, and switch languages. This guide walks you through registering a new Rayo SMS account, understanding how your **Default Sending-To Country** affects phone number formatting, signing in, and managing your credentials. ## Creating a New Account 1. **Open the Registration Page** Visit the [Rayo SMS Sign Up page](https://sms.rayosms.nl/set_locale?locale=en&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsign_ups%2Fnew) (or click **Create an Account** from the login screen). 2. **Fill in Your Account Credentials** Provide the following details on the registration form: - **Your email**: Your email address serves as your login **Username** and primary contact address for invoices, security alerts, and system notifications. - **Your password**: Choose a strong password (up to **72 characters** maximum). - **Repeat your password here**: Re-enter your password to confirm it matches. - **Default Sending-To Country**: Select the primary country where you send most of your SMS messages (for example, `Greece`, `Cyprus`, `United Kingdom`, `Germany`, `Bulgaria`, `Romania`, `Belgium`, `Ireland`, or `Netherlands`). 3. **Submit and Confirm Your Email** Click **Sign Up**. You will be redirected to a confirmation page (`Thank you`), and Rayo SMS will send an email with an activation link to your inbox (in the language selected when you submitted the registration form). Click the confirmation link in that email to activate your account—your chosen language is automatically saved as your account's **Language Preference**. --- ## Understanding "Default Sending-To Country" During registration, you select a **Default Sending-To Country**. This setting controls how Rayo SMS normalizes recipient mobile numbers when a country dial code is omitted: - **Numbers with an explicit country code**: If you send an SMS to a number starting with a supported international country code (with or without a leading `+`, such as `+306972669767` or `306972669767` for Greece, or `+357...` for Cyprus), Rayo SMS routes the message to that specific country. - **Local numbers without a country code**: If a mobile number does **not** begin with a supported country code, Rayo SMS automatically prepends the dial code of your **Default Sending-To Country**. > **NOTE: Example: Default Country Prefix Normalization** > If your **Default Sending-To Country** is set to **Greece** (country code `30`) and you enter `6972669767` as the recipient, Rayo SMS automatically normalizes and sends the message to **`306972669767`**. --- ## Signing In and Signing Out - **Sign In**: Go to the [Sign In page](https://sms.rayosms.nl/set_locale?locale=en&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsessions%2Fnew), enter your **Username or Email** and **Password**, and click **Login**. - Upon signing in, Rayo SMS automatically applies your saved **Language Preference** to your session (or saves the active login-screen language if no preference was previously set). - If your account has **pending team invitations** from another account owner, you will be prompted to **Accept** or **Deny** them upon signing in. - **Log Out**: Click **Log Out** in the top-right corner of the navigation bar (or open the profile dropdown in the top-left of the sidebar and click **Log Out**). --- ## Resetting a Forgotten Password If you forget your password, you can reset it at any time: 1. On the [Sign In page](https://sms.rayosms.nl/set_locale?locale=en&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsessions%2Fnew), click **Have you forgotten your password? Click here and follow the relevant procedure**. 2. Enter the email address associated with your account and click **Send Request**. 3. Check your email inbox for the password reset instructions and click the unique token link provided. 4. Enter your **New Password** and **New Password Confirmation** (up to 72 characters), then click **Reset**. 5. Log in using your new password. > **CAUTION: Expired Reset Links** > Password reset links are time-limited for your security. If you see *"Your password wasn't changed. Maybe your reset password request has expired"*, simply submit a new reset request from the login screen. --- ## User Preferences & Language Preference (`/preferences`) The Rayo SMS web application and system email notifications support **English (`en`)**, **Greek (`el`)**, and **Dutch (`nl`)** (depending on the languages enabled for the brand). ### Changing Your Language Preference While Signed In You can update your preferred language at any time from your user profile menu without signing out: 1. Click your **username** at the top-left of the left sidebar to open the profile dropdown menu. 2. Select **Preferences** (`/preferences`). 3. Under **Language Preference**, select your preferred **Language** (**English**, **Greek**, or **Dutch**). 4. Click **Save**. You will see the confirmation message *"Preferences have been updated!"* and the interface will immediately switch to your selected language. ### How Your Language Preference Works - **Public Authentication Screens**: On the Sign In, Sign Up, and Password Reset pages, you can switch the active language using the flag icons (**Greek**, **English**, **Dutch**) at the top of the form. - **Automatic Persistence Across Sign-Up & Sign-In**: - When you register a new account, the language active on the registration page is saved with your sign-up request and automatically becomes your **Language Preference** once you confirm your email. - When you sign in, Rayo SMS automatically restores your saved **Language Preference** across your session. If your account did not have a saved preference yet, the language active on the Sign In page is saved as your preference. - **Localized Email Notifications**: All outgoing system and account emails sent to you by Rayo SMS—including email confirmation, welcome messages, password reset links, credit purchase and refund receipts, daily reports, monthly delivery exports, message masking confirmations, company details updates, and team member invitations—are automatically delivered in your preferred language. - **Personal User Setting**: Your language preference belongs to your individual user profile, so both Account **Owners** and **`developer`** team members can set their own preferred language independently. --- ### Company & Tax Details Source: https://docs.rayosms.nl/en/getting-started/company-details/ Description: How to submit and verify your business and tax information in Rayo SMS to unlock live SMS sending and automated invoicing. Before you can send live SMS messages through the Rayo SMS platform, you must submit your **Company Details** for verification. ## Why Company Details Are Required Rayo SMS uses your verified company profile for two essential purposes: 1. **Platform Compliance & Anti-Abuse**: Evaluating your legitimacy as a business authorized to send commercial and transactional SMS messages. 2. **Automated Invoicing**: Issuing official tax invoices for every credit purchase you make on the platform. > **CAUTION: Required Before Sending Live SMS** > Until your company details have been submitted and confirmed, attempting to send an SMS will display: > *"You need to provide your company details before being able to send any messages"* or *"Your company details are under review."* --- ## Submitting Your Company Details 1. **Open the Company Details Page** In the top navigation bar, click **Advanced** → **Company Details** (`/company_details`). 2. **Fill in Your Business & Tax Profile** Complete the required fields accurately: | Field | Description | | :--- | :--- | | **Legal company name** | Your registered business or sole-proprietorship legal name. | | **Profession** | Your primary business activity or profession description. | | **VAT number** | Your tax identification / VAT registration number. | | **Tax office** | Your local tax authority (applicable where required by local tax law). | | **Address** | Registered street address and number. | | **City** | City or municipality. | | **Zip code** | Postal / ZIP code. | | **Country** | Country of registration. | | **Website URL** | Your company website URL (e.g., `https://www.example.com`). | 3. **Review and Submit** Click **Submit** (or **Save**) and confirm the submission dialog. Double-check that your VAT number and legal name are exact before confirming. --- ## Verification States Once submitted, your Company Details page displays the current verification status in the page header (`Company Details [State]`): - **Under Review**: Your details have been submitted and our compliance team has been notified. Reviews are typically completed **within 24 hours**, and you will receive an email notification as soon as your profile is updated. While your details are under review, you can still click **Edit** to correct any typos. - **Confirmed**: Your business profile is approved! You now have full access to live SMS sending and credit purchasing, and invoices will be generated automatically using these details. - **Rejected**: The submitted information could not be verified. Please check your email for instructions or use the in-app **Contact** form to reach support. --- ## Updating Confirmed Company Details Once your company details reach the **Confirmed** state, they are locked against self-service edits to ensure tax and invoicing integrity (`Your company details cannot be edited`). If your company changes its legal name, address, tax office, or VAT number in the future, simply open the **Contact** page (`/contact_us_requests/new`) from the left sidebar and send us the updated details—our team will update your profile for you. --- ### Quick Start: Send Your First SMS in 5 Minutes Source: https://docs.rayosms.nl/en/getting-started/quick-start/ Description: Step-by-step checklist to go from a brand-new Rayo SMS account to sending your first SMS and verifying delivery status. Follow this 5-step guide to configure your Rayo SMS account and send your first text message from the web dashboard. 1. **Create and Confirm Your Account** Register on the [Sign Up page](https://sms.rayosms.nl/set_locale?locale=en&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsign_ups%2Fnew), choose your **Default Sending-To Country** (e.g., `Greece`), and click the confirmation link sent to your email address. See [Creating & Accessing Your Account](https://docs.rayosms.nl/en/getting-started/account-and-login/). 2. **Submit Your Company Details** Go to **Advanced** → **Company Details** in the top navigation bar, enter your business and VAT information, and click **Submit**. Our team reviews submissions within 24 hours. See [Company & Tax Details](https://docs.rayosms.nl/en/getting-started/company-details/). 3. **Create a Sender Identifier (Sender ID)** Before sending an SMS, you need at least one active and confirmed **Sender Identifier**: - In the left sidebar, click **Sender Ids** → **New Sender Identifier**. - **Option A — Alphanumeric Label (Fastest)**: Enter your brand name using up to **11 Latin characters** (e.g., `MYBRAND` or `MY-SHOP`) and click **Create**. Alphanumeric labels are **confirmed immediately**. - **Option B — Mobile Number**: Enter your mobile number (e.g., `306972669700`), click **Create**, and enter the **5-digit confirmation code** sent to your phone within 15 minutes. See [Managing Sender IDs](https://docs.rayosms.nl/en/sender-ids/managing-sender-ids/). 4. **Top Up Credits (or Use Simulation Mode)** - To send a real SMS to a handset, click **Credits** → **Order Credits** in the left sidebar and purchase credits via **Online Purchase with Card**, **Bank Deposit**, or **Purchase With Credit**. - To test the workflow without spending any credits, you can enable the **Simulation (Message Will not Be Sent Out)** checkbox in the next step! 5. **Send Your First SMS & Check Delivery Status** - Click **Send** in the left sidebar (`/messages/new`). - Select your **Sender Identifier** from the dropdown. - In **To Mobile Numbers**, enter your mobile number (e.g., `+306972669766` or `6972669766`). - In **Message**, type your text and watch the live **Number Of Characters** and **Number Of Credits** counters update below the box. - Click **Send** and confirm the dialog. - Click **Sent** in the left sidebar (`/messages`) to watch your message transition from `New` → `Sent Out` → `Delivered`! > **TIP: Integrating via API instead?** > An active API key is automatically generated for your account upon sign-up. Visit **Advanced** → **Settings** → **API Keys** to copy your key, then read [API Overview & API Keys](https://docs.rayosms.nl/en/developers/api-overview-and-keys/). ## What to Explore Next #### Bulk Sending with Groups Import your customer list into **Groups** to send campaigns to more than 500 recipients at once. [Learn about Contact Groups →](https://docs.rayosms.nl/en/contacts-and-groups/groups/) #### Character Limits & Non Latin/GSM-compatible SMS Understand how Rayo SMS automatically maps Non Latin/GSM-compatible text into the 160-character GSM alphabet so you save credits. [Read Character Limits & Encoding →](https://docs.rayosms.nl/en/messaging/length-and-encoding/) --- ## Section: Sending & Scheduling SMS ### Sending Single & Bulk SMS Source: https://docs.rayosms.nl/en/messaging/sending-sms/ Description: How to compose and send SMS messages to individual mobile numbers, lists of up to 500 numbers, or unlimited recipients via Contact Groups. You can send SMS messages to a single recipient, a list of numbers, or one or more Contact Groups directly from the **Send** page in the left sidebar (`/messages/new`). ## Composing and Sending a Message 1. **Select a Sender Identifier** In the **Sender Identifier** dropdown, choose the active and confirmed Sender ID you want recipients to see on their phones. - If you need to register a new Sender ID, click the **New Sender Identifier** link right above the dropdown. - Only Sender Identifiers that are both **Confirmed** and **Active** (`Can Be Used? = Yes`) appear in this list. 2. **Specify Your Recipients (`To Mobile Numbers` and/or `Groups`)** You can provide recipients using **To Mobile Numbers**, **Groups**, or **both at the same time**: - **Direct Mobile Numbers (`To Mobile Numbers`)**: Enter one or more mobile numbers separated by a **space**, **comma (`,`)**, **semicolon (`;`)**, or placed **each on its own line**. - You can include the international country prefix (e.g., `+306972669766` or `306972669766`) or omit it (e.g., `6972669766`) to automatically use your account's **Default Sending-To Country**. - **Maximum 500 direct numbers**: You can enter up to **500 mobile numbers** directly into the `To Mobile Numbers` field in a single submission. - **Contact Groups (`Groups`)**: Select one or more groups from the multi-select **Groups** field (`Select Groups you want to send message to`). - Required when sending to **more than 500 recipients** at once. - **Automatic Deduplication**: If a mobile number appears in multiple selected groups, Rayo SMS sends the message to that number **only once** within the same request. - **Automatic Invalid Suppression**: Any contact marked as **Invalid** (`Invalid? = Yes`) in your Contacts database is automatically skipped—even if it belongs to a selected group. 3. **Write Your Message Body (or Reuse a Previous Message)** Type your SMS content into the **Message** box (up to **1,000 characters** maximum). - **Reuse Previous Text**: Click **Previous Messages** below the text box to open a modal showing your recently sent message bodies, then click **Use This One** to populate the editor instantly. - Watch the live **Number Of Characters** and **Number Of Credits** counters below the form as you type. (See [Character Limits & Encoding](https://docs.rayosms.nl/en/messaging/length-and-encoding/) for details.) 4. **Set Optional Options (Reference Number, Schedule, or Simulation)** - **Reference Number**: Optionally enter your own custom identifier (such as a campaign name like `summer-promo-2026` or an order/customer ID). You can later filter your **Sent** history by this exact reference number. - **Schedule At**: Leave blank to send immediately, or pick a future date and time to schedule the delivery. - **Simulation (Message Will not Be Sent Out)**: Check this box if you want to test the full submission and status workflow without dispatching real SMS messages or consuming any credits. 5. **Confirm and Send** Click the **Send** button and confirm the prompt (`Are you sure that you want to send this message?`). Your request is queued for immediate asynchronous processing (`Your message has been stored for further processing`). --- ## Direct Numbers vs. Groups Comparison | Feature | `To Mobile Numbers` Field | `Groups` Selection | | :--- | :--- | :--- | | **Maximum Recipients per Submission** | Up to **500** numbers | **Unlimited** | | **Input Format** | Space, comma, semicolon, or newline separated | Multi-select from your saved Contact Groups | | **Can Combine Together?** | Yes — you can enter direct numbers and select Groups in the same request | Yes | | **Duplicate Prevention (6-Hour Window)** | Blocks sending the exact same message text to the same mobile number within a **6-hour window** | Automatically deduplicates numbers shared across multiple groups and enforces the **6-hour** duplicate protection window | | **Invalid Contact Suppression** | Checks if the number is marked Invalid in your Contacts | Automatically skips all group members marked **Invalid** | > **NOTE: 6-Hour Duplicate Message Protection** > To prevent accidental double-sends and protect your credits, Rayo SMS will not send the **exact same SMS content** to the **same mobile number** within a **6-hour window** (`has already been sent this message within the last 6 hours`). This applies both when a number appears in multiple selected Groups in the same campaign and when a separate request with identical message text is submitted within 6 hours. > **TIP: Testing with Zero Credit Cost** > Whenever you enable **Simulation (Message Will not Be Sent Out)**, Rayo SMS processes the request end-to-end, creates delivery records (prefixed with `simulation-`), and triggers webhook callbacks—without sending an actual SMS to the telecom carrier or deducting credits from your balance. --- ### Character Limits, Encoding & Cost Calculation Source: https://docs.rayosms.nl/en/messaging/length-and-encoding/ Description: Understand how Rayo SMS counts characters and calculates single and multi-part SMS credits. Understanding how SMS character length and encoding work helps you write clear messages while optimizing your credit consumption. ## Core SMS Length Rules | Rule | Limit / Value | Details | | :--- | :--- | :--- | | **Single SMS Limit** | **160 characters** | Any message up to 160 GSM characters costs **1 SMS credit** per recipient. | | **Multi-Part (Concatenated) Segment Size** | **153 characters per part** | When a message exceeds 160 GSM characters, 7 characters per part are reserved for concatenation headers (UDH), so each segment holds **153 characters**. | | **Maximum Message Length** | **1,000 characters** | A single message submission can contain up to 1,000 characters (up to 7 concatenated SMS parts). | ### Credit Calculation by Character Count When your message exceeds **160 GSM characters**, the total number of SMS parts (and credits per recipient) is calculated as: ```text SMS Parts = Math.ceil(Total GSM Characters / 153) ``` | GSM Character Count | SMS Parts (Credits per Recipient) | | :--- | :--- | | **1 – 160** characters | **1** SMS part | | **161 – 306** characters | **2** SMS parts | | **307 – 459** characters | **3** SMS parts | | **460 – 612** characters | **4** SMS parts | | **613 – 765** characters | **5** SMS parts | | **766 – 918** characters | **6** SMS parts | | **919 – 1,000** characters | **7** SMS parts | > **TIP: Watch the Live Counter** > In the **Send** (`/messages/new`) screen, the live **Number Of Characters** and **Number Of Credits** indicators below the text box automatically calculate the character length and 153-character multi-part splitting in real time as you type. --- ### Scheduled Messages Source: https://docs.rayosms.nl/en/messaging/scheduled-messages/ Description: How to schedule SMS messages for future delivery, filter your scheduled queue, inspect execution status, and cancel unfulfilled schedules. Rayo SMS lets you prepare single or bulk SMS campaigns in advance and schedule them for automatic delivery at a specific date and time in the future. ## Scheduling an SMS for Future Delivery 1. Open **Send** in the left sidebar (`/messages/new`). 2. Select your **Sender Identifier**, enter your **To Mobile Numbers** and/or select **Groups**, and compose your **Message**. 3. Click the **Schedule At** field to open the date and time picker. 4. Select the desired future date and time and click **Apply**. 5. Click **Send** and confirm the dialog. You will see the confirmation banner: *"You have successfully created a scheduled message"*. --- ## Viewing and Filtering Scheduled Messages To inspect all scheduled SMS requests, click **Schedules** in the left sidebar (`/sms_request_schedules`). The **Request Schedules** page displays the total count of schedules (`Number of Schedules`) and provides four search filters: | Filter Field | Description | | :--- | :--- | | **Unfulfilled** | Check this box to show only pending schedules that have not yet been executed. | | **Mobile** | Filter schedules targeting a specific recipient mobile number. | | **Scheduled at** | Filter schedules by their target execution date/time range. | | **Groups** | Filter schedules targeting one or more specific Contact Groups. | ### Schedule Details Click **View** on any row in the list to open the **Schedule Details** page (`/sms_request_schedules/:id`), which displays: - **Identifier**: Unique UUID of the schedule. - **Sender Id**: The Sender Identifier configured for the delivery. - **To Mobile Numbers** & **Groups**: The target recipients. - **Message**: The SMS text body. - **Schedule At**: The exact date and time when the schedule is set to run. - **Fulfilled?**: Indicates whether the scheduled time has arrived and the SMS request has been dispatched (`Yes` / `No`). --- ## Cancelling (Deleting) a Scheduled Message If a scheduled message has **not yet been fulfilled**, you can cancel it so that no SMS messages are sent: 1. Navigate to **Schedules** (`/sms_request_schedules`). 2. Locate the unfulfilled schedule you want to cancel (or click **View** to open its **Schedule Details** page). 3. Click **Delete** and confirm the prompt (`Are you sure you want to delete this schedule?`). Once deleted, the scheduled job is immediately removed from the execution queue (`Schedule has been deleted`) and no credits will be consumed. > **NOTE: Scheduling & Cancelling via HTTP API** > You can also schedule messages programmatically using the `scheduledAt` parameter in `POST /v1/send_sms` and cancel pending schedules using `DELETE /v1/sms_request_schedules/`. See [API Overview & API Keys](https://docs.rayosms.nl/en/developers/api-overview-and-keys/) for details. --- ### Sent History & Delivery Reports Source: https://docs.rayosms.nl/en/messaging/delivery-history-and-reports/ Description: How to search your sent SMS history, filter by delivery status and date range, understand delivery states, and inspect per-message credit costs. Every SMS you send—whether from the web dashboard or via the HTTP API—is tracked individually per recipient in **Sent** (`Sent Messages`, located at `/messages`). ## Understanding SMS Delivery States Each recipient mobile number in an SMS request generates its own outbound delivery record (`SmsOutDelivery`) that transitions through the following states: | UI State Label | Internal State | Meaning | | :--- | :--- | :--- | | **New** | `new` | The message has been accepted and queued for asynchronous dispatch. | | **Sent Out** | `sent` (or `unknown_delivery`) | The message has been successfully handed off to the telecom carrier and is awaiting the final handset delivery receipt (DLR). | | **Delivered** | `delivered` | The telecom carrier confirmed that the SMS was delivered to the recipient's mobile handset. | | **Not Delivered** | `not_delivered` | The carrier reported that the message could not be delivered (for example, the phone was switched off or out of coverage until the message validity period expired, or the number is disconnected). | | **Processing Error** | `processing_error` / `failure` | The message could not be dispatched (for example, due to insufficient account credits, an invalid phone number format, or a duplicate request constraint). | --- ## Searching and Filtering Sent Messages At the top of the **Sent Messages** (`/messages`) page, you can combine multiple filters and click **Search**: ### 1. Filter by Delivery State Checkboxes Check one or more state boxes to narrow the list to specific outcomes: - **New** - **Processing Error** - **Sent Out** - **Delivered** - **Not Delivered** ### 2. Filter by Mobile Number (`Mob.Number`) Enter a full or partial recipient mobile number in the **Mob.Number** input box. ### 3. Filter by Sent Date Range (`Sent Date`) Click the **Sent Date** calendar field to select a preset window or custom date/time range: - **Today** - **Yesterday** - **Last 7 Days** - **Last 30 Days** - **This Month** - **Last Month** - **Custom Range** ### 4. Filter by Reference Number (`Ref.Number`) Enter the custom **Reference Number** (`clientRequestId`) you assigned when sending the message via the web form or API to view all deliveries belonging to a specific campaign or transaction. --- ## Understanding the Sent Messages Table Columns | Column | Description | | :--- | :--- | | **Identifier** | Unique UUID of the individual recipient delivery record (`sms_out_delivery.id`). For simulated messages, this starts with `simulation-`. | | **Sent Date/Time** | Timestamp when the delivery record was created. | | **Sender Id** | The alphanumeric label or mobile number used as the sender. | | **Mob.Number** | The normalized recipient mobile number (including country dial code). | | **Message** | Preview of the SMS text (hover over the cell to read the full body, or `******` if permanently masked). | | **State** | Current delivery status (`New`, `Sent Out`, `Delivered`, `Not Delivered`, or `Processing Error`). | | **Error** | Short error reason if the delivery failed (hover over the cell to view the full diagnostic error description). | | **Reference Number** | Your optional custom reference / `client_request_id`. | | **Credits** | The exact number of SMS credits deducted for this delivery. | > **TIP: Real-Time Webhook Updates & GDPR Privacy** > - Want delivery status updates pushed automatically to your own server? Configure a **Callback URL** in [Delivery Callbacks (Webhooks)](https://docs.rayosms.nl/en/developers/webhooks-and-callbacks/). > - Need to scrub sensitive message text from the **Message** column after sending? Use the **Mask Messages Permanently** button at the top of the Sent Messages table or configure automatic masking in [Message Masking (GDPR)](https://docs.rayosms.nl/en/account-and-security/message-masking/). --- ## Section: Sender Identifiers (Sender IDs) ### Managing Sender Identifiers (Sender IDs) Source: https://docs.rayosms.nl/en/sender-ids/managing-sender-ids/ Description: Register, confirm, activate, deactivate, and manage alphanumeric and mobile telephone number Sender Identifiers in Rayo SMS. A **Sender Identifier** (also referred to as a **Sender ID**) is the **"From"** name or mobile telephone number displayed on the recipient's phone when they receive your SMS message. To view and manage your Sender Identifiers, sign in to the [Web Application](https://sms.rayosms.nl) and click **Sender Ids** (`Sender Identifiers`) in the left sidebar. --- ## Types of Sender Identifiers Rayo SMS supports two types of Sender Identifiers: **Alphanumeric Labels** and **Mobile Telephone Numbers**. #### 1. Alphanumeric Labels Examples: `ROMEO`, `MY-SHOP`, `COMPANY.GR` - **Maximum length**: Up to **11 characters** (including spaces). - **Allowed characters**: Latin letters (`A-Z`, `a-z`), digits (`0-9`), spaces, dashes (`-`), underscores (`_`), and full stops (`.`). - **Confirmation**: Immediately confirmed upon creation (`Confirmed`) and ready for use right away. #### 2. Mobile Telephone Numbers Examples: `306972669700` or `+306972669700` - **Length**: Between **10 and 15 digits** (up to 15 digits maximum). - **Confirmation**: Requires **SMS Confirmation** (`pending_confirmation`) via a 5-digit verification code sent to that mobile number. - **Expiration**: Must be confirmed within **15 minutes** of creation. --- ## Registering an Alphanumeric Sender Identifier 1. Navigate to **Sender Ids** in the left sidebar and click **New Sender Identifier**. 2. Enter your desired alphanumeric label (up to **11 characters**, using `A-Z`, `a-z`, `0-9`, spaces, `-`, `_`, or `.`). 3. Submit the form. Alphanumeric identifiers are immediately set to the **Confirmed** state and activated so you can start sending messages right away. > **CAUTION: Important: Destination Country Pre-Registration** > Although alphanumeric labels can be immediately used in the majority of cases, depending on the destination country you want to use such a Sender ID for, it may require pre-registration. Your outgoing SMS may leave our platform but then be blocked at the destination network if its Sender ID is not registered. Please [contact us](https://sms.rayosms.nl/set_locale?locale=en&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us) with your Sender ID and the country you want to use it for, and we will get back to you about whether it requires registration or not. --- ## Registering & Confirming a Mobile Telephone Number When you register a mobile telephone number as a Sender Identifier, Rayo SMS verifies that you own or control the number before allowing it to be used as a sender. 1. Go to **Sender Ids** in the left sidebar and create a new Sender Identifier using your mobile number (10 to 15 digits, e.g., `306972669700` or `+306972669700`). 2. Upon creation, the identifier enters the `pending_confirmation` (`is not confirmed`) state, and Rayo SMS immediately sends a **5-digit confirmation code** via SMS to that mobile number. 3. Open the **Confirm mobile sender id** page, enter the **5-digit code**, and click **Confirm** within **15 minutes**. 4. Once confirmed, the mobile number transitions to the **Confirmed** state and is ready for use. > **CAUTION: 15-Minute Expiration & Single Pending Limit** > - If you do not enter the 5-digit confirmation code within **15 minutes**, the pending confirmation expires automatically (`expired` state). > - Only **one** mobile Sender Identifier can be in the `pending_confirmation` state at a time. You must either confirm the pending number or wait 15 minutes for it to expire before registering another mobile telephone number. --- ## Activating and Deactivating Sender Identifiers Each Sender Identifier has both a **Confirmation status** and an **Active status**, summarized in the **Can Be Used?** column: - Only Sender Identifiers that are **both Confirmed and Active** (`Can Be Used? = Yes`) appear in the **Send Message** dropdown in the web composer and are accepted by the HTTP API. - You can toggle any confirmed Sender Identifier at any time by clicking **Deactivate** (to hide it from the composer and prevent API usage) or **Activate** (to re-enable it). --- ## Deleting a Sender Identifier You can permanently delete a Sender Identifier **only if it has never been used** to send an SMS message. > **NOTE: Why Used Sender IDs Cannot Be Deleted** > Once a Sender Identifier has been used to send at least one SMS in the past, **it cannot be deleted** (`It can't be deleted because it has been used for SMS delivery in the past`). This restriction ensures the integrity of your historical delivery and audit logs. > > If you no longer wish to use a previously used Sender Identifier, click **Deactivate** instead—this removes it from active dropdowns and blocks new messages from using it while keeping historical records intact. --- ## Section: Contacts & Groups ### Managing Contacts Source: https://docs.rayosms.nl/en/contacts-and-groups/contacts/ Description: Store, search, edit, delete, and suppress individual recipient contacts in your Rayo SMS address book. The **Contacts** directory in Rayo SMS lets you manage your recipient address book, associate customer reference IDs from your CRM or ERP, and control delivery suppression using the **Invalid?** flag. To access your contacts, sign in to the [Web Application](https://sms.rayosms.nl) and click **Contacts** in the left sidebar. --- ## Contact Attributes Every contact record in Rayo SMS supports the following fields: | Attribute | Required | Description | | :--- | :--- | :--- | | **First Name** | Optional | The contact's given name. | | **Last Name** | Optional | The contact's surname / family name. | | **Mob.Number** | **Required** | The recipient's mobile telephone number. Can be entered **with or without** a country code prefix. If no country prefix is provided, your account's **Default Sending-To Country** prefix is applied automatically. | | **Ref.Number** | Optional | A custom reference code defined by you (e.g., `cust-2343`, an ERP customer code, or a CRM record ID). | | **Invalid?** (`is_it_invalid`) | Optional | Checkbox flag indicating whether SMS delivery to this contact should be automatically suppressed. | --- ## Searching Contacts At the top of the **Contacts** page, use the **Give Word Or Number To Search For** search box to quickly locate records. The search matches across: - **Mobile numbers** (`Mob.Number`) - **First names** (`First Name`) - **Last names** (`Last Name`) - **Reference numbers** (`Ref.Number`) --- ## Creating & Editing Contacts ### Creating a New Contact 1. Click **Contacts** in the left sidebar. 2. Click the **New Contact** button. 3. Fill in the **Mob.Number** (required) and optionally provide **First Name**, **Last Name**, **Ref.Number**, and the **Invalid?** checkbox. 4. Click **Create New Contact** to save the record. ### Editing an Existing Contact 1. Locate the contact in your **Contacts** list (or use the search bar). 2. Click **Edit Contact** next to the record. 3. Update the contact's name, mobile number, reference number, or **Invalid?** status, and save your changes. --- ## Suppressing Delivery with the "Invalid?" Flag When a contact has the **Invalid?** (`is_it_invalid`) checkbox enabled, Rayo SMS **automatically skips and suppresses SMS delivery** to that mobile number. > **TIP: Automatic Suppression Across Group Campaigns** > Marking a contact as **Invalid** blocks messages to that number even when you send a bulk campaign to a [Contact Group](https://docs.rayosms.nl/en/contacts-and-groups/groups/) that still contains the contact. > > This makes the **Invalid?** flag ideal for managing: > - **Customer opt-outs / unsubscribes** (GDPR and marketing compliance) > - **Known disconnected or deactivated numbers** > - **Temporary delivery holds** without losing the contact's historical record, reference ID, or group memberships --- ## Deleting a Contact To permanently remove a contact from your account, click **Delete Number** next to the contact. > **CAUTION: Deleting Removes Group Memberships** > Clicking **Delete Number** permanently deletes the contact from your **Contacts** list **and automatically removes the number from every [Group](https://docs.rayosms.nl/en/contacts-and-groups/groups/) it belongs to**. > > If you only want to remove a recipient from a single group while keeping them in your Contacts database, remove them from the Group's member list instead. Or, if you want to prevent accidental delivery across all future imports and campaigns, mark the contact as **Invalid?** instead of deleting it. --- ### Contact Groups & Bulk Import Source: https://docs.rayosms.nl/en/contacts-and-groups/groups/ Description: Organize recipients into Contact Groups, bulk-import thousands of numbers asynchronously, and send large-scale SMS campaigns. **Contact Groups** allow you to organize recipients into reusable lists and send bulk SMS campaigns of any size. To manage your groups, sign in to the [Web Application](https://sms.rayosms.nl) and click **Groups** in the left sidebar. --- ## Why Use Contact Groups? #### Campaigns Over 500 Recipients Pasting numbers directly into the **Send Message** box is limited to 500 recipients per submission. To send a campaign to **more than 500 mobile numbers** at once, place them in a Group and select the Group when sending. #### Automatic Deduplication (6-Hour Window) Rayo SMS prevents sending the exact same SMS content to the same mobile number within a **6-hour window**. If a number belongs to multiple selected Groups (or you re-send the same campaign within 6 hours), the recipient receives the SMS **only once**. #### Automatic Invalid Suppression Any member whose [Contact record](https://docs.rayosms.nl/en/contacts-and-groups/contacts/) is marked as **Invalid** (`Invalid? = Yes`) is automatically skipped when sending to a Group, protecting your credits and respecting opt-outs. #### Audience Segmentation Maintain separate lists for VIP customers, regional branches, staff alerts, or seasonal marketing segments. --- ## Creating a Group 1. Click **Groups** in the left sidebar. 2. Click **New Group**. 3. In the **Give the Name of the Group** field, enter a descriptive name for your group. 4. Click **Create**. --- ## Adding a Single Member (`Add New Member`) To add an individual recipient to an existing group: 1. Open **Groups** in the left sidebar and locate your group. 2. Click **Add New Member**. 3. Enter the **Mobile Number** (required) and optionally fill in **First Name**, **Last Name**, and **Reference Code** (`Ref.Number`). 4. Submit the form. > **NOTE** > If the mobile number you enter does not yet exist in your [Contacts](https://docs.rayosms.nl/en/contacts-and-groups/contacts/) directory, Rayo SMS automatically creates the corresponding Contact record as well. --- ## Bulk Importing Members (`Add Many Members`) You can import hundreds or thousands of recipients into a group at once using the bulk import tool. 1. Go to **Groups** and click **Add Many Members** on the target group. 2. Paste your recipient list into the text area with **one recipient per line**. 3. Each line can contain just the mobile number, or comma-separated values in the format: `MobileNumber,FirstName,LastName,ReferenceCode` 4. Submit the form to start the background import. ### Bulk Import Format Example Below is the exact format accepted by the **Add Many Members** tool: ```text +306972669766 +306972669762 +306972669761,John,Smith +306972669760,Mary,Foo,cust-2343 +306972669759,James ``` - **Country Prefix Optional**: Mobile numbers do not need to start with a country code prefix. For example, entering `6972669766` automatically applies your account's **Default Sending-To Country** prefix (such as `+30`). - **Optional Fields**: You can omit trailing fields on any line (e.g., mobile number only, mobile + first name, or mobile + first name + last name + reference code). ### Asynchronous Background Import When you submit a bulk import, Rayo SMS queues the list for asynchronous processing in the background and displays the confirmation message: > `Mobile numbers have been stored for further processing` You do not need to keep your browser window open. As soon as all mobile numbers have been processed and added to the group, Rayo SMS sends an **email notification** to your account email address. --- ## Viewing & Removing Group Members To inspect the recipients inside a group, click on the group's members list from the **Groups** page. - To remove a recipient from a specific group, click **Remove Mobile From Group** next to their entry. - **Contacts Database Preserved**: Clicking **Remove Mobile From Group** only detaches the number from that specific group—**the contact remains in your main [Contacts](https://docs.rayosms.nl/en/contacts-and-groups/contacts/) database** (and in any other groups they belong to). --- ## Section: Credits & Billing ### Ordering Credits & Payment Methods Source: https://docs.rayosms.nl/en/billing/purchasing-credits/ Description: Learn how Rayo SMS prepaid credits work, commercial terms, and how to purchase credits via Card, Bank Deposit, or Purchase With Credit. Rayo SMS operates on a transparent, prepaid credit model. To purchase credits, sign in to the [Web Application](https://sms.rayosms.nl) and click **Credits** in the left sidebar (or click the **Credits Left** badge in the top navigation bar), then select **Order Credits**. --- ## How SMS Credits Work - **Prepaid Model**: Credits must be available in your account balance before sending live SMS messages (testing with Simulation Mode consumes `0` credits). - **Pricing & VAT**: Displayed per-credit prices exclude VAT. Applicable VAT is calculated and added at checkout based on your confirmed tax profile. - **Credit Consumption**: **1 credit = 1 standard SMS part** (up to 160 GSM 7-bit characters; multi-part messages over 160 characters consume 1 credit per 153-character segment) for your destination country pricing. - **1-Year Validity**: Purchased credits must be consumed within **1 year (365 days)** from the purchase date. Any unused credits remaining after 1 year are automatically nullified. - **No Refunds or Cancellations**: All credit purchases are final and non-refundable. - **Invoicing**: Official tax invoices are issued automatically using your confirmed **Company Details** and sent to your account's contact email address. --- ## Three Payment Methods On the **Order Credits** page, you can choose between three payment methods depending on whether you prioritize instant allocation or zero payment processing fees: #### 1. Online Purchase with Card ### Online Purchase with Card (Instant) Pay online using any major credit or debit card (VISA, Mastercard) processed securely via Stripe for **instant credit allocation**. 1. Open **Credits -> Order Credits** and select the **Online Purchase with Card** tab. 2. Enter the desired **Number Of Credits** (must meet or exceed the displayed minimum credit purchase threshold). 3. Review the calculated total amount (including VAT) and the estimated net credits to be allocated, then click the blue payment button showing the calculated EUR amount. 4. Enter your **Cardholder Name**, **Card Number**, and **Expiration Month/Year** to complete the payment. > **NOTE: Card Processing Fees** > Card purchases incur payment processor fees, which are reflected as a slight reduction in the net credits allocated to your balance. Before you pay, the UI displays the exact estimated credits expected (which varies slightly depending on card type and issuing region/currency). > > **To receive 100% of your ordered credits with zero processing fees**, use **Bank Deposit** or **Purchase With Credit**. > **TIP: Card Security** > Rayo SMS **never stores your card details** in its database. All card numbers and sensitive payment data are transmitted directly to the PCI-DSS compliant payment processor (Stripe). #### 2. Bank Deposit ### Bank Deposit (Zero Fees) Pay via wire transfer / bank deposit to avoid card processor fees entirely. 1. Open **Credits -> Order Credits** and select the **Bank Deposit** tab. 2. Review the listed **IBAN bank accounts** and the minimum deposit amount (including VAT). 3. Transfer any amount equal to or above the minimum deposit threshold into one of the displayed IBAN accounts. 4. Email your payment receipt to the address shown on the page, or submit a notification via the in-app **Contact** form ([Contact Us](https://sms.rayosms.nl/set_locale?locale=en&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us)). 5. As soon as your deposit is verified by our billing team, the full credit amount is allocated to your account. #### 3. Purchase With Credit ### Purchase With Credit (Instant + Bank Settlement) **Purchase With Credit** combines the speed of instant credit allocation with the zero-fee benefit of a bank deposit. It is available to eligible accounts that have been enabled by the platform or account administrator (`Allowed To Purchase With Credit`). 1. Open **Credits -> Order Credits** and select the **Purchase With Credit** tab. 2. Click **Purchase With Credit**. 3. Your account is **immediately and automatically credited** with the pre-approved credit package so you can dispatch urgent SMS campaigns without waiting for bank clearing. 4. Settle the corresponding EUR amount (including VAT) via bank deposit to one of the listed IBAN bank accounts. > **CAUTION: Order Acknowledgement Requirement** > Once your bank transfer is received and reconciled, the administrator **acknowledges** (`Acknowledge`) your credit order. > > **Note:** A previous credit order must be acknowledged by the administrator before you can place another **Purchase With Credit** order. You can check the **Acknowledged?** status of your orders at any time in [Order History](https://docs.rayosms.nl/en/billing/orders-and-alerts/). --- ### Order History & Low-Balance Alerts Source: https://docs.rayosms.nl/en/billing/orders-and-alerts/ Description: Track your past SMS credit purchases, check order acknowledgement status, and configure automated low-balance SMS alerts. Rayo SMS provides a complete audit trail of all your credit purchases along with automated SMS notifications so your account never runs out of credits unexpectedly. --- ## Viewing Order History To view all past credit transactions, sign in to the [Web Application](https://sms.rayosms.nl) and navigate to **Credits -> Order History** (`/sms_credit_sales`). Each record in your **Order History** displays: - **Sold At**: The exact date and timestamp when the credit order was created. - **Number Of Credits**: The net number of SMS credits added to your balance. - **Amount (Excl. VAT & Paid with VAT)**: The net monetary value and the total amount including VAT. - **Payment Method**: Indicates whether the order was placed via `Credit Or Debit Card` or `Bank deposit`. - **Acknowledged?**: Shows whether a bank deposit or [Purchase With Credit](https://docs.rayosms.nl/en/billing/purchasing-credits/) order has been reconciled and acknowledged by the administrator. - **Transaction & Card Metadata**: For card purchases, displays the card type, last 4 digits of the card, payment processor transaction ID, and the card payment fee expressed in credits. --- ## Configuring Low-Balance SMS Alerts When running automated transactional SMS flows (such as OTPs, booking confirmations, or order updates via the API) or scheduled campaigns, running out of credits can interrupt deliveries. You can configure up to two mobile numbers to receive an automatic SMS alert whenever your credit balance runs low. 1. In the top navigation bar, click **Advanced -> Settings -> Low Credit Alert Recipients** (`/settings/low_credit_alert_recipients`). 2. Enter your primary mobile number in the **1st Mobile** field. 3. Optionally enter a secondary recipient in the **2nd Mobile** field (for example, a finance manager or on-call engineer). 4. Click **Save**. ### How the Dynamic Alert Threshold Works Instead of relying on a static number that might be too small for high-volume senders, Rayo SMS dynamically adapts to your actual sending volume: - Rayo SMS calculates your **average daily credit consumption over the last 30 days** (`DAILY_BALANCE_AVERAGE_RANGE = 30`). - If your account has no recent sending activity over the past 30 days, a **default threshold of 100 credits** is used. - Whenever your remaining credit balance drops below this daily average threshold, Rayo SMS automatically dispatches a low-balance warning SMS to your configured **1st Mobile** and **2nd Mobile** numbers. > **TIP: Disabling Low-Balance Alerts** > To stop receiving low-balance SMS alerts, go to **Advanced -> Settings -> Low Credit Alert Recipients**, clear both the **1st Mobile** and **2nd Mobile** fields, and click **Save**. --- ## Section: Privacy, Security & Team ### Message Masking & GDPR Privacy Source: https://docs.rayosms.nl/en/account-and-security/message-masking/ Description: Permanently mask sensitive SMS message bodies (OTPs, passwords, personal data) on demand, immediately, or after a configurable delay. Organizations sending One-Time Passwords (OTPs), temporary credentials, banking alerts, medical appointment reminders, or personally identifiable information (PII) often need to **prove that an SMS was delivered** without retaining the sensitive message content in third-party logs. Rayo SMS provides built-in **Permanent Message Masking** to help you comply with GDPR and strict internal data-retention policies. --- ## What Permanent Masking Does When a message is masked in Rayo SMS: 1. **Body Replacement**: The `sms_body` of completed messages (those in a final state: `sent`, `delivered`, `not_delivered`, `unknown_delivery`, or `failure`) is overwritten in the database with exactly **60 asterisks**: ```text ************************************************************ ``` 2. **Irreversible Deletion**: The original message text is permanently discarded from the database and **cannot be recovered by anyone**—including Rayo SMS administrators. 3. **Audit Metadata Preserved**: All non-content delivery metadata remains intact for billing reconciliation, customer support verification, and compliance auditing: - Submission & delivery timestamps - Recipient mobile number - Sender Identifier (Sender ID) - Final delivery status (`delivered`, `not_delivered`, etc.) - Client reference number (`clientRequestId`) - Credit cost > **DANGER: Masking is Permanent and Irreversible** > Once a message body is masked with `************************************************************`, the original text is permanently overwritten in storage. It cannot be undone or retrieved. --- ## Three Ways to Mask Messages You can mask messages manually at any time, or configure automated masking rules in [the Web Application](https://sms.rayosms.nl). ### Option 1: On-Demand Manual Masking Use on-demand masking when you want to manually purge the text of all previously sent messages: 1. Navigate to **Sent** (`/messages`) in the left sidebar. 2. Click the red **Mask Messages Permanently** button. 3. Confirm the prompt in the dialog box. 4. A background job immediately begins masking all eligible completed messages in your account and sends you a **confirmation email** as soon as the process finishes. --- ### Option 2: Immediate Automatic Masking Use immediate masking if your security policy requires that message text is never retained once an SMS finishes processing (ideal for OTP and 2FA traffic): 1. Navigate to **Advanced** (top bar) -> **Settings** -> **Mask Messages** (`/settings/mask_messages`). 2. Click **Switch On Immediate Masking**. 3. From that moment on, every outbound message will have its `sms_body` permanently masked as soon as processing finishes. --- ### Option 3: Delayed Automatic Masking (After X Minutes) Use delayed masking when your customer support team needs a short window to view recent message content for troubleshooting, after which messages should be redacted automatically: 1. Navigate to **Advanced** (top bar) -> **Settings** -> **Mask Messages** (`/settings/mask_messages`). 2. Enter the desired retention window in minutes—from **`1` minute** up to **`129,600` minutes** (**90 days**). 3. Click **Switch On Masking After This Number Of Minutes** (or **Update Number Of Minutes** if delayed masking is already active). 4. Message bodies remain visible during your configured window and are automatically and permanently masked once the timer expires. --- ### Team Members, Invitations & Account Switching Source: https://docs.rayosms.nl/en/account-and-security/team-members/ Description: Invite developers to your Rayo SMS account, manage role-based permissions, and switch seamlessly between multiple accounts. Rayo SMS allows you to collaborate securely with technical team members—such as software engineers and system integrators—by inviting them to your account rather than sharing your account owner credentials. --- ## Member Roles & Permissions Rayo SMS currently supports the **`developer`** team member role, designed specifically for technical integration and security configuration while keeping commercial, contact, and messaging data restricted to the Account **Owner**. | Feature / Area | Account Owner | `developer` Member | | :--- | :---: | :---: | | **Dashboard Overview** | Yes | Yes | | **User Preferences & Language Preference** (`/preferences`) | Yes | Yes | | **Advanced -> Settings -> API Keys** (`/settings/api_keys`) | Yes | Yes | | **Advanced -> Settings -> Callbacks** (`/settings/callbacks`) | Yes | Yes | | **Advanced -> Settings -> Mask Messages** (`/settings/mask_messages`) | Yes | No | | **Advanced -> Settings -> Low Credit Alert Recipients** | Yes | No | | **Send Message (UI Campaigns)** | Yes | No | | **Sent Message History** (`/messages`) | Yes | No | | **Contacts & Groups** | Yes | No | | **Credits & Order History** | Yes | No | | **Company Details & Billing Profile** | Yes | No | | **Managing Team Members & Invitations** | Yes | No | --- ## Inviting a Team Member 1. Sign in to the [Web Application](https://sms.rayosms.nl) as the Account Owner. 2. In the top navigation bar, go to **Advanced -> Member Invitations** and click **Invite a Member**. 3. Enter the invitee's email address in **Email** and repeat it in **Confirm Email**. 4. Select the role (`developer`). 5. Click **Send Invitation**. > **NOTE: Invitation Rules** > - The invited user must have a registered account on the **same brand/platform**. > - You cannot send an invitation to your own email address. > - You cannot create a duplicate invitation if a pending invitation for that user already exists. --- ## Managing Sent Invitations Navigate to **Advanced -> Member Invitations -> Sent** to view all invitations you have issued and their current status: - `Sent` — Invitation is pending a response from the recipient. - `Accepted` — The user accepted and is an active member (or was previously a member). - `Expired` — The invitation was expired before being accepted. - `Denied` — The recipient declined the invitation. ### Actions on Pending Invitations For any invitation currently in the `Sent` state, you can: - **Resend**: Automatically expires the current invitation and sends a fresh invitation email. - **Expire**: Immediately invalidates the pending invitation so it can no longer be accepted. - **Delete**: Removes an unaccepted invitation record. *(Note: **Accepted** invitations cannot be deleted, preserving a permanent security audit trail of everyone who has had access to your account.)* --- ## Accepting or Denying Received Invitations When another Account Owner invites you to join their team: 1. Sign in to your Rayo SMS account. You will be prompted upon sign-in, or you can navigate to **Advanced -> Member Invitations -> Received**. 2. Review the inviting account details and assigned role. 3. Click **Accept** to gain access, or **Deny** to decline the invitation. --- ## Switching Between Accounts (`Switch Account`) Once you have accepted an invitation to one or more other accounts, you can switch your active workspace at any time without logging out: 1. Click your **username** at the top-left of the sidebar. 2. Select **Switch Account** (`/account_selection/new`). 3. Choose between **Your account** (your personal/primary account) and **Other accounts** (accounts where you are a team member). 4. Click **Continue**. The interface will immediately reload in the context of the selected account. --- ## Removing an Active Team Member As the Account Owner, you can revoke a team member's access at any time: 1. In the top navigation bar, click **Advanced -> Members** (`/members`). 2. Locate the active member in the list. 3. Click **Remove** to immediately revoke their access to your account. --- ## Section: Developers, API & Webhooks ### API Overview & Managing API Keys Source: https://docs.rayosms.nl/en/developers/api-overview-and-keys/ Description: Integrate Rayo SMS into your applications using our RESTful HTTP API, manage up to 25 API keys, and explore core endpoints. Integrate Rayo SMS directly into your ERP, CRM, e-commerce store, booking platform, or custom application using our fast and reliable **RESTful HTTP API**. > **TIP: Interactive API Reference** > For complete request/response schemas, status codes, error payloads, and code examples, consult the **[Full Rayo SMS API Reference](https://api-docs.rayosms.nl)** at `https://api-docs.rayosms.nl`. --- ## API Base Endpoint All HTTP API requests must be made over **HTTPS** to the following base URL: `https://api.rayosms.nl/v1` --- ## Managing API Keys You can manage your API credentials in the [Web Application](https://sms.rayosms.nl) by navigating to **Advanced -> Settings -> API Keys** (`/settings/api_keys`). - **Automatic Initial Key**: An initial API key is automatically generated for you as soon as your account is created. - **Up to 25 API Keys per Account**: Click **Generate API Key** to create additional keys (up to **25 keys** maximum). Using separate keys is recommended for isolating production, staging, and individual microservices or third-party integrations. - **Lifecycle Controls**: You can **Activate**, **Deactivate**, or **Delete** individual API keys at any time without affecting your other active keys. --- ## Authentication Every API request must include an active API key in the HTTP `Authorization` header over HTTPS: ```http Authorization: Bearer YOUR_API_KEY Content-Type: application/json ``` > **CAUTION: Account & Key Must Both Be Active** > For an API request to succeed, **both** your Rayo SMS user account and the specific API key used in the `Authorization` header must be **Active**. If a key is deactivated, requests using it will be rejected immediately. --- ## Core Endpoints Summary Below is an overview of the primary Rayo SMS API v1 endpoints. Visit the [Full Rayo SMS API Reference](https://api-docs.rayosms.nl) for detailed parameter specifications and sample payloads. ### `POST /v1/send_sms` — Send Single, Bulk, or Scheduled SMS Dispatches an SMS message to one or more recipient mobile numbers and/or [Contact Groups](https://docs.rayosms.nl/en/contacts-and-groups/groups/). - **Recipients & Groups**: Pass an array of mobile numbers, group IDs, or both (with automatic deduplication and suppression of contacts marked **Invalid**). - **Scheduling (`scheduledAt`)**: Optionally schedule the message for future delivery by providing an ISO-8601 timestamp. - **Idempotency & Tracking (`clientRequestId`)**: Supply your own unique reference ID to correlate status checks and [webhook callbacks](https://docs.rayosms.nl/en/developers/webhooks-and-callbacks/). - **Webhook Callbacks**: Enable delivery status callbacks per request. - **Free Sandbox Testing (`simulateSendFlag`)**: Set `simulateSendFlag: true` to validate your request payload and integration end-to-end while consuming **0 credits** and without delivering real SMS handsets. ### `GET /v1/balance_in_credits` — Check Credit Balance Returns your account's current available SMS credit balance as an integer so you can monitor usage programmatically. ### `GET /v1/check_status` — Query Delivery Status Retrieves the current processing status and per-recipient delivery reports of a previously submitted SMS request by querying either your custom `clientRequestId` or the Rayo SMS `smsServerRequestId`. ### `DELETE /v1/sms_request_schedules/:id` — Cancel a Scheduled SMS Cancels and deletes a pending scheduled SMS request (`scheduledAt`) before its scheduled execution time, refunding the reserved credits back to your available balance. --- ### Delivery Callbacks (Webhooks) & Signature Verification Source: https://docs.rayosms.nl/en/developers/webhooks-and-callbacks/ Description: Configure real-time HTTP webhook callbacks for SMS delivery statuses, verify cryptographic signatures, and rotate signing secrets with zero downtime. The **Rayo SMS Callback API** (Webhooks) automatically notifies your server in near real-time whenever an outbound SMS message reaches a final delivery state (`sent`, `delivered`, `not_delivered`, `unknown_delivery`, or `failure`)—eliminating the need to poll `GET /v1/check_status`. --- ## Configuring Your Callback Endpoint You can configure and test your webhook listener in the [Web Application](https://sms.rayosms.nl) under **Advanced -> Settings -> Callbacks** (`/settings/callbacks`). 1. Navigate to **Advanced** (top bar) -> **Settings** -> **Callbacks** (`/settings/callbacks`). 2. Set **Enabled** to **Yes**. 3. In the **URL** (`Callback URL`) field, enter the full **HTTPS** URL of your webhook endpoint. 4. Select your preferred **HTTP Verb**: `get` or `post`. 5. Click **Test** to send a live test webhook request from Rayo SMS to your server. Verify that your endpoint responds with HTTP `200 OK` and that the banner displays: > `Callback API Properties seem to be Ok` 6. Click **Save** to persist your configuration. > **NOTE: Disabling Callbacks** > To stop receiving webhook notifications and clear your stored endpoint settings, click **Delete and Disable Callback URL** on the Callbacks settings page. --- ## Verifying Webhook Signatures (`Signing Secret`) Because your webhook URL is publicly reachable on the internet, your server should verify that every incoming callback genuinely originated from Rayo SMS and was not tampered with or spoofed by a third party. - **Signature Header**: Every callback HTTP request sent by Rayo SMS includes a cryptographic signature in the `X-sms-rayosms-nl-Signature` HTTP header. - **Account Signing Secret**: The signature is computed using your account's unique **Signing Secret** (displayed next to `Signing Secret:` on the **Advanced -> Settings -> Callbacks** page). - **Implementation Details**: See [the API Reference Callback section](https://api-docs.rayosms.nl) (`https://api-docs.rayosms.nl`) for the exact HMAC signature verification algorithm, query/body payload parameters, and retry behavior. --- ## Zero-Downtime Signing Secret Rotation (`Expire Signing Secret`) If your security policy requires periodic key rotation—or if you suspect your current Signing Secret may have been exposed—you can schedule a controlled expiration in **Advanced -> Settings -> Callbacks**: 1. Open **Advanced -> Settings -> Callbacks** (`/settings/callbacks`). 2. Next to your **Signing Secret**, click **Expire secret...**. 3. Select when the current secret should expire to give your engineering team time to prepare for the rotation. 4. If you need to abort a scheduled rotation before the timer elapses, click **Do not expire secret...** to cancel the pending expiration. 5. Once the scheduled expiration time is reached, the old secret is automatically retired and a **new Signing Secret** is generated immediately. --- ## Section: Integrations ### WSMS (WordPress & WooCommerce SMS) Source: https://docs.rayosms.nl/en/integrations/wsms/ Description: Send SMS notifications, OTP/2FA codes, and marketing campaigns from WordPress and WooCommerce using the official Rayo SMS integration in WSMS. Rayo SMS is officially integrated as a built-in SMS gateway in **[WSMS (formerly WP SMS)](https://wsms.io)**, the leading SMS and messaging plugin for WordPress and WooCommerce. With this integration, WSMS customers can connect their Rayo SMS account directly from their WordPress dashboard—without writing any code—to power automated WooCommerce order and shipping notifications, SMS two-factor authentication (2FA) and OTP login, form alerts, and targeted bulk SMS campaigns with fast, reliable delivery and competitive pricing. - [Set up the Rayo SMS gateway in WSMS](https://wsms.io/docs/rayo-gateway-setup/): Follow the step-by-step instructions to connect your Rayo SMS account to WSMS. - [Visit WSMS (wsms.io)](https://wsms.io): Explore the WSMS WordPress & WooCommerce plugin features and documentation. --- ## Section: White-Label Platform ### White-Label Partner & Reseller Guide Source: https://docs.rayosms.nl/en/white-label/partner-guide/ Description: Operate your own branded Web-to-SMS SaaS platform on Rayo SMS infrastructure, collect customer payments directly, and manage user accounts and orders. The **Rayo SMS White-Label Program** enables partners, agencies, software vendors, and telecom resellers to operate their own fully branded Web-to-SMS SaaS business—under their own custom domain, logo, email identity, and supported interface languages (**English**, **Greek**, and **Dutch**)—while running on Rayo SMS infrastructure. --- ## How White-Label Balances Work As a **Brand Owner**, your master account holds a **wholesale SMS credit balance**: - When one of your customers purchases credits online (or when you manually allocate credits to a customer), the corresponding number of credits is **automatically transferred from your Brand Owner wholesale balance to the child user's balance**. - Ensure your Brand Owner master account maintains sufficient wholesale credits so customer card purchases and credit orders can be fulfilled seamlessly. --- ## Receiving Customer Payments Directly White-Label partners collect 100% of customer payments directly into their own Stripe and bank accounts. #### Stripe Accounts (Online Card Payments) Navigate to **Advanced -> Stripe Accounts** in the top bar: 1. Click **Connect Stripe Account** to link your own Stripe merchant account via OAuth. 2. Once connected, click **Activate**. 3. All online debit/credit card purchases made by your customers are paid **directly into your Stripe account**. #### Bank Accounts (Wire Transfers) Navigate to **Advanced -> Bank Accounts** in the top bar: 1. Add and manage your company's bank accounts (`Bank Name`, `Account Holder`, `IBAN`, `Country`, and `Individual` / `Company` designation). 2. Active bank accounts are automatically displayed to your customers on their **Bank Deposit** and **Purchase With Credit** checkout tabs. --- ## Managing Your Brand Details (`Settings -> Brand`) As a **Brand Owner**, you can view and update your brand's configuration directly from the [Web Application](https://sms.rayosms.nl) by navigating to **Advanced -> Settings -> Brand**: - **Domains**: - **Website URL**, **Developers Documentation URL**, **SDKs Documentation URL**, and **Application Documentation URL**. - **Facebook Page URL**, **X Page URL**, and **LinkedIn Page URL**. - **Host Header** and **Contact From Email Address** are displayed as **read-only** (managed at the platform infrastructure level). - **Names**: - **Application Name**: The full brand name displayed across the interface, page titles, and emails. - **Short Name**: Up to 5 characters displayed when the left sidebar is collapsed. - **Communication**: - **Login Logo**: Upload or replace the logo image displayed on your sign-in and public entry pages. - **SMS Out From Label**: The default alphanumeric sender identifier (up to 11 characters; must not be a mobile number) associated with your brand. - **Contacts**: - **Registered Address**, **Contact Phone**, and **CEO Name**. - **Other**: - **Maximum Number Of Credits On Credit**: The fixed number of credits immediately allocated to an eligible customer of your brand when they use **Purchase With Credit** (set to `0` to disable purchasing with credit). - **Online Purchase**: Enable or disable online credit purchases for your brand's customers. - **Created At** and **Updated At** are displayed for reference as read-only fields. Click **Save** and confirm the prompt to apply your changes immediately. --- ## Defining Your Brand's Price Lists (`Advanced -> Price Lists`) As a **Brand Owner**, you can define and manage the SMS credit pricing for your brand by navigating to **Advanced -> Price Lists** (`/price_lists`): - **Viewing Price Lists**: All price lists of your brand are displayed in ascending order of **Number Of Credits** (`ID`, `Number Of Credits`, `Price`, `Charge VAT`, `VAT Percentage`, `Created At`, and `Updated At`). A package with `number_of_credits = -1` applies to any credit quantity and is displayed as **Any**. - **Creating a Price List**: Click **New Price List** (`/price_lists/new`) at the top right of the table, fill in the form, and click **Create** (then confirm the prompt): - **Number Of Credits**: The credit package size (use `-1` for any number of credits). - **Price**: The price per credit **excluding VAT**. If **Charge VAT** is checked, VAT is calculated and added on top of this price. - **Charge VAT**: Check to apply VAT on top of the price per credit. - **VAT Percentage**: The integer VAT rate (`0`–`100`). - **Editing or Deleting a Price List**: Click any row in the price lists table to open its edit page (`/price_lists/:id/edit`), where you can: - Update the pricing fields and click **Save** (confirming the prompt) to save your changes. - Click **Delete** (confirming the prompt) to remove the price list from your brand. --- ## Managing Your Customers (`Manage` Menu) Brand Owners have access to a dedicated **Manage** menu in the top navigation bar of the [Web Application](https://sms.rayosms.nl) to administer customer accounts, credit orders, and tax profiles. ### 1. Users (`Manage -> Users`) In **Manage -> Users**, you can oversee your entire customer base: - **Search & Inspect**: Search customers by **username** or **contact email**, and inspect their current SMS credit balance and account activation timestamps. - **Account Status**: **Activate** or **Deactivate** any customer account immediately. - **Per-User Configuration Flags**: - **Allowed To Purchase With Credit**: Enable or disable the [Purchase With Credit](https://docs.rayosms.nl/en/billing/purchasing-credits/) tab for trusted customers who settle invoices via post-purchase bank transfer. - **Send Daily Report Email**: Toggle automated daily summary emails for the user. - **Has To Submit Company Details**: Control whether the user is required to submit and have confirmed Company Details before sending live SMS messages. ### 2. User Orders (`Manage -> User Orders`) In **Manage -> User Orders**, you can manage all customer credit transactions: - **View & Filter**: Browse all credit purchases across your brand or filter orders by a specific user. - **Manual Order Allocation (`New User Order`)**: Click **New User Order** to manually credit a customer's account (for example, after verifying an incoming **Bank Deposit** wire transfer) and attach internal administrative notes. - **Acknowledge Credit Orders (`Acknowledge`)**: When a customer uses **Purchase With Credit** and subsequently settles the payment via bank transfer, click **Acknowledge** on their order to mark it as paid and unlock their ability to place future credit orders. ### 3. User Company Details (`Manage -> User Company Details`) In **Manage -> User Company Details**, you review and manage the billing and tax profiles submitted by your customers: - Inspect newly submitted company profiles (VAT number, tax office, legal entity name, address). - Mark submissions as **Confirmed** (`Confirmed`) to unlock live messaging and invoicing, or **Rejected** (`Rejected`) if corrections are required. - Update a customer's company and tax details on their behalf whenever their business information changes. --- ## Section: Support & Troubleshooting ### FAQ, Troubleshooting & Support Source: https://docs.rayosms.nl/en/support/faq-and-contact/ Description: Frequently asked questions about account verification, GSM character counts, Sender IDs, billing, and how to contact Rayo SMS 24/7 support. Find quick answers to common questions about using Rayo SMS, or reach out to our 24/7 support and engineering team. --- ## Account & Verification ### Why can't I send SMS right after signing up? Before sending live SMS messages to handsets, your account must meet three requirements: 1. **Confirmed Company Details**: Your submitted billing/company profile must be reviewed and marked as **Confirmed**. 2. **Confirmed & Active Sender ID**: You must have at least one [Sender Identifier](https://docs.rayosms.nl/en/sender-ids/managing-sender-ids/) that is both **Confirmed** and **Active** (`Can Be Used? = Yes`). 3. **Available Credits**: Your account must have a positive SMS credit balance. *Tip:* While waiting for company confirmation or before purchasing credits, you can test both the Web Application and the HTTP API using **Simulation Mode** (`simulateSendFlag`), which consumes `0` credits. ### How do I update my confirmed Company Details? Once your Company Details have been confirmed, they are locked in the UI to ensure tax and invoicing integrity. To request a change (such as a new address, company name, or VAT detail), submit a request via the in-app **Contact** form or the [Contact Us page](https://sms.rayosms.nl/set_locale?locale=en&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us). ### How do I change the language of the web application and system emails? Click your **username** at the top-left of the sidebar, select **Preferences** (`/preferences`), choose your preferred **Language** (**English**, **Greek**, or **Dutch**), and click **Save**. Your selection updates the web interface immediately, persists across future sign-ins, and ensures all automated system emails are sent to you in your chosen language. See [Creating & Accessing Your Account](https://docs.rayosms.nl/en/getting-started/account-and-login#user-preferences--language-preference-preferences). --- ## Messaging & Character Count ### Why did my message count as 2 or more credits? A standard single-part SMS supports up to **160 characters** (1 credit). When a message exceeds 160 characters (up to the 1,000-character maximum), it is split into concatenated segments of **153 characters per part** (because 7 characters worth of header data are used to reassemble the message on the recipient's handset). Each 153-character segment consumes 1 credit per recipient. See [Character Limits, Encoding & Cost Calculation](https://docs.rayosms.nl/en/messaging/length-and-encoding/). ### Why can't I paste more than 500 numbers in the Recipients box? The manual **Recipients** text box in the **Send Message** screen accepts up to **500 mobile numbers** per submission. To send a campaign to **more than 500 recipients** at once, import your numbers into a [Contact Group](https://docs.rayosms.nl/en/contacts-and-groups/groups/) and select that Group when sending. ### Why was a message blocked as a duplicate? To prevent accidental double-sends and protect your credits, Rayo SMS blocks sending the **exact same SMS text** to the **same mobile number** within a **6-hour window** (`has already been sent this message within the last 6 hours`). If you need to send another message to the same number within 6 hours, change the message text (for example, by including a unique code, timestamp, or different wording). --- ## Sender Identifiers (Sender IDs) ### Why can't I delete a Sender ID? A Sender Identifier can only be deleted if it has **never** been used to send an SMS. Once a Sender ID has been used in at least one delivery, it cannot be deleted (`It can't be deleted because it has been used for SMS delivery in the past`) in order to preserve historical delivery audit logs. Click **Deactivate** instead to hide it from active use. See [Managing Sender Identifiers](https://docs.rayosms.nl/en/sender-ids/managing-sender-ids/). ### Why didn't my new mobile Sender ID let me create a second one? Only **one** mobile telephone number Sender Identifier can be in the `pending_confirmation` state at a time. You must either confirm the pending mobile number using the **5-digit SMS code** sent to your phone, or wait **15 minutes** for the pending confirmation to expire automatically before registering another mobile number. --- ## Billing & Credits ### Why did I receive slightly fewer credits when paying by card? Online card payments incur payment processor fees, which are deducted as a small credit equivalent (the checkout screen displays the estimated net credits before you complete payment). To receive 100% of your ordered credits with **zero processing fees**, choose **Bank Deposit** or **Purchase With Credit** on the [Order Credits](https://docs.rayosms.nl/en/billing/purchasing-credits/) page. ### Do SMS credits expire? **Yes.** Purchased SMS credits are valid for **1 year (365 days)** from the date of purchase. Any credits remaining unused after 365 days are nullified. --- ## Contacting Rayo SMS Support #### In-App & Web Contact Form Signed-in users can click **Contact** in the left sidebar (`/contact_us_requests/new`) to message our team directly with their account context attached, or use our public [Contact Us page](https://sms.rayosms.nl/set_locale?locale=en&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us). #### 24/7 Live Chat & Engineering Support Our support team is available **24/7** via live chat on our [official website](https://www.rayosms.nl). We also provide direct **developer-to-developer engineering assistance** for custom HTTP API and White-Label integrations. ### Legal & Terms of Service For complete commercial, privacy, and acceptable-use policies, please review our [Terms and Conditions of Service](https://sms.rayosms.nl/set_locale?locale=en&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fterms_and_conditions_of_service). --- # Part 2: Ελληνική Τεκμηρίωση / Greek Documentation (`/el/`) ## Ενότητα: Ξεκινώντας (Getting Started — Greek) ### Επισκόπηση Πλατφόρμας Source: https://docs.rayosms.nl/el/getting-started/overview/ Description: Γνωρίστε τις δυνατότητες της πλατφόρμας μαζικών και συναλλακτικών SMS Rayo SMS και περιηγηθείτε στο περιβάλλον εργασίας της εφαρμογής. Το **Rayo SMS** (`sms.rayosms.nl`) είναι μια σύγχρονη, αξιόπιστη διαδικτυακή πλατφόρμα (Web-to-SMS & REST API SaaS) σχεδιασμένη για επιχειρήσεις, οργανισμούς, e-shops και ομάδες ανάπτυξης λογισμικού που χρειάζονται άμεση, ασφαλή και μετρήσιμη επικοινωνία μέσω μηνυμάτων SMS. Μέσα από ένα ενιαίο περιβάλλον εργασίας μπορείτε να εκτελείτε μαζικές προωθητικές καμπάνιες, να προγραμματίζετε μελλοντικές αποστολές, να διασυνδέετε τις εφαρμογές σας μέσω HTTP API και να παρακολουθείτε την παράδοση κάθε μηνύματος σε πραγματικό χρόνο. --- ## Βασικές Δυνατότητες της Πλατφόρμας #### Μαζικά Διαφημιστικά SMS (Bulk Marketing SMS) Στείλτε χιλιάδες SMS ταυτόχρονα σε μία ή περισσότερες **Ομάδες** επαφών. Το σύστημα εκτελεί **αυτόματη αποφυγή διπλοεγγραφών** (deduplication) όταν ένας αριθμός ανήκει σε πολλαπλές επιλεγμένες ομάδες και εξαιρεί αυτόματα επαφές που έχουν χαρακτηριστεί ως **Άκυρος** (`Άκυρος; = Ναι`). #### Συναλλακτικά SMS & Ειδοποιήσεις (Transactional SMS) Παραδώστε άμεσα κρίσιμα μηνύματα όπως κωδικούς μιας χρήσης (OTP / 2FA), επιβεβαιώσεις παραγγελιών, ειδοποιήσεις αποστολής courier και υπενθυμίσεις ραντεβού με υψηλή προτεραιότητα δρομολόγησης και πλήρεις αναφορές παράδοσης (DLR). #### Χρονοπρογραμματισμένες Αποστολές (Scheduled SMS) Ορίστε ακριβή μελλοντική ημερομηνία και ώρα αποστολής (**Να Αποσταλλεί Στις**) για μεμονωμένα ή ομαδικά μηνύματα. Διαχειριστείτε ή ακυρώστε ανά πάσα στιγμή τις εκκρεμείς αποστολές από την ενότητα **Χρονοπρογραμματισμοί** ή μέσω του REST API. #### Μόνιμη Απόκρυψη Μηνυμάτων GDPR (Message Masking) Ενεργοποιήστε τη **Μόνιμη Απόκρυψη Σώματος Μηνυμάτων** στις **Ρυθμίσεις** ώστε το κείμενο κάθε εξερχόμενου SMS να αντικαθίσταται αυτόματα και μη αναστρέψιμα με `ΧΧΧΧ` μετά την αποστολή, διασφαλίζοντας απόλυτη συμμόρφωση με τον κανονισμό GDPR. #### HTTP REST API & Webhooks (Callbacks) Ενσωματώστε την αποστολή SMS στις δικές σας εφαρμογές μέσω του REST API (`https://api.rayosms.nl/v1`). Δημιουργήστε πολλαπλά **Κλειδιά API** και καταχωρήστε **Callbacks** για να λαμβάνετε αυτόματες ενημερώσεις παράδοσης με επαλήθευση υπογραφής HMAC-SHA256. #### Πλατφόρμα White-Label SaaS Για μεταπωλητές και παρόχους υπηρεσιών: διαθέστε την πλατφόρμα με το δικό σας εμπορικό σήμα και domain, διαχειριστείτε τους δικούς σας **Χρήστες**, εγκρίνετε **Αναγνωριστικά Αποστολέα** και **Στοιχεία Εταιρείας Χρηστών**, και εισπράξτε πληρωμές απευθείας στους δικούς σας λογαριασμούς Stripe ή τράπεζας. --- ## Περιήγηση στο Περιβάλλον Εργασίας (UI) Μετά την [Είσοδο](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsessions%2Fnew) στον λογαριασμό σας, το περιβάλλον της εφαρμογής χωρίζεται σε δύο κύριες περιοχές πλοήγησης: την **Αριστερή Πλευρική Στήλη (Κύριο Μενού)** και την **Επάνω Γραμμή Εργαλείων (Top Bar)**. ### 1. Αριστερή Πλευρική Στήλη (Κύριο Μενού) Από την αριστερή στήλη έχετε άμεση πρόσβαση σε όλες τις καθημερινές λειτουργίες αποστολής και διαχείρισης: | Επιλογή Μενού | Διαδρομή | Περιγραφή Λειτουργίας | | :--- | :--- | :--- | | **Κεντρική Σελίδα** | `/` | Ο **Πίνακας Ελέγχου** με συνοπτικά στατιστικά, πρόσφατη δραστηριότητα και γρήγορες ενέργειες. | | **Αποστολή** | `/messages/new` | Η φόρμα σύνταξης και αποστολής (ή χρονοπρογραμματισμού) μεμονωμένων και ομαδικών SMS. | | **Απεσταλμένα** | `/messages` | Αναλυτικό ιστορικό όλων των απεσταλμένων μηνυμάτων, φίλτρα αναζήτησης και καταστάσεις παράδοσης (`Νέο`, `Στάλθηκε`, `Παραδόθηκε`, `Δεν Παραδόθηκε`, `Σφάλμα Επεξεργασίας`). | | **Χρονοπρογραμματισμοί** | `/sms_request_schedules` | Προβολή, φιλτράρισμα (`Μη Εκπληρωμένα`) και ακύρωση προγραμματισμένων αποστολών. | | **Ομάδες** | `/groups` | Δημιουργία ομάδων παραληπτών, διαχείριση μελών και μαζική εισαγωγή αριθμών (**Προσθήκη Πολλών Μελών**). | | **Επαφές** | `/contacts` | Κατάλογος όλων των αποθηκευμένων αριθμών κινητών, αναζήτηση με **Αρ.Αναφοράς** και διαχείριση κατάστασης εγκυρότητας (**Άκυρος;**). | | **Αναγνωριστικά Αποστολέα** | `/sender_identifiers` | Καταχώρηση νέων Sender IDs (**Νέο Αναγνωριστικό Αποστολέα**), παρακολούθηση επιβεβαίωσης και **Ενεργοποίηση** / **Απενεργοποίηση**. | | **Παραγγελία Μονάδων** | `/orders/new` | Αγορά πακέτων μονάδων SMS με **Αγορά με Κάρτα**, **Τραπεζική Κατάθεση** ή **Αγορά με Πίστωση**. | | **Ιστορικό Παραγγελιών** | `/orders` | Παρακολούθηση όλων των παραγγελιών μονάδων και της κατάστασης εξόφλησής τους. | | **Επικοινωνία** | `/contact_us` | Φόρμα άμεσης επικοινωνίας με την ομάδα υποστήριξης της πλατφόρμας. | --- ### 2. Επάνω Γραμμή Εργαλείων & Μενού Χρήστη Στην επάνω γραμμή και στο επάνω μέρος της αριστερής στήλης βρίσκονται τα στοιχεία ελέγχου του λογαριασμού σας, το υπόλοιπο μονάδων και τα μενού ρυθμίσεων: * **Μενού Χρήστη (Επάνω αριστερά στην πλευρική στήλη)**: Κάνοντας κλικ στο όνομα χρήστη (email) σας εμφανίζονται οι επιλογές: * **Προτιμήσεις** (`/preferences`): Διαχείριση των προτιμήσεων του χρήστη σας, συμπεριλαμβανομένης της **Προτίμησης Γλώσσας** (**Ελληνικά**, **Αγγλικά** ή **Ολλανδικά**), η οποία καθορίζει τόσο τη γλώσσα εμφάνισης της εφαρμογής όσο και τη γλώσσα των εξερχόμενων ενημερωτικών emails που λαμβάνετε. * **Αλλαγή λογαριασμού** (`/account_selection/new`): Εναλλαγή μεταξύ του δικού σας λογαριασμού και άλλων λογαριασμών στους οποίους είστε μέλος. * **Έξοδος**: Αποσύνδεση από την εφαρμογή. * **Υπόλ. Μονάδων (`Υπόλοιπο Μονάδων`)**: Εμφανίζει στην επάνω δεξιά γωνία σε πραγματικό χρόνο τις διαθέσιμες μονάδες SMS του λογαριασμού σας. Κάνοντας κλικ πάνω στην ένδειξη, μεταφέρεστε απευθείας στη σελίδα των μονάδων σας. #### Μενού «Προχωρημένες Ενέργειες» Το αναπτυσσόμενο μενού Προχωρημένες Ενέργειες συγκεντρώνει τις ρυθμίσεις ασφαλείας, τιμολόγησης, ομάδας και προγραμματιστών: * **Ρυθμίσεις** (`/settings`): * **Κλειδιά API**: Δημιουργία και διαχείριση κλειδιών πρόσβασης για το HTTP REST API. * **Callbacks**: Καταχώρηση webhook URLs για λήψη αναφορών παράδοσης. * **Μασκάρισμα Μηνυμάτων** (**Μόνιμη Απόκρυψη Σώματος Μηνυμάτων**): Ενεργοποίηση/απενεργοποίηση απόκρυψης περιεχομένου SMS (GDPR). * **Παραλήπτες Ειδοποιήσεων Χαμηλού Υπολοίπου**: Ορισμός διευθύνσεων email που ειδοποιούνται όταν οι μονάδες πέσουν κάτω από το επιθυμητό όριο. * **Brand** *(μόνο για ιδιοκτήτες Brand)*: Προβολή και ενημέρωση των στοιχείων του brand σας (URLs ιστοσελίδας, τεκμηρίωσης και κοινωνικών δικτύων, όνομα εφαρμογής και σύντομο όνομα, λογότυπο σύνδεσης, ετικέτα αποστολέα SMS και στοιχεία επικοινωνίας). * **Τιμοκατάλογοι** (`/price_lists`, *μόνο για ιδιοκτήτες Brand*): Ορισμός και διαχείριση των τιμοκαταλόγων μονάδων SMS του brand σας. * **Στοιχεία Εταιρείας** (`/company_details`): Καταχώρηση των φορολογικών και εταιρικών στοιχείων της επιχείρησής σας για έγκριση αποστολών και έκδοση τιμολογίων. * **Μέλη** (`/members`) & **Προσκλήσεις Μελών** (`/member_invitations`): Προσθήκη συνεργατών στον λογαριασμό σας. * **Προγραμματιστές**: Απευθείας σύνδεσμος προς την τεχνική τεκμηρίωση του API (`https://api-docs.rayosms.nl`). * **Λογαριασμοί Stripe** & **Τραπεζικοί Λογαριασμοί** *(για διαχειριστές White-Label)*: Διαχείριση μεθόδων είσπραξης πληρωμών από τους τελικούς πελάτες σας. #### Μενού «Διαχείριση» (Πλατφόρμα White-Label) Για τους διαχειριστές μιας εγκατάστασης White-Label, εμφανίζεται επιπλέον το μενού Διαχείριση στην επάνω γραμμή: * **Χρήστες**: Προβολή και διαχείριση όλων των εγγεγραμμένων πελατών, των τιμοκαταλόγων τους και των **Αναγνωριστικών Αποστολέα** τους. * **Παραγγελίες Χρηστών**: Έλεγχος, επιβεβαίωση και εκπλήρωση παραγγελιών μονάδων των πελατών σας. * **Στοιχεία Εταιρείας Χρηστών**: Έλεγχος και επιβεβαίωση ή απόρριψη των φορολογικών στοιχείων των πελατών σας. --- ## Τυπική Ροή Εργασίας στο Rayo SMS 1. **Δημιουργία Λογαριασμού & Επιβεβαίωση Email** Εγγραφείτε στην πλατφόρμα, επιλέξτε την **Εξ'ορισμού Χώρα αποστολής SMS** (π.χ. Ελλάδα `+30`) και επιβεβαιώστε τη διεύθυνση email σας. 2. **Καταχώρηση Στοιχείων Εταιρείας** Συμπληρώστε τα φορολογικά στοιχεία της επιχείρησής σας στο Προχωρημένες Ενέργειες → Στοιχεία Εταιρείας για επαλήθευση του λογαριασμού σας και αυτόματη έκδοση τιμολογίων. 3. **Δημιουργία Αναγνωριστικού Αποστολέα** Καταχωρήστε το επιθυμητό **Αναγνωριστικό Αποστολέα** (π.χ. την επωνυμία της επιχείρησής σας) από την ενότητα **Αναγνωριστικά Αποστολέα**. 4. **Προσθήκη Μονάδων SMS** Αποκτήστε **Μονάδες** μέσω της σελίδας **Παραγγελία Μονάδων** (ή δοκιμάστε αρχικά τη λειτουργία **Προσομοίωση** χωρίς χρέωση). 5. **Αποστολή & Παρακολούθηση Αναφορών Παράδοσης** Στείλτε τα μηνύματά σας από τη σελίδα **Αποστολή** (ή μέσω του REST API) και ελέγξτε την εξέλιξη της παράδοσης στη σελίδα **Απεσταλμένα**. ## Επόμενα Βήματα - [Δημιουργία & Πρόσβαση στον Λογαριασμό](https://docs.rayosms.nl/el/getting-started/account-and-login/): Μάθετε πώς να εγγραφείτε και πώς λειτουργεί η Εξ - [Γρήγορη Εκκίνηση σε 5 Λεπτά](https://docs.rayosms.nl/el/getting-started/quick-start/): Ακολουθήστε τον πρακτικό οδηγό για να στείλετε το πρώτο σας SMS. --- ### Δημιουργία & Πρόσβαση στον Λογαριασμό Source: https://docs.rayosms.nl/el/getting-started/account-and-login/ Description: Πώς να εγγραφείτε στο Rayo SMS, να επιβεβαιώσετε το email σας, να ορίσετε την Εξ'ορισμού Χώρα αποστολής SMS, να διαχειριστείτε το συνθηματικό σας και να ρυθμίσετε την Προτίμηση Γλώσσας στις Προτιμήσεις χρήστη. Σε αυτόν τον οδηγό θα δείτε πώς να δημιουργήσετε έναν νέο λογαριασμό στο **Rayo SMS**, πώς επηρεάζει η **Εξ'ορισμού Χώρα αποστολής SMS** τη μορφοποίηση των αριθμών κινητών τηλεφώνων, καθώς και πώς να συνδέεστε ή να ανακτάτε το **Συνθηματικό** σας. --- ## Εγγραφή Νέου Λογαριασμού (`Εγγραφή`) Για να δημιουργήσετε έναν νέο λογαριασμό, μεταβείτε στη σελίδα [Εγγραφή](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsign_ups%2Fnew) (`/sign_ups/new`). 1. **Συμπληρώστε τα στοιχεία του λογαριασμού σας** Στη φόρμα **Εγγραφή**, συμπληρώστε τα ακόλουθα πεδία: * **Όνομα** / **Επώνυμο** (ή τα στοιχεία του διαχειριστή του λογαριασμού). * **Email**: Η διεύθυνση ηλεκτρονικού ταχυδρομείου σας. Θα χρησιμοποιείται ως το αναγνωριστικό εισόδου σας και για τη λήψη ειδοποιήσεων συστήματος. * **Συνθηματικό** & **Επιβεβαίωση Συνθηματικού**: Επιλέξτε ένα ισχυρό συνθηματικό (έως **72 χαρακτήρες**). * **Εξ'ορισμού Χώρα αποστολής SMS**: Επιλέξτε τη βασική χώρα προς την οποία σκοπεύετε να αποστέλλετε την πλειονότητα των μηνυμάτων σας (π.χ. `Ελλάδα`, `Κύπρος`, `Ηνωμένο Βασίλειο`, `Γερμανία`, `Βουλγαρία`, `Ρουμανία`, `Βέλγιο`, `Ιρλανδία` ή `Ολλανδία`). 2. **Αποδοχή Όρων Χρήσης** Επιλέξτε το πλαίσιο αποδοχής των [Όρων και Προϋποθέσεων Παροχής Υπηρεσιών](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fterms_and_conditions_of_service) και πατήστε **Εγγραφή**. 3. **Επιβεβαίωση Διεύθυνσης Email** Αμέσως μετά την υποβολή της φόρμας, το σύστημα αποστέλλει ένα μήνυμα επιβεβαίωσης στη διεύθυνση email που δηλώσατε (στη γλώσσα που είχατε επιλέξει κατά την εγγραφή). Ανοίξτε το email και κάντε κλικ στον σύνδεσμο επιβεβαίωσης για να ενεργοποιήσετε τον λογαριασμό σας — η γλώσσα εγγραφής αποθηκεύεται αυτόματα ως η **Προτίμηση Γλώσσας** του λογαριασμού σας. > **TIP: Δεν λάβατε το email επιβεβαίωσης;** > Ελέγξτε τον φάκελο ανεπιθύμητης αλληλογραφίας (Spam / Junk). Αν χρειάζεστε βοήθεια με την ενεργοποίηση του λογαριασμού σας, μπορείτε να επικοινωνήσετε μαζί μας μέσω της σελίδας [Επικοινωνία](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us). --- ## Πώς Λειτουργεί η «Εξ'ορισμού Χώρα αποστολής SMS» Κατά την **Εγγραφή**, καλείστε να επιλέξετε την **Εξ'ορισμού Χώρα αποστολής SMS** (`Default Sending-To Country`). Αυτή η ρύθμιση καθορίζει τον προεπιλεγμένο διεθνή κωδικό κλήσης χώρας που εφαρμόζει αυτόματα η πλατφόρμα όταν εισάγετε τοπικούς αριθμούς κινητών χωρίς κωδικό χώρας. ### Αυτόματη Κανονικοποίηση Αριθμών Κινητών Όταν καταχωρείτε αριθμούς στη φόρμα **Αποστολή**, στις **Επαφές**, στις **Ομάδες** ή μέσω του REST API: * **Αν εισάγετε τοπικό αριθμό (χωρίς κωδικό χώρας)**: Το Rayo SMS προσθέτει αυτόματα το διεθνές πρόθεμα της **Εξ'ορισμού Χώρας αποστολής SMS** που έχετε επιλέξει. * *Παράδειγμα (Ελλάδα `+30`)*: Αν πληκτρολογήσετε `6972669767`, το σύστημα τον μετατρέπει και τον αποθηκεύει αυτόματα στη διεθνή μορφή `306972669767`. * **Αν εισάγετε αριθμό με πλήρες διεθνές πρόθεμα**: Μπορείτε ανά πάσα στιγμή να στείλετε SMS σε οποιαδήποτε υποστηριζόμενη χώρα, αρκεί να συμπεριλάβετε τον διεθνή κωδικό της χώρας (π.χ. `35799123456` για Κύπρο ή `447700900123` για Ηνωμένο Βασίλειο). | Τι πληκτρολογείτε | Εξ'ορισμού Χώρα | Πώς αποθηκεύεται / αποστέλλεται | | :--- | :--- | :--- | | `6972669767` | Ελλάδα (`30`) | `306972669767` | | `306972669767` | Ελλάδα (`30`) | `306972669767` | | `+306972669767` | Ελλάδα (`30`) | `306972669767` | > **NOTE: Συμβουλή για Διεθνείς Αποστολές** > Αν αποστέλλετε μηνύματα σε παραλήπτες εκτός της προεπιλεγμένης χώρας του λογαριασμού σας, συμπεριλαμβάνετε πάντοτε τον διεθνή κωδικό χώρας μπροστά από τον αριθμό κινητού. --- ## Είσοδος & Έξοδος από την Εφαρμογή ### Είσοδος (`/sessions/new`) 1. Μεταβείτε στη σελίδα [Είσοδος](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsessions%2Fnew) (`/sessions/new`). 2. Εισάγετε το **Email** και το **Συνθηματικό** σας. 3. Πατήστε **Είσοδος** για να μεταφερθείτε στην **Κεντρική Σελίδα** (**Πίνακας Ελέγχου**). Κατά την είσοδο, η πλατφόρμα εφαρμόζει αυτόματα την αποθηκευμένη **Προτίμηση Γλώσσας** του προφίλ σας (ή αποθηκεύει τη γλώσσα της οθόνης εισόδου αν δεν είχατε ορίσει προτίμηση). ### Έξοδος Για να αποσυνδεθείτε με ασφάλεια από τον λογαριασμό σας, πατήστε **Έξοδος** στην επάνω δεξιά γωνία της εφαρμογής (ή ανοίξτε το μενού χρήστη επάνω αριστερά στην πλευρική στήλη και επιλέξτε **Έξοδος**). --- ## Διαχείριση & Ανάκτηση Συνθηματικού ### Κανόνες Συνθηματικού * Το **Συνθηματικό** σας μπορεί να έχει μήκος έως **72 χαρακτήρες**. * Συνιστάται η χρήση ενός μοναδικού συνδυασμού πεζών, κεφαλαίων γραμμάτων, αριθμών και συμβόλων. ### Αλλαγή Συνθηματικού (ενώ είστε συνδεδεμένοι) Αν γνωρίζετε το τρέχον συνθηματικό σας και θέλετε να το ενημερώσετε: 1. Κάντε κλικ στο μενού του λογαριασμού σας στην επάνω δεξιά γωνία. 2. Επιλέξτε **Αλλαγή Συνθηματικού**. 3. Συμπληρώστε το νέο σας **Συνθηματικό** και την επιβεβαίωσή του και αποθηκεύστε τις αλλαγές. ### Ανάκτηση Ξεχασμένου Συνθηματικού (`/reset_passwords/new`) Αν έχετε ξεχάσει το **Συνθηματικό** σας: 1. Στη σελίδα [Είσοδος](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsessions%2Fnew) (`/sessions/new`), πατήστε στον σύνδεσμο ανάκτησης συνθηματικού (ή μεταβείτε στη διαδρομή `/reset_passwords/new`). 2. Εισάγετε τη διεύθυνση **Email** με την οποία έχετε εγγραφεί και υποβάλετε τη φόρμα. 3. Θα λάβετε ένα email με έναν ασφαλή σύνδεσμο επαναφοράς. Ακολουθήστε τον σύνδεσμο για να ορίσετε νέο **Συνθηματικό**. --- ## Προτιμήσεις Χρήστη & Προτίμηση Γλώσσας (`/preferences`) Το περιβάλλον εργασίας και τα εξερχόμενα ενημερωτικά emails του Rayo SMS υποστηρίζουν **Ελληνικά (`el`)**, **Αγγλικά (`en`)** και **Ολλανδικά (`nl`)** (ανάλογα με τις υποστηριζόμενες γλώσσες της πλατφόρμας/brand). ### Αλλαγή Προτίμησης Γλώσσας (ενώ είστε συνδεδεμένοι) Μπορείτε να αλλάξετε την προτιμώμενη γλώσσα σας ανά πάσα στιγμή απευθείας από το μενού χρήστη, χωρίς να χρειάζεται αποσύνδεση: 1. Κάντε κλικ στο **όνομα χρήστη (email)** σας στο επάνω μέρος της αριστερής πλευρικής στήλης για να ανοίξετε το αναπτυσσόμενο μενού προφίλ. 2. Επιλέξτε **Προτιμήσεις** (`/preferences`). 3. Στην ενότητα **Προτίμηση Γλώσσας**, επιλέξτε την επιθυμητή **Γλώσσα** (**Ελληνικά**, **Αγγλικά** ή **Ολλανδικά**). 4. Πατήστε **Αποθήκευση**. Θα εμφανιστεί το μήνυμα επιβεβαίωσης *«Οι προτιμήσεις ενημερώθηκαν!»* και το περιβάλλον εργασίας θα προσαρμοστεί αμέσως στη γλώσσα που επιλέξατε. ### Πώς Λειτουργεί η Προτίμηση Γλώσσας * **Δημόσιες Σελίδες Αυθεντικοποίησης**: Στις σελίδες Εισόδου, Εγγραφής και Ανάκτησης Συνθηματικού, μπορείτε να αλλάξετε τη γλώσσα εμφάνισης πατώντας στα εικονίδια σημαιών (**Ελληνικά**, **English**, **Dutch**) πάνω από τη φόρμα. * **Αυτόματη Αποθήκευση κατά την Εγγραφή & Είσοδο**: * Όταν δημιουργείτε νέο λογαριασμό, η γλώσσα που έχετε επιλέξει στη σελίδα εγγραφής αποθηκεύεται με το αίτημά σας και ορίζεται αυτόματα ως η **Προτίμηση Γλώσσας** σας μόλις επιβεβαιώσετε το email σας. * Σε κάθε **Είσοδο**, η εφαρμογή φορτώνει αυτόματα την αποθηκευμένη **Προτίμηση Γλώσσας** σας. Αν δεν είχατε ορίσει προτίμηση γλώσσας στο παρελθόν, αποθηκεύεται αυτόματα η γλώσσα που ήταν ενεργή στη σελίδα εισόδου. * **Γλώσσα Ενημερωτικών Emails**: Όλα τα αυτοματοποιημένα emails που σας αποστέλλει η πλατφόρμα — όπως επιβεβαίωση email εγγραφής, μήνυμα καλωσορίσματος, ανάκτηση και αλλαγή συνθηματικού, αποδείξεις αγοράς ή επιστροφής μονάδων, ημερήσιες αναφορές (Daily Reports), μηνιαίες εξαγωγές παραδόσεων, ολοκλήρωση μόνιμης απόκρυψης μηνυμάτων, ενημερώσεις στοιχείων εταιρείας και προσκλήσεις μελών — αποστέλλονται αυτόματα στην προτιμώμενη γλώσσα του παραλήπτη. * **Ανεξάρτητη Ρύθμιση ανά Χρήστη**: Η προτίμηση γλώσσας αποθηκεύεται σε επίπεδο χρήστη, επομένως τόσο ο **Ιδιοκτήτης** του λογαριασμού όσο και τα μέλη της ομάδας με ρόλο **`developer`** μπορούν να επιλέξουν τη δική τους γλώσσα ανεξάρτητα. ## Επόμενα Βήματα - [Στοιχεία Εταιρείας & Τιμολόγησης](https://docs.rayosms.nl/el/getting-started/company-details/): Καταχωρήστε τα φορολογικά στοιχεία της επιχείρησής σας για έγκριση λογαριασμού και τιμολόγια. - [Γρήγορη Εκκίνηση: Το Πρώτο σας SMS](https://docs.rayosms.nl/el/getting-started/quick-start/): Ολοκληρώστε τα πρώτα βήματα και στείλτε το πρώτο σας μήνυμα σε 5 λεπτά. --- ### Στοιχεία Εταιρείας & Τιμολόγησης Source: https://docs.rayosms.nl/el/getting-started/company-details/ Description: Πώς να συμπληρώσετε και να υποβάλετε τα Στοιχεία Εταιρείας σας στο Rayo SMS για επαλήθευση λογαριασμού και έκδοση τιμολογίων. Η συμπλήρωση των **Στοιχείων Εταιρείας** αποτελεί απαραίτητο βήμα για την πλήρη ενεργοποίηση του επαγγελματικού σας λογαριασμού στο **Rayo SMS**. Για να μεταβείτε στη σελίδα διαχείρισης των στοιχείων σας, επιλέξτε από την επάνω γραμμή πλοήγησης: Προχωρημένες Ενέργειες → Στοιχεία Εταιρείας (διαδρομή `/company_details`). --- ## Γιατί Απαιτούνται τα Στοιχεία Εταιρείας; Η καταχώρηση και επιβεβαίωση των εταιρικών σας στοιχείων εξυπηρετεί δύο βασικούς σκοπούς: 1. **Αξιολόγηση Εγκυρότητας & Αποτροπή Κακόβουλης Χρήσης (Anti-Spam / KYC)**: Πριν την έγκριση των **Αναγνωριστικών Αποστολέα** και την αποστολή μηνυμάτων προς τελικούς παραλήπτες, η ομάδα μας επαληθεύει τη νομιμότητα της επιχείρησης ώστε να προστατεύεται η αξιοπιστία του δικτύου και των παραληπτών. 2. **Έκδοση Παραστατικών / Τιμολογίων (`Τιμολόγια`)**: Όλα τα νόμιμα φορολογικά παραστατικά για τις αγορές **Μονάδων** SMS εκδίδονται αυτόματα με βάση τα επιβεβαιωμένα στοιχεία που έχετε δηλώσει σε αυτή τη σελίδα. --- ## Απαιτούμενα Πεδία Φόρμας Στη σελίδα **Στοιχεία Εταιρείας** (`/company_details`), συμπληρώστε με ακρίβεια τα παρακάτω πεδία όπως ακριβώς αναγράφονται στα επίσημα φορολογικά σας έγγραφα (π.χ. στοιχεία Μητρώου ΑΑΔΕ / ΓΕΜΗ): | Πεδίο | Περιγραφή & Οδηγίες Συμπλήρωσης | | :--- | :--- | | **Επίσημο όνομα εταιρείας** | Η πλήρης νομική επωνυμία της επιχείρησης ή του οργανισμού σας (ή το ονοματεπώνυμο σε περίπτωση ατομικής επιχείρησης). | | **Επάγγελμα** | Η κύρια δραστηριότητα / αντικείμενο εργασιών της επιχείρησης (π.χ. *Ηλεκτρονικό Εμπόριο*, *Υπηρεσίες Πληροφορικής*, *Ιατρείο*). | | **Αριθμός ΦΠΑ** | Ο Αριθμός Φορολογικού Μητρώου (ΑΦΜ) / Ενδοκοινοτικός Αριθμός ΦΠΑ της επιχείρησης. | | **Εφορία** | Η αρμόδια Δ.Ο.Υ. (Δημόσια Οικονομική Υπηρεσία) στην οποία υπάγεται η επιχείρηση. | | **Διεύθυνση** | Η οδός και ο αριθμός της φορολογικής έδρας της εταιρείας. | | **Πόλη** | Η πόλη ή ο δήμος της έδρας. | | **Ταχυδρομικός κώδικας** | Ο ταχυδρομικός κώδικας (Τ.Κ.) της έδρας. | | **Χώρα** | Η χώρα φορολογικής έδρας της επιχείρησης (π.χ. Ελλάδα, Κύπρος κ.λπ.). | | **Ιστοσελίδα** | Η επίσημη διεύθυνση ιστοσελίδας (URL) της επιχείρησής σας (π.χ. `https://www.example.gr`). | --- ## Διαδικασία Υποβολής & Καταστάσεις Έγκρισης 1. **Μετάβαση στη σελίδα Στοιχεία Εταιρείας** Από την επάνω γραμμή εργαλείων, επιλέξτε Προχωρημένες Ενέργειες → Στοιχεία Εταιρείας. 2. **Συμπλήρωση και Αποθήκευση** Συμπληρώστε όλα τα πεδία της φόρμας και πατήστε το κουμπί αποθήκευσης/υποβολής. 3. **Έλεγχος εντός 24 Ωρών** Το αίτημά σας εξετάζεται από την ομάδα διαχείρισης, συνήθως **εντός 24 ωρών** (και συχνά πολύ ταχύτερα κατά τις εργάσιμες ώρες). ### Καταστάσεις Εξέτασης Τα **Στοιχεία Εταιρείας** μπορούν να βρίσκονται σε μία από τις ακόλουθες τρεις καταστάσεις: * `Υπό Εξέταση` — Τα στοιχεία σας έχουν υποβληθεί επιτυχώς και αναμένουν έλεγχο από τους διαχειριστές της πλατφόρμας. Όσο βρίσκονται σε αυτή την κατάσταση, μπορείτε ακόμα να διορθώσετε τυχόν τυπογραφικά λάθη. * `Επιβεβαιωμένα` — Τα στοιχεία της εταιρείας σας ελέγχθηκαν και εγκρίθηκαν. Ο λογαριασμός σας είναι έτοιμος για έκδοση τιμολογίων και έγκριση **Αναγνωριστικών Αποστολέα**. * `Απορριφθέντα` — Τα στοιχεία δεν μπόρεσαν να επιβεβαιωθούν (π.χ. ελλιπή στοιχεία ή μη έγκυρος ΑΦΜ). Μπορείτε να ενημερώσετε τα πεδία με τα σωστά στοιχεία και να τα υποβάλετε εκ νέου. --- ## Τροποποίηση Επιβεβαιωμένων Στοιχείων Εταιρείας > **CAUTION: Κλείδωμα Επεξεργασίας μετά την Επιβεβαίωση** > Μόλις τα **Στοιχεία Εταιρείας** σας λάβουν την κατάσταση **Επιβεβαιωμένα**, η φόρμα **κλειδώνει για απευθείας επεξεργασία** προκειμένου να διασφαλιστεί η ακεραιότητα των στοιχείων τιμολόγησης και η ασφάλεια του λογαριασμού. Αν στο μέλλον αλλάξει η επωνυμία, η Δ.Ο.Υ. ή η διεύθυνση της έδρας της επιχείρησής σας: 1. Μεταβείτε στη σελίδα **Επικοινωνία** (`/contact_us`) από το αριστερό μενού (ή μέσω του συνδέσμου [Επικοινωνία](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us)). 2. Στείλτε αίτημα επικαιροποίησης αναφέροντας τα νέα φορολογικά στοιχεία της εταιρείας σας. 3. Η ομάδα υποστήριξης θα ενημερώσει τα στοιχεία σας άμεσα. ## Επόμενα Βήματα - [Διαχείριση Αναγνωριστικών Αποστολέα](https://docs.rayosms.nl/el/sender-ids/managing-sender-ids/): Καταχωρήστε το Αναγνωριστικό Αποστολέα (Sender ID) της επιχείρησής σας. - [Αγορά Μονάδων & Τρόποι Πληρωμής](https://docs.rayosms.nl/el/billing/purchasing-credits/): Δείτε πώς να παραγγείλετε μονάδες SMS με κάρτα, τραπεζική κατάθεση ή πίστωση. --- ### Γρήγορη Εκκίνηση: Το Πρώτο σας SMS σε 5 Λεπτά Source: https://docs.rayosms.nl/el/getting-started/quick-start/ Description: Πρακτικός οδηγός βήμα-προς-βήμα για να ρυθμίσετε τον λογαριασμό σας στο Rayo SMS και να στείλετε το πρώτο σας μήνυμα SMS. Ακολουθήστε αυτόν τον σύντομο οδηγό 6 βημάτων για να ρυθμίσετε τον λογαριασμό σας στο **Rayo SMS** (`sms.rayosms.nl`) και να πραγματοποιήσετε την πρώτη σας αποστολή SMS μέσα σε λίγα λεπτά. --- ## Τα 6 Βήματα για το Πρώτο σας SMS 1. **Δημιουργήστε Λογαριασμό & Επιβεβαιώστε το Email σας** Μεταβείτε στη σελίδα [Εγγραφή](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsign_ups%2Fnew) (`/sign_ups/new`), συμπληρώστε το email σας, ένα **Συνθηματικό** (έως 72 χαρακτήρες) και επιλέξτε την **Εξ'ορισμού Χώρα αποστολής SMS** (π.χ. *Ελλάδα*). Πατήστε στον σύνδεσμο επιβεβαίωσης που θα λάβετε στο email σας και κάντε [Είσοδο](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsessions%2Fnew). 2. **Καταχωρήστε τα Στοιχεία Εταιρείας σας** Από την επάνω γραμμή πλοήγησης, επιλέξτε Προχωρημένες Ενέργειες → Στοιχεία Εταιρείας (`/company_details`). Συμπληρώστε τα φορολογικά στοιχεία της επιχείρησής σας (`Επίσημο όνομα εταιρείας`, `Επάγγελμα`, `Αριθμός ΦΠΑ`, `Εφορία`, `Διεύθυνση`, `Πόλη`, `Ταχυδρομικός κώδικας`, `Χώρα`, `Ιστοσελίδα`) και αποθηκεύστε τη φόρμα. 3. **Δημιουργήστε ένα Αναγνωριστικό Αποστολέα (`Sender ID`)** Στο αριστερό μενού, επιλέξτε Αναγνωριστικά Αποστολέα (`/sender_identifiers`) και πατήστε **Νέο Αναγνωριστικό Αποστολέα**. * Εισάγετε την επωνυμία με την οποία θέλετε να εμφανίζονται τα μηνύματά σας στα κινητά των παραληπτών (π.χ. `RAYOSMS` — έως **11 λατινικούς αλφαριθμητικούς χαρακτήρες** ή έγκυρο τηλεφωνικό αριθμό έως 15 ψηφία). * Μόλις το αναγνωριστικό σας λάβει **Επιβεβαίωση** από τους διαχειριστές, βεβαιωθείτε ότι είναι ενεργό (**Ενεργοποίηση**). 4. **Προσθέστε Μονάδες (ή Χρησιμοποιήστε τη Λειτουργία Προσομοίωσης)** * **Για πραγματική αποστολή**: Επιλέξτε Παραγγελία Μονάδων (`/orders/new`) από το αριστερό μενού, ορίστε τον επιθυμητό αριθμό μονάδων και ολοκληρώστε την αγορά μέσω **Αγοράς με Κάρτα** (άμεση πίστωση μονάδων), **Τραπεζικής Κατάθεσης** ή **Αγοράς με Πίστωση**. * **Για άμεση δοκιμή χωρίς μονάδες**: Μπορείτε να προχωρήσετε απευθείας στο επόμενο βήμα και να ενεργοποιήσετε την επιλογή **Προσομοίωση (Δεν Θα γίνει Αποστολή)** στη φόρμα αποστολής! 5. **Στείλτε το Πρώτο σας SMS από τη Σελίδα «Αποστολή»** Κάντε κλικ στην επιλογή Αποστολή (`/messages/new`) στο αριστερό μενού: * **Αναγνωριστικό Αποστολέα**: Επιλέξτε το επιβεβαιωμένο και ενεργό αναγνωριστικό σας από τη λίστα. * **Προς Κινητά**: Πληκτρολογήστε τον αριθμό του κινητού σας (π.χ. `6972669767` ή `306972669767`). * **Μήνυμα**: Γράψτε το κείμενο του μηνύματός σας (π.χ. `Δοκιμαστικό μήνυμα από το Rayo SMS!`). Παρατηρήστε τον μετρητή χαρακτήρων και μονάδων κάτω από το πλαίσιο κειμένου. * *(Προαιρετικά)* Επιλέξτε **Προσομοίωση (Δεν Θα γίνει Αποστολή)** αν θέλετε να δοκιμάσετε τη ροή χωρίς χρέωση μονάδων. * Πατήστε **Αποστολή Μηνύματος**. 6. **Ελέγξτε την Κατάσταση Παράδοσης στα «Απεσταλμένα»** Μεταβείτε στην ενότητα Απεσταλμένα (`/messages`) από το αριστερό μενού. Εκεί θα δείτε το μήνυμά σας μαζί με την τρέχουσα **Κατάσταση** παράδοσής του: * Αρχικά εμφανίζεται ως **Νέο** ή **Στάλθηκε**, και μέσα σε λίγα δευτερόλεπτα ενημερώνεται αυτόματα σε **Παραδόθηκε** μόλις η συσκευή του παραλήπτη επιβεβαιώσει τη λήψη! > **TIP: Αυτόματη Υποστήριξη 160 Ελληνικών Χαρακτήρων** > Όταν γράφετε ελληνικά (ακόμα και με πεζά και τόνους) στη φόρμα **Αποστολή**, το Rayo SMS τα μετατρέπει αυτόματα στους αντίστοιχους κεφαλαίους χαρακτήρες της κωδικοποίησης GSM 7-bit. Έτσι, κάθε απλό ελληνικό SMS χωράει **160 χαρακτήρες** με χρέωση μόλις **1 μονάδας**! --- ## Τι Μπορείτε να Κάνετε στη Συνέχεια; - [Αποστολή Μεμονωμένων & Μαζικών SMS](https://docs.rayosms.nl/el/messaging/sending-sms/): Αναλυτικός οδηγός για μαζική αποστολή σε Ομάδες, Προηγούμενα Μηνύματα και Αριθμό Αναφοράς. - [Όρια Χαρακτήρων & Κωδικοποίηση](https://docs.rayosms.nl/el/messaging/length-and-encoding/): Δείτε τον πίνακα αντιστοίχισης ελληνικών χαρακτήρων GSM και πώς χρεώνονται τα μεγάλα μηνύματα. - [Ομάδες & Μαζική Εισαγωγή Επαφών](https://docs.rayosms.nl/el/contacts-and-groups/groups/): Οργανώστε τους παραλήπτες σας σε Ομάδες για καμπάνιες άνω των 500 αριθμών. - [Επισκόπηση API & Κλειδιά API](https://docs.rayosms.nl/el/developers/api-overview-and-keys/): Συνδέστε την εφαρμογή ή το e-shop σας με το Rayo SMS REST API. --- ## Ενότητα: Αποστολή & Προγραμματισμός SMS (Sending & Scheduling — Greek) ### Αποστολή Μεμονωμένων & Μαζικών SMS Source: https://docs.rayosms.nl/el/messaging/sending-sms/ Description: Ολοκληρωμένος οδηγός για τη σελίδα Αποστολή του Rayo SMS — επιλογή Αναγνωριστικού Αποστολέα, εισαγωγή αριθμών, αποστολή σε Ομάδες, χρήση Προηγούμενων Μηνυμάτων και λειτουργία Προσομοίωσης. Η σελίδα Αποστολή (διαδρομή `/messages/new`) είναι το κεντρικό εργαλείο σύνταξης και αποστολής μηνυμάτων SMS στη διαδικτυακή εφαρμογή **Rayo SMS** (`sms.rayosms.nl`). Από την ίδια φόρμα μπορείτε να στείλετε από ένα μεμονωμένο SMS έως μια μαζική καμπάνια χιλιάδων παραληπτών σε πολλαπλές **Ομάδες**, είτε άμεσα είτε προγραμματισμένα για μελλοντική ημερομηνία και ώρα. --- ## Πεδία της Φόρμας «Αποστολή» Για να συντάξετε ένα νέο μήνυμα, επιλέξτε **Αποστολή** από το αριστερό μενού της εφαρμογής. Ας δούμε αναλυτικά κάθε πεδίο της φόρμας: ### 1. Αναγνωριστικό Αποστολέα (`Αναγν. Αποστολέα`) Στο αναπτυσσόμενο πεδίο **Αναγνωριστικό Αποστολέα**, επιλέξτε το όνομα ή τον αριθμό που θα εμφανίζεται ως αποστολέας στη συσκευή του παραλήπτη. * Στη λίστα εμφανίζονται μόνο όσα **Αναγνωριστικά Αποστολέα** έχουν λάβει **Επιβεβαίωση** από τους διαχειριστές και βρίσκονται σε κατάσταση **Ενεργό** (**Ενεργοποίηση**). * Αν δεν έχετε ακόμα ενεργό αναγνωριστικό, μεταβείτε στην ενότητα [Αναγνωριστικά Αποστολέα](https://docs.rayosms.nl/el/sender-ids/managing-sender-ids/) για να καταχωρήσετε ένα **Νέο Αναγνωριστικό Αποστολέα**. --- ### 2. Προς Κινητά (`To Mobile Numbers`) Στο πεδίο **Προς Κινητά** μπορείτε να πληκτρολογήσετε ή να επικολλήσετε απευθείας έναν ή περισσότερους αριθμούς κινητών τηλεφώνων. * **Αποδεκτά διαχωριστικά**: Μπορείτε να διαχωρίσετε τους αριθμούς με **κενό διάστημα (space)**, **κόμμα (`,`)**, **ερωτηματικό/άνω τελεία (`;`)** ή **αλλαγή γραμμής (`Enter`)**. * **Μορφή αριθμών**: * Αν εισάγετε τοπικούς αριθμούς χωρίς διεθνές πρόθεμα (π.χ. `6972669767`), η πλατφόρμα προσθέτει αυτόματα τον κωδικό της **Εξ'ορισμού Χώρας αποστολής SMS** του λογαριασμού σας (π.χ. `306972669767` για την Ελλάδα). * Για αποστολή σε άλλη χώρα, συμπεριλάβετε τον διεθνή κωδικό χώρας (π.χ. `35799123456`). * **Ανώτατο όριο πεδίου (500 αριθμοί)**: Μπορείτε να εισάγετε έως **500 αριθμούς κινητών** απευθείας μέσα στο πεδίο **Προς Κινητά** ανά αποστολή. > **CAUTION: Αποστολή σε Περισσότερους από 500 Παραλήπτες** > Για μαζικές αποστολές σε **πάνω από 500 αριθμούς κινητών**, μην επικολλάτε τους αριθμούς απευθείας στο πεδίο **Προς Κινητά**. Δημιουργήστε μία ή περισσότερες **Ομάδες** (μέσω της επιλογής **Προσθήκη Πολλών Μελών**) και επιλέξτε τις στο πεδίο **Ομάδες** της φόρμας. --- ### 3. Ομάδες (`Groups`) Στο πεδίο **Ομάδες** μπορείτε να επιλέξετε μία ή περισσότερες από τις αποθηκευμένες [Ομάδες](https://docs.rayosms.nl/el/contacts-and-groups/groups/) επαφών σας: * **Συνδυασμός Προς Κινητά & Ομάδων**: Μπορείτε να στείλετε μήνυμα μόνο σε αριθμούς του πεδίου **Προς Κινητά**, μόνο σε επιλεγμένες **Ομάδες**, ή και στα δύο ταυτόχρονα. * **Αυτόματη Αποφυγή Διπλοεγγραφών (Παράθυρο 6 Ωρών)**: Το Rayo SMS δεν επιτρέπει την αποστολή **του ίδιου ακριβώς περιεχομένου SMS** στον **ίδιο αριθμό κινητού** μέσα σε **παράθυρο 6 ωρών**. Έτσι, αν ο ίδιος αριθμός υπάρχει σε περισσότερες από μία επιλεγμένες **Ομάδες** (ή και στο πεδίο **Προς Κινητά**), ή αν υποβληθεί εκ νέου το ίδιο μήνυμα εντός 6 ωρών, το σύστημα αποτρέπει την περιττή διπλή αποστολή ώστε ο παραλήπτης να λάβει το μήνυμα **μόνο μία φορά**. * **Αυτόματη Εξαίρεση Άκυρων Επαφών (`Άκυρος;`)**: Κάθε επαφή που έχει σημανθεί ως **Άκυρος** (`Άκυρος; = Ναι`) στον κατάλογο **Επαφές** παραλείπεται αυτόματα κατά την αποστολή σε **Ομάδες**, προστατεύοντας τις μονάδες σας από αποτυχημένες αποστολές. --- ### 4. Μήνυμα & «Προηγούμενα Μηνύματα» Στο πεδίο **Μήνυμα** πληκτρολογείτε το κείμενο του SMS σας: * **Μέγιστο μήκος**: Έως **1.000 χαρακτήρες** (που αντιστοιχούν σε έως 7 συνενωμένα τμήματα SMS). * **Αυτόματη μετατροπή ελληνικών σε GSM 7-bit**: Καθώς πληκτρολογείτε ελληνικούς χαρακτήρες (πεζούς ή κεφαλαίους, με ή χωρίς τόνους), η φόρμα τους μετατρέπει αυτόματα στους αντίστοιχους κεφαλαίους χαρακτήρες του προτύπου GSM 7-bit, εξασφαλίζοντας **160 χαρακτήρες ανά απλό SMS** (δείτε αναλυτικά στον οδηγό [Όρια Χαρακτήρων & Κωδικοποίηση](https://docs.rayosms.nl/el/messaging/length-and-encoding/)). * **Ζωντανός μετρητής**: Κάτω από το πεδίο κειμένου ενημερώνεται σε πραγματικό χρόνο ο αριθμός των χαρακτήρων που έχετε πληκτρολογήσει και ο αριθμός των SMS (**Μονάδων**) που απαιτούνται ανά παραλήπτη. #### Επαναχρησιμοποίηση Κειμένου από «Προηγούμενα Μηνύματα» Αν στέλνετε συχνά παρόμοια μηνύματα ή πρότυπα (templates): 1. Εντοπίστε την ενότητα **Προηγούμενα Μηνύματα** δίπλα/κάτω από τη φόρμα σύνταξης. 2. Περιηγηθείτε στα πρόσφατα κείμενα που έχετε αποστείλει. 3. Πατήστε το κουμπί **Χρησιμοποιήσε Αυτό** δίπλα στο επιθυμητό μήνυμα για να αντιγραφεί αυτόματα το κείμενό του στο πεδίο **Μήνυμα**, όπου μπορείτε να το επεξεργαστείτε πριν την αποστολή. --- ### 5. Αριθμός Αναφοράς (`Reference Number` — Προαιρετικό) Το πεδίο **Αριθμός Αναφοράς** (`Αρ.Αναφοράς`) σάς επιτρέπει να αντιστοιχίσετε ένα δικό σας αναγνωριστικό (έως 255 χαρακτήρες) στην αποστολή σας. * **Παραδείγματα χρήσης**: Όνομα προωθητικής καμπάνιας (π.χ. `BLACK_FRIDAY_2026`), κωδικός παραγγελίας e-shop (π.χ. `ORDER-90412`) ή αναγνωριστικό πελάτη από το ERP/CRM σας. * **Αναζήτηση**: Στη συνέχεια, μπορείτε να φιλτράρετε το ιστορικό σας στη σελίδα [Απεσταλμένα](https://docs.rayosms.nl/el/messaging/delivery-history-and-reports/) με βάση αυτόν τον **Αριθμό Αναφοράς** για να δείτε συγκεντρωτικά όλες τις αναφορές παράδοσης της συγκεκριμένης καμπάνιας. --- ### 6. Να Αποσταλλεί Στις (`Schedule At` — Προαιρετικό) Αν θέλετε το μήνυμα να μην σταλεί αμέσως αλλά σε συγκεκριμένη μελλοντική ημερομηνία και ώρα, συμπληρώστε το πεδίο **Να Αποσταλλεί Στις**. Για πλήρεις οδηγίες διαχείρισης και ακύρωσης προγραμματισμένων αποστολών, δείτε τον οδηγό [Χρονοπρογραμματισμένες Αποστολές](https://docs.rayosms.nl/el/messaging/scheduled-messages/). --- ### 7. Προσομοίωση (`Προσομοίωση (Δεν Θα γίνει Αποστολή)`) Η επιλογή **Προσομοίωση (Δεν Θα γίνει Αποστολή)** (`Simulation`) είναι ένα εξαιρετικά χρήσιμο εργαλείο δοκιμών: * Όταν είναι επιλεγμένη, η πλατφόρμα εκτελεί όλους τους ελέγχους εγκυρότητας (έλεγχος **Αναγνωριστικού Αποστολέα**, κανονικοποίηση αριθμών κινητών, ανάλυση **Ομάδων**, υπολογισμός χαρακτήρων) και καταγράφει τα μηνύματα, **χωρίς όμως να τα προωθήσει στους παρόχους κινητής τηλεφωνίας** και **χωρίς να καταναλώσει Μονάδες** από το υπόλοιπό σας. * Χρησιμοποιήστε την **Προσομοίωση** όταν θέλετε να εκπαιδεύσετε μέλη της ομάδας σας ή να επαληθεύσετε μια νέα καμπάνια πριν την πραγματική εκτέλεση. --- ## Ολοκλήρωση της Αποστολής 1. Ελέγξτε ότι έχετε επιλέξει το σωστό **Αναγνωριστικό Αποστολέα**. 2. Βεβαιωθείτε ότι έχετε συμπληρώσει τουλάχιστον έναν παραλήπτη στο **Προς Κινητά** ή έχετε επιλέξει τουλάχιστον μία ομάδα στο **Ομάδες**. 3. Ελέγξτε το κείμενο του μηνύματος και την ένδειξη μονάδων ανά SMS. 4. Πατήστε το κουμπί **Αποστολή Μηνύματος** (ή **Αποστολή**). Μετά την υποβολή, τα μηνύματα δρομολογούνται άμεσα (ή καταχωρούνται στους **Χρονοπρογραμματισμούς** αν ορίσατε μελλοντική ώρα) και μπορείτε να παρακολουθήσετε την εξέλιξή τους στη σελίδα [Απεσταλμένα](https://docs.rayosms.nl/el/messaging/delivery-history-and-reports/). ## Σχετικοί Οδηγοί - [Όρια Χαρακτήρων, Κωδικοποίηση & Υπολογισμός Κόστους](https://docs.rayosms.nl/el/messaging/length-and-encoding/): Μάθετε πώς υπολογίζονται οι 160 χαρακτήρες, οι διπλοί χαρακτήρες GSM και τα συνενωμένα SMS. - [Ιστορικό Απεσταλμένων & Αναφορές Παράδοσης](https://docs.rayosms.nl/el/messaging/delivery-history-and-reports/): Παρακολουθήστε την κατάσταση παράδοσης κάθε μηνύματος σε πραγματικό χρόνο. --- ### Όρια Χαρακτήρων, Κωδικοποίηση & Υπολογισμός Κόστους Source: https://docs.rayosms.nl/el/messaging/length-and-encoding/ Description: Αναλυτικός οδηγός για το όριο των 160 χαρακτήρων, την αυτόματη μετατροπή ελληνικών σε GSM 7-bit, τους εκτεταμένους χαρακτήρες και τη χρέωση συνενωμένων SMS στο Rayo SMS. Η κατανόηση του τρόπου με τον οποίο μετρώνται οι χαρακτήρες σε ένα μήνυμα SMS σάς βοηθά να βελτιστοποιείτε το μήκος των μηνυμάτων σας και να ελέγχετε με ακρίβεια την κατανάλωση **Μονάδων** σε κάθε καμπάνια. --- ## Το Πρότυπο GSM 7-bit και το Όριο των 160 Χαρακτήρων Στα δίκτυα κινητής τηλεφωνίας, ένα τυπικό μήνυμα SMS που χρησιμοποιεί την κωδικοποίηση **GSM 7-bit** (GSM 03.38) έχει μέγιστη χωρητικότητα **160 χαρακτήρων** και χρεώνεται ως **1 SMS (`1 μονάδα`)** ανά παραλήπτη. Αντίθετα, όταν ένα μήνυμα αποστέλλεται με κωδικοποίηση **Unicode (UCS-2)** — κάτι που συμβαίνει σε πολλές πλατφόρμες όταν χρησιμοποιούνται πεζοί ή τονισμένοι ελληνικοί χαρακτήρες — το όριο ενός απλού SMS μειώνεται δραστικά στους **70 χαρακτήρες**. ### Αυτόματη Μετατροπή Ελληνικών σε GSM 7-bit στο Rayo SMS Για να μην περιορίζεστε στους 70 χαρακτήρες όταν γράφετε στα ελληνικά, ο συντάκτης μηνυμάτων της διαδικτυακής εφαρμογής **Rayo SMS** (στη σελίδα **Αποστολή**) εκτελεί **αυτόματη μετατροπή σε πραγματικό χρόνο** όλων των ελληνικών χαρακτήρων (συμπεριλαμβανομένων των πεζών, των τονισμένων `ά, έ, ή, ί, ό, ύ, ώ`, των διαλυτικών `ϊ, ϋ, ΐ, ΰ` και του τελικού `ς`) στους αντίστοιχους **κεφαλαίους χαρακτήρες του αλφαβήτου GSM 7-bit**. > **TIP: Πλήρεις 160 Χαρακτήρες στα Ελληνικά!** > Χάρη στην αυτόματη μετατροπή GSM 7-bit του Rayo SMS, μπορείτε να πληκτρολογείτε ή να επικολλάτε κανονικά ελληνικό κείμενο με πεζά και τόνους στη φόρμα **Αποστολή** και να απολαμβάνετε ολόκληρο το όριο των **160 χαρακτήρων ανά 1 SMS (1 μονάδα)**! --- ## Πλήρης Πίνακας Αντιστοίχισης Ελληνικών Χαρακτήρων σε GSM 7-bit Ο παρακάτω πίνακας παρουσιάζει πώς μετατρέπεται αυτόματα κάθε ελληνικό γράμμα στον αντίστοιχο κεφαλαίο χαρακτήρα του προτύπου GSM 7-bit (όπου τα γράμματα που έχουν πανομοιότυπη οπτική μορφή με τα λατινικά κεφαλαία κωδικοποιούνται μέσω του βασικού πίνακα GSM 7-bit, ενώ τα αμιγώς ελληνικά κεφαλαία `Δ, Φ, Γ, Λ, Ω, Π, Ψ, Σ, Θ, Ξ` χρησιμοποιούν τις εγγενείς θέσεις τους στο πρότυπο GSM 03.38): | Ελληνικό Γράμμα (Είσοδος) | Πεζά / Τονισμένα / Διαλυτικά που Μετατρέπονται | Χαρακτήρας GSM 7-bit (Έξοδος) | Κόστος σε Χαρακτήρες | | :--- | :--- | :---: | :---: | | **Άλφα** | `α`, `ά`, `Α`, `Ά` | `A` | 1 | | **Βήτα** | `β`, `Β` | `B` | 1 | | **Γάμμα** | `γ`, `Γ` | `Γ` | 1 | | **Δέλτα** | `δ`, `Δ` | `Δ` | 1 | | **Έψιλον** | `ε`, `έ`, `Ε`, `Έ` | `E` | 1 | | **Ζήτα** | `ζ`, `Ζ` | `Z` | 1 | | **Ήτα** | `η`, `ή`, `Η`, `Ή` | `H` | 1 | | **Θήτα** | `θ`, `Θ` | `Θ` | 1 | | **Ιώτα** | `ι`, `ί`, `ϊ`, `ΐ`, `Ι`, `Ί`, `Ϊ` | `I` | 1 | | **Κάππα** | `κ`, `Κ` | `K` | 1 | | **Λάμδα** | `λ`, `Λ` | `Λ` | 1 | | **Μυ** | `μ`, `Μ` | `M` | 1 | | **Νυ** | `ν`, `Ν` | `N` | 1 | | **Ξι** | `ξ`, `Ξ` | `Ξ` | 1 | | **Όμικρον** | `ο`, `ό`, `Ο`, `Ό` | `O` | 1 | | **Πι** | `π`, `Π` | `Π` | 1 | | **Ρω** | `ρ`, `Ρ` | `P` | 1 | | **Σίγμα** | `σ`, `ς`, `Σ` | `Σ` | 1 | | **Ταυ** | `τ`, `Τ` | `T` | 1 | | **Ύψιλον** | `υ`, `ύ`, `ϋ`, `ΰ`, `Υ`, `Ύ`, `Ϋ` | `Y` | 1 | | **Φι** | `φ`, `Φ` | `Φ` | 1 | | **Χι** | `χ`, `Χ` | `X` | 1 | | **Ψι** | `ψ`, `Ψ` | `Ψ` | 1 | | **Ωμέγα** | `ω`, `ώ`, `Ω`, `Ώ` | `Ω` | 1 | --- ## Εκτεταμένοι Χαρακτήρες GSM που Μετρούν ως 2 Χαρακτήρες Ορισμένα ειδικά σύμβολα ανήκουν στον **Πίνακα Επέκτασης GSM 7-bit (GSM 7-bit Extension Table)** ή απαιτούν ειδικό χαρακτήρα διαφυγής (escape character). Ως αποτέλεσμα, καθένας από τους παρακάτω χαρακτήρες **καταλαμβάνει 2 θέσεις χαρακτήρων** αντί για 1 στον υπολογισμό του μήκους του SMS: | Ειδικός Χαρακτήρας | Ονομασία / Περιγραφή | Μέτρηση Χαρακτήρων | | :---: | :--- | :---: | | `^` | Caret (εκθέτης) | **2 χαρακτήρες** | | `{` | Αριστερό άγκιστρο | **2 χαρακτήρες** | | `}` | Δεξί άγκιστρο | **2 χαρακτήρες** | | `\` | Ανάποδη κάθετος (Backslash) | **2 χαρακτήρες** | | `[` | Αριστερή αγκύλη | **2 χαρακτήρες** | | `~` | Περισπωμένη (Tilde) | **2 χαρακτήρες** | | `]` | Δεξιά αγκύλη | **2 χαρακτήρες** | | `\|` | Κάθετη γραμμή (Pipe) | **2 χαρακτήρες** | | `€` | Σύμβολο Ευρώ | **2 χαρακτήρες** | | `Enter` (`\r\n`) | Αλλαγή γραμμής (Line break / Newline) | **2 χαρακτήρες** | > **NOTE: Παράδειγμα με το Σύμβολο Ευρώ (€) και Αλλαγή Γραμμής** > Αν γράψετε ένα μήνυμα 158 γραμμάτων και προσθέσετε το σύμβολο `€` και μία αλλαγή γραμμής (`Enter`), το συνολικό μήκος υπολογίζεται ως `158 + 2 + 2 = 162 χαρακτήρες`, οπότε το μήνυμα θα χωριστεί σε 2 τμήματα SMS (`2 μονάδες`). --- ## Συνενωμένα / Πολλαπλά SMS (Concatenated Multi-Part SMS) Μπορείτε να συντάξετε μηνύματα συνολικού μήκους έως και **1.000 χαρακτήρων**. * **Έως 160 χαρακτήρες**: Το μήνυμα αποστέλλεται ως **1 SMS** (`1 μονάδα` ανά παραλήπτη). * **Πάνω από 160 χαρακτήρες (161 έως 1.000 χαρακτήρες)**: Όταν το μήκος υπερβεί τους 160 χαρακτήρες, το πρωτόκολλο κινητής τηλεφωνίας δεσμεύει 7 χαρακτήρες ανά τμήμα (User Data Header — UDH) ώστε η συσκευή του παραλήπτη να ενώσει αυτόματα τα τμήματα σε ένα ενιαίο μεγάλο μήνυμα. * Συνεπώς, για μηνύματα άνω των 160 χαρακτήρων, **κάθε τμήμα SMS χωράει 153 χαρακτήρες** και ο συνολικός αριθμός SMS υπολογίζεται με τον τύπο: `Αριθμός SMS (Μονάδες) = Math.ceil(Σύνολο Χαρακτήρων / 153)` ### Πίνακας Υπολογισμού Τμημάτων SMS & Μονάδων (1 – 1.000 Χαρακτήρες) | Εύρος Χαρακτήρων | Χαρακτήρες ανά Τμήμα | Αριθμός Τμημάτων SMS | Κόστος ανά Παραλήπτη | | :--- | :--- | :---: | :---: | | **1 – 160 χαρακτήρες** | 160 χαρακτήρες | **1 SMS** | **1 Μονάδα** | | **161 – 306 χαρακτήρες** | 153 χαρακτήρες / τμήμα | **2 SMS** | **2 Μονάδες** | | **307 – 459 χαρακτήρες** | 153 χαρακτήρες / τμήμα | **3 SMS** | **3 Μονάδες** | | **460 – 612 χαρακτήρες** | 153 χαρακτήρες / τμήμα | **4 SMS** | **4 Μονάδες** | | **613 – 765 χαρακτήρες** | 153 χαρακτήρες / τμήμα | **5 SMS** | **5 Μονάδες** | | **766 – 918 χαρακτήρες** | 153 χαρακτήρες / τμήμα | **6 SMS** | **6 Μονάδες** | | **919 – 1.000 χαρακτήρες** | 153 χαρακτήρες / τμήμα *(μέγιστο όριο 1.000 χαρ.)* | **7 SMS** | **7 Μονάδες** | ### Παράδειγμα Υπολογισμού Συνολικού Κόστους Καμπάνιας * Έστω ότι στέλνετε ένα ενημερωτικό μήνυμα **220 χαρακτήρων** σε μια ομάδα **1.000 επαφών**. * Επειδή το μήκος (220 χαρακτήρες) βρίσκεται στο εύρος **161 – 306**, το μήνυμα αποτελείται από **2 τμήματα SMS** (`2 μονάδες` ανά παραλήπτη). * Το συνολικό κόστος της αποστολής θα είναι: `1.000 παραλήπτες × 2 μονάδες = 2.000 Μονάδες`. ## Σχετικοί Οδηγοί - [Αποστολή Μεμονωμένων & Μαζικών SMS](https://docs.rayosms.nl/el/messaging/sending-sms/): Επιστρέψτε στον οδηγό της φόρμας Αποστολή. - [Αγορά Μονάδων & Τρόποι Πληρωμής](https://docs.rayosms.nl/el/billing/purchasing-credits/): Δείτε πώς λειτουργούν τα πακέτα μονάδων και οι εκπτώσεις όγκου. --- ### Χρονοπρογραμματισμένες Αποστολές Source: https://docs.rayosms.nl/el/messaging/scheduled-messages/ Description: Πώς να προγραμματίσετε μελλοντικές αποστολές SMS στο Rayo SMS και πώς να προβάλετε, να φιλτράρετε ή να ακυρώσετε εκκρεμείς χρονοπρογραμματισμούς. Οι **Χρονοπρογραμματισμένες Αποστολές** σάς επιτρέπουν να προετοιμάσετε τα μηνύματα ή τις μαζικές καμπάνιες σας εκ των προτέρων και να ορίσετε την ακριβή μελλοντική ημερομηνία και ώρα κατά την οποία το **Rayo SMS** θα εκτελέσει αυτόματα την αποστολή. --- ## Πώς να Προγραμματίσετε μια Μελλοντική Αποστολή SMS Ο προγραμματισμός μιας αποστολής γίνεται απευθείας μέσα από τη φόρμα Αποστολή (`/messages/new`): 1. **Συμπληρώστε τα στοιχεία του μηνύματος** Μεταβείτε στη σελίδα **Αποστολή**, επιλέξτε **Αναγνωριστικό Αποστολέα**, εισάγετε τους παραλήπτες στο πεδίο **Προς Κινητά** ή/και επιλέξτε τις επιθυμητές **Ομάδες**, και γράψτε το **Μήνυμα** σας. 2. **Ορίστε Ημερομηνία και Ώρα στο πεδίο «Να Αποσταλλεί Στις»** Κάντε κλικ στο πεδίο **Να Αποσταλλεί Στις** (`Schedule At`) και επιλέξτε από το ημερολόγιο την επιθυμητή μελλοντική ημερομηνία και ώρα εκτέλεσης της αποστολής. 3. **Υποβάλετε τον Χρονοπρογραμματισμό** Πατήστε **Αποστολή Μηνύματος**. Αντί να αποσταλεί αμέσως, το αίτημά σας αποθηκεύεται με ασφάλεια στην ενότητα **Χρονοπρογραμματισμοί** και θα εκτελεστεί αυτόματα την προκαθορισμένη ώρα. > **NOTE: Έλεγχος Υπολοίπου Μονάδων κατά την Εκτέλεση** > Βεβαιωθείτε ότι ο λογαριασμός σας διαθέτει επαρκές **Υπόλοιπο Μονάδων** την ώρα που είναι προγραμματισμένη να εκτελεστεί η αποστολή, ώστε όλα τα μηνύματα της καμπάνιας να αποσταλούν απρόσκοπτα. --- ## Διαχείριση Χρονοπρογραμματισμών (`/sms_request_schedules`) Για να δείτε όλες τις προγραμματισμένες αποστολές σας, επιλέξτε Χρονοπρογραμματισμοί (διαδρομή `/sms_request_schedules`) από το αριστερό μενού της εφαρμογής. ### Φιλτράρισμα & Αναζήτηση Χρονοπρογραμματισμών Στην κορυφή της σελίδας **Χρονοπρογραμματισμοί** μπορείτε να φιλτράρετε τη λίστα χρησιμοποιώντας τα παρακάτω κριτήρια: * **Μη Εκπληρωμένα** (`Unfulfilled`): Επιλέξτε αυτό το πλαίσιο ελέγχου (checkbox) για να εμφανίσετε μόνο τις προγραμματισμένες αποστολές που εκκρεμούν (δεν έχουν εκτελεστεί ακόμη). * **Κινητό** (`Mobile`): Αναζητήστε χρονοπρογραμματισμούς που περιλαμβάνουν έναν συγκεκριμένο αριθμό κινητού τηλεφώνου. * **Ημερ/νία Χρονοπρ/τισμού** (`Scheduled At`): Φιλτράρετε τις εγγραφές με βάση το χρονικό διάστημα για το οποίο έχουν προγραμματιστεί να αποσταλούν. * **Ομάδες** (`Groups`): Φιλτράρετε τους χρονοπρογραμματισμούς που απευθύνονται σε μία ή περισσότερες συγκεκριμένες **Ομάδες** επαφών. --- ## Επισκόπηση Λεπτομερειών Χρονοπρογραμματισμού Στον πίνακα των χρονοπρογραμματισμών μπορείτε να δείτε βασικές πληροφορίες για κάθε εγγραφή, όπως την προγραμματισμένη ημερομηνία/ώρα (**Να Αποσταλλεί Στις**), το **Αναγνωριστικό Αποστολέα**, το κείμενο του μηνύματος και την ένδειξη **Εκτελέσθηκε;** (`Fulfilled?` — `Ναι` ή `Όχι`). Για να δείτε την πλήρη ανάλυση μιας προγραμματισμένης αποστολής: 1. Πατήστε τον σύνδεσμο **Επισκόπηση** στη γραμμή του χρονοπρογραμματισμού που σας ενδιαφέρει. 2. Θα μεταφερθείτε στη σελίδα **Επισκόπηση Λεπτομερειών Χρονοπρογραμματισμού**, όπου εμφανίζονται αναλυτικά: * Το **Αναγνωριστικό** (ID) του χρονοπρογραμματισμού. * Η ακριβής ημερομηνία και ώρα **Να Αποσταλλεί Στις**. * Η κατάσταση **Εκτελέσθηκε;** (`Ναι` / `Όχι`). * Οι μεμονωμένοι αριθμοί κινητών και οι **Ομάδες** παραληπτών. * Το πλήρες σώμα του μηνύματος, ο **Αριθμός Αναφοράς** και αν πρόκειται για **Προσομοίωση**. --- ## Ακύρωση / Διαγραφή Εκκρεμούς Χρονοπρογραμματισμού Αν αλλάξουν τα πλάνα της καμπάνιας σας ή εντοπίσετε κάποιο λάθος στο κείμενο, μπορείτε να ακυρώσετε οποιονδήποτε χρονοπρογραμματισμό **πριν την προγραμματισμένη ώρα εκτέλεσής του** (εφόσον βρίσκεται ακόμη σε κατάσταση **Μη Εκπληρωμένα** / `Εκτελέσθηκε; = Όχι`). ### Ακύρωση μέσω του Περιβάλλοντος Εργασίας (Web UI) 1. Μεταβείτε στη σελίδα Χρονοπρογραμματισμοί (`/sms_request_schedules`). 2. Εντοπίστε την εκκρεμή εγγραφή (ή ανοίξτε την **Επισκόπηση Λεπτομερειών Χρονοπρογραμματισμού**). 3. Πατήστε το κουμπί **Διαγραφή** και επιβεβαιώστε την ενέργεια. 4. Ο χρονοπρογραμματισμός διαγράφεται οριστικά και δεν θα αποσταλεί κανένα μήνυμα. ### Ακύρωση μέσω του HTTP REST API Αν δημιουργείτε χρονοπρογραμματισμένες αποστολές προγραμματιστικά μέσω του API, μπορείτε επίσης να τις ακυρώσετε πριν την εκτέλεσή τους καλώντας το endpoint διαγραφής: ```http DELETE /v1/sms_request_schedules/:id ``` Δείτε περισσότερες λεπτομέρειες στον οδηγό [Επισκόπηση API & Κλειδιά API](https://docs.rayosms.nl/el/developers/api-overview-and-keys/) ή στην [Τεχνική Αναφορά REST API](https://api-docs.rayosms.nl). ## Σχετικοί Οδηγοί - [Αποστολή Μεμονωμένων & Μαζικών SMS](https://docs.rayosms.nl/el/messaging/sending-sms/): Δείτε όλες τις επιλογές της φόρμας Αποστολή. - [Ιστορικό Απεσταλμένων & Αναφορές Παράδοσης](https://docs.rayosms.nl/el/messaging/delivery-history-and-reports/): Ελέγξτε τις αναφορές παράδοσης μόλις εκτελεστεί ο χρονοπρογραμματισμός σας. --- ### Ιστορικό Απεσταλμένων & Αναφορές Παράδοσης Source: https://docs.rayosms.nl/el/messaging/delivery-history-and-reports/ Description: Πώς να παρακολουθείτε το ιστορικό των εξερχόμενων μηνυμάτων σας στη σελίδα Απεσταλμένα του Rayo SMS, τι σημαίνει κάθε Κατάσταση παράδοσης και πώς να φιλτράρετε τις αναφορές σας. Κάθε μήνυμα SMS που αποστέλλετε μέσω της διαδικτυακής εφαρμογής **Rayo SMS** ή μέσω του HTTP REST API καταγράφεται αναλυτικά στη σελίδα Απεσταλμένα (διαδρομή `/messages`). Μέσα από τη σελίδα **Απεσταλμένα** (`Απεσταλμένα Μηνύματα`) μπορείτε να παρακολουθείτε σε πραγματικό χρόνο τις αναφορές παράδοσης (Delivery Reports — DLR) από τους παρόχους κινητής τηλεφωνίας, να ελέγχετε την κατανάλωση μονάδων και να αναζητάτε μεμονωμένα μηνύματα ή ολόκληρες καμπάνιες. --- ## Καταστάσεις Παράδοσης Μηνυμάτων (`Κατάσταση`) Κάθε εξερχόμενο SMS περνά από συγκεκριμένα στάδια κύκλου ζωής. Στη στήλη **Κατάσταση** εμφανίζεται μία από τις παρακάτω 5 καταστάσεις: | Κατάσταση (Ελληνικά) | Τιμή API / Αγγλικά | Επεξήγηση Κατάστασης | | :--- | :--- | :--- | | `Νέο` | `new` (`New`) | Το μήνυμα έχει καταχωρηθεί στην ουρά αποστολής του Rayo SMS και ετοιμάζεται για άμεση δρομολόγηση. | | `Στάλθηκε` | `sent` (`Sent Out`) | Το μήνυμα έχει παραδοθεί επιτυχώς στο δίκτυο κινητής τηλεφωνίας και αναμένεται η τελική αναφορά παράδοσης από τη συσκευή του παραλήπτη. | | `Παραδόθηκε` | `delivered` (`Delivered`) | **Επιβεβαιωμένη παράδοση:** Το δίκτυο κινητής τηλεφωνίας επιβεβαίωσε ότι το SMS παραδόθηκε στη συσκευή (κινητό τηλέφωνο) του παραλήπτη. | | `Δεν Παραδόθηκε` | `not_delivered` (`Not Delivered`) | Το μήνυμα στάλθηκε στο δίκτυο, αλλά δεν κατέστη δυνατή η παράδοσή του στη συσκευή (π.χ. το κινητό ήταν απενεργοποιημένο ή εκτός δικτύου καθ' όλη τη διάρκεια ισχύος του SMS, ή ο αριθμός δεν υπάρχει/έχει καταργηθεί). | | `Σφάλμα Επεξεργασίας` | `failure` (`Processing Error`) | Η αποστολή απέτυχε κατά την αρχική επεξεργασία πριν ολοκληρωθεί η παράδοση στο δίκτυο (π.χ. ανεπαρκές **Υπόλοιπο Μονάδων** ή μη έγκυρη μορφή αριθμού προορισμού). Ο ακριβής λόγος αναγράφεται στη στήλη **Σφάλμα**. | > **TIP: Γιατί ένα μήνυμα παραμένει στην κατάσταση «Στάλθηκε»;** > Όταν το κινητό τηλέφωνο του παραλήπτη είναι κλειστό ή χωρίς σήμα (π.χ. σε πτήση ή περιοχή χωρίς κάλυψη), ο πάροχος κινητής τηλεφωνίας διατηρεί το SMS σε αναμονή και επιχειρεί περιοδικά να το παραδώσει. Μόλις ο παραλήπτης ανοίξει ξανά τη συσκευή του, η κατάσταση ενημερώνεται αυτόματα σε **Παραδόθηκε** (ή σε **Δεν Παραδόθηκε** αν παρέλθει το μέγιστο χρονικό όριο ισχύος του δικτύου). --- ## Φιλτράρισμα & Αναζήτηση στα «Απεσταλμένα» Για να εντοπίσετε γρήγορα συγκεκριμένα μηνύματα ή να ελέγξετε την απόδοση μιας καμπάνιας, χρησιμοποιήστε τα φίλτρα στο επάνω μέρος της σελίδας **Απεσταλμένα** (`/messages`): ### 1. Φίλτρο Κατάστασης (Πλαίσια Ελέγχου) Μπορείτε να επιλέξετε μία ή περισσότερες καταστάσεις ταυτόχρονα: * `Νέο` * `Στάλθηκε` * `Παραδόθηκε` * `Δεν Παραδόθηκε` * `Σφάλμα Επεξεργασίας` ### 2. Κινητό (`Mobile Number`) Πληκτρολογήστε τον αριθμό κινητού τηλεφώνου ενός παραλήπτη (π.χ. `6972669767` ή `306972669767`) για να δείτε ολόκληρο το ιστορικό μηνυμάτων που έχουν σταλεί στον συγκεκριμένο αριθμό. ### 3. Ημερ.Αποστολής (`Sent At` — Εύρος Ημερομηνιών) Κάντε κλικ στο πεδίο **Ημερ.Αποστολής** για να περιορίσετε τα αποτελέσματα σε συγκεκριμένη χρονική περίοδο. Μπορείτε να επιλέξετε μία από τις έτοιμες επιλογές ή να ορίσετε προσαρμοσμένο διάστημα: * **Σήμερα** (`Today`) * **Χθες** (`Yesterday`) * **Τελευταίες 7 Ημέρες** (`Last 7 Days`) * **Τελευταίες 30 Ημέρες** (`Last 30 Days`) * **Αυτόν Το Μήνα** (`This Month`) * **Τον Προηγούμενο Μήνα** (`Last Month`) * **Άλλο Διάστημα** (`Custom Range` — επιλογή ημερομηνίας έναρξης και λήξης από το ημερολόγιο) ### 4. Αριθ.Αναφοράς (`Reference Number`) Πληκτρολογήστε τον **Αριθμό Αναφοράς** που είχατε ορίσει κατά την αποστολή (π.χ. `SUMMER_PROMO` ή `ORDER-1052`) για να εμφανίσετε αποκλειστικά τα μηνύματα που ανήκουν στη συγκεκριμένη καμπάνια ή συναλλαγή. --- ## Επεξήγηση Στηλών του Πίνακα «Απεσταλμένα» Ο πίνακας αποτελεσμάτων στη σελίδα **Απεσταλμένα** περιλαμβάνει τις εξής στήλες: | Στήλη | Περιγραφή | | :--- | :--- | | **Αναγνωριστικό** | Το μοναδικό αναγνωριστικό (UUID / ID) του εξερχόμενου μηνύματος SMS στο σύστημα. Χρήσιμο για αντιστοίχιση με κλήσεις API, Callbacks (Webhooks) ή αιτήματα υποστήριξης. | | **Ημερ/νία Αποστολής** | Η ακριβής ημερομηνία και ώρα δημιουργίας/αποστολής του μηνύματος. | | **Αναγν. Αποστολέα** | Το **Αναγνωριστικό Αποστολέα** (`Sender ID`) με το οποίο εστάλη το μήνυμα. | | **Κινητό** | Ο αριθμός κινητού τηλεφώνου του παραλήπτη σε πλήρη διεθνή μορφή (π.χ. `306972669767`). | | **Μήνυμα** | Το κείμενο του SMS που εστάλη. *(Αν έχετε ενεργοποιήσει τη [Μόνιμη Απόκρυψη Σώματος Μηνυμάτων](https://docs.rayosms.nl/el/account-and-security/message-masking/), το κείμενο εμφανίζεται ως `ΧΧΧΧ`).* | | **Κατάσταση** | Η τρέχουσα κατάσταση παράδοσης (`Νέο`, `Στάλθηκε`, `Παραδόθηκε`, `Δεν Παραδόθηκε`, `Σφάλμα Επεξεργασίας`), καθώς και ένδειξη αν το μήνυμα εκτελέστηκε ως **Προσομοίωση**. | | **Σφάλμα** | Επεξηγηματικό μήνυμα σφάλματος σε περίπτωση που η κατάσταση είναι **Σφάλμα Επεξεργασίας** (π.χ. ανεπαρκές υπόλοιπο μονάδων). | | **Αριθμός Αναφοράς** | Ο προαιρετικός κωδικός αναφοράς πελάτη/καμπάνιας που συνοδεύει το μήνυμα. | | **Μονάδες** | Ο αριθμός των **Μονάδων** SMS που χρεώθηκαν για το συγκεκριμένο μήνυμα (π.χ. `1` για απλό SMS έως 160 χαρακτήρες, `2` για μήνυμα 161–306 χαρακτήρων, ή `0` σε λειτουργία **Προσομοίωσης**). | --- ## Αυτόματη Λήψη Αναφορών Παράδοσης μέσω Callbacks (Webhooks) Αν χρησιμοποιείτε το Rayo SMS μέσα από δική σας εφαρμογή, ERP ή CRM, δεν χρειάζεται να ελέγχετε χειροκίνητα τη σελίδα **Απεσταλμένα**. Μπορείτε να ρυθμίσετε **Callbacks** στο Προχωρημένες Ενέργειες → Ρυθμίσεις → Callbacks ώστε ο διακομιστής σας να λαμβάνει αυτόματα HTTP POST ειδοποιήσεις κάθε φορά που ένα μήνυμα αλλάζει κατάσταση. ## Σχετικοί Οδηγοί - [Callbacks Αναφορών Παράδοσης (Webhooks)](https://docs.rayosms.nl/el/developers/webhooks-and-callbacks/): Μάθετε πώς να λαμβάνετε αυτόματα αναφορές παράδοσης στην εφαρμογή σας. - [Μόνιμη Απόκρυψη Μηνυμάτων (GDPR)](https://docs.rayosms.nl/el/account-and-security/message-masking/): Δείτε πώς λειτουργεί το μασκάρισμα του σώματος των μηνυμάτων στα Απεσταλμένα. --- ## Ενότητα: Αναγνωριστικά Αποστολέα (Sender IDs — Greek) ### Διαχείριση Αναγνωριστικών Αποστολέα (Sender IDs) Source: https://docs.rayosms.nl/el/sender-ids/managing-sender-ids/ Description: Οδηγός δημιουργίας, επιβεβαίωσης, ενεργοποίησης και διαχείρισης Αλφαριθμητικών Αναγνωριστικών και Αριθμών Κινητής Τηλεφωνίας στο Rayo SMS. Το **Αναγνωριστικό Αποστολέα (Sender ID)** είναι το όνομα ή ο αριθμός τηλεφώνου που εμφανίζεται στην οθόνη του κινητού του παραλήπτη ως αποστολέας του μηνύματος SMS. Η διαχείριση όλων των αναγνωριστικών σας πραγματοποιείται από το κεντρικό μενού πλοήγησης στην ενότητα **Αναγν. Αποστολέα** (`Αναγνωριστικά Αποστολέα`) στο [Περιβάλλον Εφαρμογής Rayo SMS](https://sms.rayosms.nl/sender_ids). --- ## Τύποι Αναγνωριστικών Αποστολέα Το Rayo SMS υποστηρίζει δύο τύπους αναγνωριστικών αποστολέα, ανάλογα με τις ανάγκες επικοινωνίας της επιχείρησής σας: #### 1. Αλφαριθμητικά Αναγνωριστικά Επωνυμίες επιχειρήσεων ή brands (π.χ. `ROMEO`, `MY-SHOP`, `COMPANY.GR`). `Άμεση Επιβεβαίωση` #### 2. Αριθμοί Κινητής Τηλεφωνίας Πραγματικοί αριθμοί κινητού τηλεφώνου (π.χ. `306972669700` ή `+306972669700`). `Απαιτεί Επιβεβαίωση με Κωδικό SMS` --- ### 1. Αλφαριθμητικά Αναγνωριστικά Τα αλφαριθμητικά αναγνωριστικά σάς επιτρέπουν να αποστέλλετε μηνύματα με την επωνυμία της επιχείρησής σας, ενισχύοντας την αναγνωρισιμότητα και την αξιοπιστία σας. - **Μέγιστο μήκος**: Επιτρέπονται **μέχρι 11 χαρακτήρες το πολύ** (συμπεριλαμβανομένων των κενών). - **Επιτρεπόμενοι χαρακτήρες**: - Λατινικοί χαρακτήρες κεφαλαίοι και πεζοί (`A-Z`, `a-z`) - Αριθμοί (`0-9`) - Κενό διάστημα (` `) - Παύλα (`-`) - Κάτω παύλα (`_`) - Τελεία (`.`) - **Παραδείγματα**: `ROMEO`, `MY-SHOP`, `COMPANY.GR`, `RAYO_SMS`. - **Κατάσταση επιβεβαίωσης**: Τα αλφαριθμητικά αναγνωριστικά σημαίνονται αυτόματα ως **Επιβεβαιωμένο** (`Επιβεβαιωμένο`) αμέσως μετά τη δημιουργία τους και είναι έτοιμα προς χρήση. > **CAUTION: Σημαντικό: Προεγγραφή Αναγνωριστικού ανά Χώρα Προορισμού** > Παρόλο που τα αλφαριθμητικά αναγνωριστικά αποστολέα μπορούν να χρησιμοποιηθούν αμέσως στην πλειονότητα των περιπτώσεων, ανάλογα με τη χώρα προορισμού στην οποία θέλετε να χρησιμοποιήσετε ένα τέτοιο αναγνωριστικό αποστολέα, ενδέχεται να απαιτείται προεγγραφή (pre-registration) στα τοπικά δίκτυα κινητής τηλεφωνίας. Το εξερχόμενο SMS σας μπορεί να φύγει κανονικά από την πλατφόρμα μας αλλά στη συνέχεια να μπλοκαριστεί από το δίκτυο προορισμού, εάν το αναγνωριστικό αποστολέα δεν έχει δηλωθεί. Παρακαλούμε [επικοινωνήστε μαζί μας](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us) αναφέροντας το αναγνωριστικό αποστολέα και τη χώρα στην οποία θέλετε να το χρησιμοποιήσετε, και θα σας ενημερώσουμε σχετικά με το αν απαιτείται εγγραφή ή όχι. > **NOTE: Απάντηση σε Αλφαριθμητικά Αναγνωριστικά** > Τα μηνύματα που αποστέλλονται με αλφαριθμητικό αναγνωριστικό αποστολέα είναι μονής κατεύθυνσης. Οι παραλήπτες δεν μπορούν να πατήσουν «Απάντηση» απευθείας στο νήμα του SMS, εκτός εάν χρησιμοποιήσετε αριθμό κινητής τηλεφωνίας ως αποστολέα ή συμπεριλάβετε στοιχεία επικοινωνίας στο σώμα του μηνύματος. --- ### 2. Αριθμοί Κινητής Τηλεφωνίας Μπορείτε να καταχωρήσετε έναν αριθμό κινητού τηλεφώνου που σας ανήκει (π.χ. `306972669700` ή `+306972669700`), ώστε οι παραλήπτες να αναγνωρίζουν τον αριθμό σας και να μπορούν να σας καλέσουν ή να απαντήσουν απευθείας. - **Μήκος αριθμού**: Από **10 έως 15 ψηφία** (συνιστάται η συμπερίληψη του κωδικού χώρας, π.χ. `30` ή `+30` για την Ελλάδα). - **Απαίτηση επιβεβαίωσης**: Για λόγους ασφαλείας και αποτροπής πλαστογράφησης (spoofing), κάθε αριθμός κινητού απαιτεί **Επιβεβαίωση Κινητού Αναγνωριστικού Αποστολέα** μέσω κωδικού μιας χρήσης (OTP). #### Διαδικασία Επιβεβαίωσης Κινητού Αναγνωριστικού Αποστολέα 1. **Καταχώρηση Αριθμού** Μεταβείτε στη σελίδα **Αναγν. Αποστολέα**, πατήστε δημιουργία νέου αναγνωριστικού, εισαγάγετε τον αριθμό κινητού τηλεφώνου (π.χ. `+306972669700`) και αποθηκεύστε. 2. **Λήψη 5-ψήφιου Κωδικού μέσω SMS** Το Rayo SMS αποστέλλει αυτόματα έναν **5-ψήφιο κωδικό** επιβεβαίωσης (`5-ψήφιος κωδικός`) με SMS στον αριθμό κινητού που δηλώσατε. 3. **Εισαγωγή Κωδικού εντός 15 Λεπτών** Εισαγάγετε τον 5-ψήφιο κωδικό στο πεδίο επιβεβαίωσης και πατήστε **Επιβεβαίωση** μέσα σε **15 λεπτά**. Εάν παρέλθουν τα 15 λεπτά χωρίς επιβεβαίωση, η αίτηση λήγει αυτόματα και θα χρειαστεί να την επαναλάβετε. > **CAUTION: Όριο Αναμονής Επιβεβαίωσης** > Μπορείτε να έχετε **μόνο ένα (1)** κινητό αναγνωριστικό αποστολέα **σε κατάσταση αναμονής επιβεβαίωσης** κάθε φορά. Για να προσθέσετε διαφορετικό αριθμό κινητού, ολοκληρώστε πρώτα την επιβεβαίωση του τρέχοντος αριθμού, διαγράψτε τον ή περιμένετε να λήξει το 15λεπτο χρονικό παράθυρο. --- ## Ενεργοποίηση & Απενεργοποίηση Κάθε αναγνωριστικό αποστολέα διαθέτει κατάσταση λειτουργίας (**Ενεργό** / **Ανενεργό**): - **Μόνο τα ενεργά και επιβεβαιωμένα** αναγνωριστικά αποστολέα εμφανίζονται ως διαθέσιμες επιλογές κατά την αποστολή SMS (τόσο από το περιβάλλον της εφαρμογής όσο και μέσω του REST API). - Μπορείτε ανά πάσα στιγμή να επιλέξετε **Απενεργοποίηση** σε ένα αναγνωριστικό που δεν χρησιμοποιείτε προσωρινά, ώστε να διατηρείτε καθαρή τη λίστα επιλογής αποστολέα, και **Ενεργοποίηση** όταν θελήσετε να το χρησιμοποιήσετε ξανά. --- ## Διαγραφή Αναγνωριστικού Αποστολέα Η δυνατότητα οριστικής διαγραφής εξαρτάται από το ιστορικό χρήσης του αναγνωριστικού: - **Αχρησιμοποίητα Αναγνωριστικά**: Εάν ένα αναγνωριστικό αποστολέα **δεν έχει χρησιμοποιηθεί ποτέ** για αποστολή μηνύματος (ή βρίσκεται ακόμη σε αναμονή επιβεβαίωσης), μπορείτε να το διαγράψετε οριστικά πατώντας **Διαγραφή**. - **Χρησιμοποιημένα Αναγνωριστικά**: Εάν το αναγνωριστικό έχει χρησιμοποιηθεί έστω και μία φορά στο παρελθόν (ακόμη και σε δοκιμαστική αποστολή), το σύστημα προστατεύει την ακεραιότητα του ιστορικού αναφορών παράδοσης και εμφανίζει το μήνυμα: > `Δεν μπορεί να διαγραφεί. Έχει χρησιμοποιηθεί στο παρελθόν για αποστολή μηνύματος.` Σε αυτήν την περίπτωση, χρησιμοποιήστε την επιλογή **Απενεργοποίηση** αντί για διαγραφή. --- ## Σχετικοί Οδηγοί - [Αποστολή Μεμονωμένων & Μαζικών SMS](https://docs.rayosms.nl/el/messaging/sending-sms): Επιλέξτε το αναγνωριστικό αποστολέα σας και στείλτε την πρώτη σας καμπάνια. - [Συχνές Ερωτήσεις (FAQ) & Υποστήριξη](https://docs.rayosms.nl/el/support/faq-and-contact): Απαντήσεις σε συνήθη ερωτήματα σχετικά με τα Sender IDs και την παράδοση μηνυμάτων. --- ## Ενότητα: Επαφές & Ομάδες (Contacts & Groups — Greek) ### Διαχείριση Επαφών Source: https://docs.rayosms.nl/el/contacts-and-groups/contacts/ Description: Οργάνωση, αναζήτηση, επεξεργασία και εξαίρεση επαφών (Σημαία «Άκυρος;») στο βιβλίο επαφών του Rayo SMS. Η ενότητα **Επαφές** (`/contacts`) αποτελεί το κεντρικό ευρετήριο όλων των παραληπτών σας στο [Rayo SMS](https://sms.rayosms.nl/contacts). Από εδώ μπορείτε να καταχωρείτε μεμονωμένους αριθμούς κινητών, να αποθηκεύετε στοιχεία πελατών, να αναζητάτε γρήγορα εγγραφές και να διαχειρίζεστε εξαιρέσεις αποστολής (opt-outs). --- ## Πεδία Επαφής Κάθε εγγραφή στο βιβλίο επαφών περιλαμβάνει τα εξής πεδία: | Πεδίο | Υποχρεωτικό | Περιγραφή | | :--- | :---: | :--- | | **Όνομα** | Όχι (Προαιρετικό) | Το μικρό όνομα του παραλήπτη (π.χ. `Παναγιώτης`). | | **Επώνυμο** | Όχι (Προαιρετικό) | Το επώνυμο του παραλήπτη (π.χ. `Γεωργίου`). | | **Κινητό** | **Ναι (Υποχρεωτικό)** | Ο αριθμός κινητού τηλεφώνου του παραλήπτη (με ή χωρίς πρόθεμα χώρας). | | **Αρ.Αναφοράς** | Όχι (Προαιρετικό) | Προσαρμοσμένος κωδικός αναφοράς (π.χ. κωδικός πελάτη ERP/CRM όπως `cust-2343`). | | **Άκυρος;** (`Invalid?`) | Όχι (Λογική τιμή) | Σημαία εξαίρεσης (Suppression / Opt-out) που αποτρέπει την αποστολή SMS στην επαφή. | --- ## Αναζήτηση Επαφών Στην κορυφή της σελίδας **Επαφές**, μπορείτε να εντοπίσετε άμεσα οποιαδήποτε εγγραφή χρησιμοποιώντας το πεδίο αναζήτησης (**`Δώστε Λέξη ή Αριθμό για Αναζήτηση`**). Η αναζήτηση λειτουργεί ενιαία σε όλα τα βασικά πεδία της επαφής: - Αριθμό κινητού τηλεφώνου (`Κινητό`) - Μικρό όνομα (`Όνομα`) - Επώνυμο (`Επώνυμο`) - Κωδικό αναφοράς (`Αρ.Αναφοράς`) --- ## Δημιουργία & Επεξεργασία Επαφής 1. **Δημιουργία Νέας Επαφής** Μεταβείτε στο μενού **Επαφές** και πατήστε το κουμπί **Νέα Επαφή**. Στη φόρμα **Δημιουργία Νέας Επαφής**, συμπληρώστε το **Κινητό** (υποχρεωτικό) και προαιρετικά τα πεδία **Όνομα**, **Επώνυμο** και **Αρ.Αναφοράς**, και πατήστε αποθήκευση. 2. **Επεξεργασία Επαφής** Εντοπίστε την επαφή στη λίστα και επιλέξτε **Επεξεργασία Επαφής**. Μπορείτε να ενημερώσετε τα στοιχεία της επαφής ή να αλλάξετε την κατάσταση της σημαίας **«Άκυρος;»** ανά πάσα στιγμή. --- ## Σημαία «Άκυρος;» (Suppression / Opt-out) Η σημαία **«Άκυρος;»** (`Invalid?`) αποτελεί τον ενσωματωμένο μηχανισμό προστασίας και εξαίρεσης παραληπτών (suppression list) του Rayo SMS: - Όταν μια επαφή είναι μαρκαρισμένη ως **Άκυρος**, **εξαιρείται αυτόματα** από κάθε αποστολή SMS προς **Ομάδες** στις οποίες ανήκει. - **Γιατί να τη χρησιμοποιήσετε αντί για διαγραφή;** Εάν διαγράψετε έναν αριθμό που ζήτησε εξαίρεση (opt-out) ή αποδείχθηκε μη έγκυρος, υπάρχει κίνδυνος να εισαχθεί ξανά κατά λάθος σε μελλοντική μαζική εισαγωγή λίστας. Διατηρώντας την επαφή με ενεργή τη σημαία **«Άκυρος;»**, διασφαλίζετε ότι δεν θα λάβει ανεπιθύμητα μηνύματα στο μέλλον, χωρίς να χάσετε το ιστορικό ή τον κωδικό αναφοράς της. > **TIP: Συμμόρφωση με Αιτήματα Διαγραφής (Opt-out)** > Όταν ένας παραλήπτης ζητά να μη λαμβάνει πλέον ενημερωτικά ή προωθητικά SMS, ανοίξτε την καρτέλα του μέσω της **Επεξεργασίας Επαφής** και ενεργοποιήστε το πεδίο **«Άκυρος;»**. Η εξαίρεση εφαρμόζεται ακαριαία σε όλες τις ομάδες. --- ## Διαγραφή Κινητού Μπορείτε να διαγράψετε οριστικά μια επαφή από το ευρετήριό σας επιλέγοντας τη σχετική ενέργεια διαγραφής στη λίστα **Επαφές**. > **DANGER: Επίπτωση Διαγραφής σε Ομάδες** > Η **Διαγραφή Κινητού** από τη σελίδα **Επαφές** διαγράφει την εγγραφή οριστικά από τον λογαριασμό σας και **την αφαιρεί ταυτόχρονα από όλες τις Ομάδες** (`Ομάδες`) στις οποίες ανήκει. Εάν επιθυμείτε να αφαιρέσετε έναν αριθμό μόνο από μία συγκεκριμένη ομάδα, πραγματοποιήστε την αφαίρεση μέσα από τη σελίδα της ομάδας. --- ## Σχετικοί Οδηγοί - [Ομάδες Επαφών & Μαζική Εισαγωγή](https://docs.rayosms.nl/el/contacts-and-groups/groups): Οργανώστε τις επαφές σας σε λίστες και εισαγάγετε χιλιάδες αριθμούς μαζικά. - [Αποστολή Μεμονωμένων & Μαζικών SMS](https://docs.rayosms.nl/el/messaging/sending-sms): Στείλτε καμπάνιες SMS σε επιλεγμένες ομάδες επαφών. --- ### Ομάδες Επαφών & Μαζική Εισαγωγή Source: https://docs.rayosms.nl/el/contacts-and-groups/groups/ Description: Δημιουργία ομάδων, προσθήκη μεμονωμένων ή χιλιάδων επαφών μαζικά και κανόνες αυτόματης εκκαθάρισης διπλοτύπων στο Rayo SMS. Στην ενότητα **Ομάδες** (`/groups`) του [Rayo SMS](https://sms.rayosms.nl/groups) μπορείτε να οργανώνετε τις επαφές σας σε θεματικές λίστες παραληπτών (π.χ. *Πελάτες Χονδρικής*, *VIP Μέλη*, *Υπενθυμίσεις Ραντεβού*) και να εισάγετε μαζικά χιλιάδες αριθμούς μέσα σε λίγα δευτερόλεπτα. --- ## Πλεονεκτήματα Χρήσης Ομάδων Η οργάνωση των παραληπτών σας σε **Ομάδες** προσφέρει τρία κρίσιμα πλεονεκτήματα κατά την αποστολή SMS: 500 Κινητά" icon="rocket"> Η χρήση Ομάδας είναι **απαραίτητη** όταν θέλετε να στείλετε SMS σε **περισσότερους από 500 αριθμούς κινητών** ταυτόχρονα (καθώς το πεδίο χειροκίνητης επικόλλησης αριθμών δέχεται έως 500 αριθμούς ανά αποστολή). #### Αυτόματη Αφαίρεση Διπλοτύπων (6 Ώρες) Το Rayo SMS αποτρέπει την αποστολή του ίδιου ακριβώς περιεχομένου SMS στον ίδιο αριθμό κινητού εντός **παραθύρου 6 ωρών**. Αν ένας αριθμός ανήκει σε πολλαπλές επιλεγμένες ομάδες, ο παραλήπτης λαμβάνει **μόνο ένα SMS**. #### Αυτόματη Εξαίρεση «Άκυρων» Όσες επαφές έχουν σημανθεί ως **«Άκυρος;»** (`Άκυρος`) εξαιρούνται αυτόματα κατά την αποστολή προς οποιαδήποτε ομάδα, προστατεύοντας εσάς και τους παραλήπτες σας. --- ## Δημιουργία Νέας Ομάδας 1. Επιλέξτε **Ομάδες** από το αριστερό μενού πλοήγησης. 2. Πατήστε το κουμπί **Νέα Ομάδα**. 3. Στο πεδίο **Δώστε το Όνομα της Ομάδας**, πληκτρολογήστε ένα περιγραφικό όνομα για τη λίστα σας. 4. Πατήστε **Αποθήκευση**. --- ## Προσθήκη Μελών σε Ομάδα Αφού ανοίξετε μια ομάδα, μπορείτε να προσθέσετε παραλήπτες είτε μεμονωμένα είτε μαζικά. ### Προσθήκη Μεμονωμένου Μέλους (`Προσθήκη Μέλους`) Πατήστε **Προσθήκη Μέλους** για να προσθέσετε έναν μεμονωμένο αριθμό κινητού στην ομάδα (μαζί με προαιρετικό όνομα, επώνυμο και κωδικό αναφοράς). Αν ο αριθμός δεν υπάρχει ήδη στις **Επαφές** σας, δημιουργείται αυτόματα. ### Μαζική Προσθήκη Μελών (`Προσθήκη Πολλών Μελών`) Για να εισαγάγετε δεκάδες ή χιλιάδες επαφές ταυτόχρονα, επιλέξτε **Προσθήκη Πολλών Μελών**. #### Μορφή Δεδομένων Εισαγωγής Εισαγάγετε **μία επαφή ανά γραμμή**. Κάθε γραμμή μπορεί να περιέχει μόνο τον αριθμό κινητού ή επιπλέον στοιχεία διαχωρισμένα με κόμμα (`,`) με τη σειρά `Κινητό,Όνομα,Επώνυμο,ΚωδικόςΑναφοράς`: ```text +306972669766 +306972669762 +306972669761,Παναγιώτης,Γεωργίου +306972669760,Μαρία,Λιάπη,cust-2343 +306972669759,Δημήτρης ``` - **Προαιρετικό πρόθεμα χώρας**: Το διεθνές πρόθεμα χώρας (π.χ. `+30` ή `30`) είναι προαιρετικό. Εάν καταχωρήσετε έναν αριθμό χωρίς πρόθεμα (π.χ. `6972669766`), το σύστημα εφαρμόζει αυτόματα το προεπιλεγμένο πρόθεμα χώρας του λογαριασμού σας. - **Ασύγχρονη επεξεργασία στο παρασκήνιο**: Η μαζική εισαγωγή εκτελείται ασύγχρονα στο παρασκήνιο ώστε να μπορείτε να συνεχίσετε την εργασία σας χωρίς αναμονή. Μόλις υποβάλετε τη λίστα, ενημερώνεστε ότι: > `Θα ειδοποιηθείτε με email μόλις η επεξεργασία τελειώσει` Με την ολοκλήρωση της διαδικασίας, λαμβάνετε αναλυτικό email επιβεβαίωσης. --- ## Διαγραφή Μέλους από Ομάδα Όταν επιλέγετε αφαίρεση/διαγραφή ενός αριθμού μέσα από τη σελίδα μιας **Ομάδας**: - Ο αριθμός κινητού αφαιρείται **μόνο από τη συγκεκριμένη ομάδα**. - Η επαφή **παραμένει κανονικά αποθηκευμένη στις `Επαφές` σας** καθώς και σε τυχόν άλλες ομάδες στις οποίες συμμετέχει. > **NOTE: Διαφορά Αφαίρεσης από Ομάδα vs. Οριστικής Διαγραφής** > - **Διαγραφή μέσα από τις `Ομάδες`**: Αφαιρεί τη σύνδεση του μέλους με τη συγκεκριμένη ομάδα· η επαφή διατηρείται στις **Επαφές**. > - **Διαγραφή μέσα από τις `Επαφές`**: Διαγράφει οριστικά την επαφή από τον λογαριασμό και την αφαιρεί από **όλες** τις ομάδες. --- ## Σχετικοί Οδηγοί - [Διαχείριση Επαφών](https://docs.rayosms.nl/el/contacts-and-groups/contacts): Δείτε πώς λειτουργεί το κεντρικό βιβλίο επαφών και η σημαία εξαίρεσης «Άκυρος;». - [Αποστολή Μεμονωμένων & Μαζικών SMS](https://docs.rayosms.nl/el/messaging/sending-sms): Στείλτε μαζικά SMS σε μία ή περισσότερες ομάδες επαφών. --- ## Ενότητα: Μονάδες & Χρεώσεις (Credits & Billing — Greek) ### Αγορά Μονάδων & Τρόποι Πληρωμής Source: https://docs.rayosms.nl/el/billing/purchasing-credits/ Description: Οδηγός παραγγελίας μονάδων SMS, εμπορικοί όροι, τιμολόγηση και διαθέσιμοι τρόποι πληρωμής (Κάρτα, Τραπεζική Κατάθεση, Πίστωση). Το Rayo SMS λειτουργεί με ευέλικτο μοντέλο προπληρωμένων μονάδων (prepaid credits), χωρίς πάγια ή κρυφές συνδρομές. Για να προμηθευτείτε μονάδες, μεταβείτε από το αριστερό μενού στην ενότητα **Μονάδες** (ή πατήστε στην ένδειξη **Υπόλ. Μονάδων** στην επάνω γραμμή εργαλείων) και επιλέξτε **Παραγγελία Μονάδων** στο [Περιβάλλον Εφαρμογής Rayo SMS](https://sms.rayosms.nl). --- ## Εμπορικοί Κανόνες & Τιμολόγηση Πριν ολοκληρώσετε μια παραγγελία μονάδων, λάβετε υπόψη τους εξής βασικούς εμπορικούς όρους: - **Προπληρωμένες Μονάδες (Prepaid)**: Οι μονάδες προπληρώνονται και αφαιρούνται από το υπόλοιπό σας μόνο όταν αποστέλλετε μηνύματα. - **ΦΠΑ (VAT)**: Όλες οι αναγραφόμενες τιμές μονάδας είναι καθαρές (δεν συμπεριλαμβάνουν ΦΠΑ). Ο αναλογών **ΦΠΑ υπολογίζεται αυτόματα** κατά το στάδιο της παραγγελίας βάσει των φορολογικών στοιχείων της εταιρείας σας. - **Διάρκεια Ισχύος 1 Έτους (365 Ημέρες)**: Οι μονάδες έχουν διάρκεια ισχύος ενός έτους από την αγορά τους (**`θα πρέπει να καταναλώσετε μέσα σε 1 χρόνο τις μονάδες που έχετε αγοράσει`**). - **Πολιτική Επιστροφών**: Μετά την πίστωση των μονάδων στον λογαριασμό σας, δεν πραγματοποιούνται ακυρώσεις παραγγελιών ή επιστροφές χρημάτων. - **Αυτόματη Έκδοση Τιμολογίου**: Για κάθε ολοκληρωμένη αγορά εκδίδεται αυτόματα το αντίστοιχο φορολογικό παραστατικό (**Τιμολόγιο**) και αποστέλλεται ηλεκτρονικά στη διεύθυνση email του λογαριασμού σας. > **CAUTION: Προαπαιτούμενο: Στοιχεία Εταιρείας** > Για να προχωρήσετε σε παραγγελία μονάδων και έκδοση τιμολογίου, βεβαιωθείτε ότι έχετε συμπληρώσει και επιβεβαιώσει τα φορολογικά σας στοιχεία στην ενότητα [Στοιχεία Εταιρείας & Τιμολόγησης](https://docs.rayosms.nl/el/getting-started/company-details/). --- ## Τρόποι Πληρωμής Το Rayo SMS υποστηρίζει τρεις τρόπους εξόφλησης και απόκτησης μονάδων: #### 1. Αγορά με Κάρτα ### `Αγορά με Κάρτα` (Online Πληρωμή μέσω Κάρτας) Η **Αγορά με Κάρτα** είναι ο ταχύτερος τρόπος ανανέωσης του υπολοίπου σας, καθώς οι μονάδες προστίθενται στον λογαριασμό σας **ακαριαία (24/7)** με τη χρήση πιστωτικής, χρεωστικής ή προπληρωμένης κάρτας μέσω της ασφαλούς πύλης πληρωμών **Stripe**. #### Προσαρμογή Μονάδων λόγω Προμήθειας Κάρτας Κατά την online πληρωμή με κάρτα ισχύει ο εξής κανόνας: > `Η αγορά μονάδων με χρήση κάρτας επιφέρει επιπλέον χρέωση η οποία επιβάλλεται με τη μορφή μειωμένων μονάδων` Συγκεκριμένα, το συνολικό ποσό πληρωμής σας παραμένει ακριβώς αυτό που επιλέξατε, ενώ το κόστος διεκπεραίωσης της κάρτας αφαιρείται αναλογικά από τις αποδιδόμενες μονάδες. Το σύστημα **υπολογίζει και εμφανίζει με πλήρη διαφάνεια τον ακριβή καθαρό αριθμό μονάδων** που θα λάβετε πριν πατήσετε την τελική πληρωμή. > **TIP: Ασφάλεια Στοιχείων Κάρτας** > Τα στοιχεία της κάρτας σας εισάγονται απευθείας στο κρυπτογραφημένο περιβάλλον της Stripe και **δεν αποθηκεύονται ποτέ στις βάσεις δεδομένων του Rayo SMS**. #### 2. Τραπεζική Κατάθεση ### `Τραπεζική Κατάθεση` (Έμβασμα σε Τραπεζικό Λογαριασμό) Η **Τραπεζική Κατάθεση** σάς επιτρέπει να προμηθευτείτε το **100% των μονάδων χωρίς καμία επιβάρυνση ή προμήθεια κάρτας**. 1. **Έλεγχος Ελάχιστου Ορίου & Επιλογή Τράπεζας** Στη σελίδα **Τραπεζική Κατάθεση**, ενημερώνεστε για το ελάχιστο ποσό κατάθεσης και το αντίστοιχο ελάχιστο όριο μονάδων, καθώς και για τη λίστα των διαθέσιμων τραπεζικών λογαριασμών (**IBAN**) στους οποίους μπορείτε να καταθέσετε το ποσό (συμπεριλαμβανομένου του ΦΠΑ). 2. **Εκτέλεση Κατάθεσης** Πραγματοποιήστε την κατάθεση ή το τραπεζικό έμβασμα μέσω e-banking, αναγράφοντας στην αιτιολογία την επωνυμία της επιχείρησής σας ή το email του λογαριασμού σας. 3. **Αποστολή Αποδεικτικού Κατάθεσης** Στείλτε το αποδεικτικό της τραπεζικής κατάθεσης μέσω email ή μέσω της ενσωματωμένης φόρμας **Επικοινωνία** της εφαρμογής. Μόλις επιβεβαιωθεί η συναλλαγή, οι μονάδες πιστώνονται στον λογαριασμό σας και αποστέλλεται το τιμολόγιό σας. #### 3. Αγορά με Πίστωση ### `Αγορά με Πίστωση` (Για Εγκεκριμένους Εταιρικούς Λογαριασμούς) Η **Αγορά με Πίστωση** διατίθεται σε εγκεκριμένους εταιρικούς πελάτες στους οποίους έχει ενεργοποιηθεί το σχετικό δικαίωμα από τη διαχείριση. #### Πώς Λειτουργεί 1. **Άμεση Προσθήκη Μονάδων**: Μόλις υποβάλετε την παραγγελία σας, οι μονάδες πιστώνονται αμέσως στο υπόλοιπό σας (`Αμέσως θα προσθέσουμε ... μονάδες στον λογαριασμό σας`), ώστε να μην καθυστερήσει καμία επείγουσα αποστολή σας. 2. **Εξόφληση μέσω Τραπεζικής Κατάθεσης**: Στη συνέχεια, εξοφλείτε το ποσό της παραγγελίας σε έναν από τους συνεργαζόμενους τραπεζικούς λογαριασμούς (IBAN). 3. **Επικύρωση (`Επιβεβαίωσε`)**: Μετά την εξόφληση, ο διαχειριστής επικυρώνει την παραγγελία (`Επιβεβαίωσε` / `Επικυρώθηκε;`). > **NOTE: Μία Ανεξόφλητη Παραγγελία με Πίστωση Κάθε Φορά** > Για να μπορέσετε να καταχωρήσετε επόμενη παραγγελία με πίστωση, θα πρέπει πρώτα να έχει εξοφληθεί και επικυρωθεί από τον διαχειριστή η προηγούμενη παραγγελία σας με πίστωση. --- ## Σχετικοί Οδηγοί - [Ιστορικό Παραγγελιών & Ειδοποιήσεις Χαμηλού Υπολοίπου](https://docs.rayosms.nl/el/billing/orders-and-alerts): Παρακολουθήστε όλες τις αγορές σας και ρυθμίστε αυτόματες ειδοποιήσεις SMS. - [Στοιχεία Εταιρείας & Τιμολόγησης](https://docs.rayosms.nl/el/getting-started/company-details): Διαχειριστείτε τα φορολογικά στοιχεία για την έκδοση των τιμολογίων σας. --- ### Ιστορικό Παραγγελιών & Ειδοποιήσεις Χαμηλού Υπολοίπου Source: https://docs.rayosms.nl/el/billing/orders-and-alerts/ Description: Παρακολούθηση ιστορικού αγορών μονάδων και ρύθμιση αυτόματων ειδοποιήσεων SMS όταν το υπόλοιπό σας πέφτει κάτω από τη μέση ημερήσια κατανάλωση. Το Rayo SMS σάς παρέχει πλήρη εικόνα όλων των συναλλαγών σας καθώς και έξυπνο μηχανισμό έγκαιρης ειδοποίησης μέσω SMS, ώστε να μην ξεμένετε ποτέ από μονάδες κατά τη διάρκεια κρίσιμων αποστολών. --- ## Ιστορικό Παραγγελιών (`/sms_credit_sales`) Από το μενού **Μονάδες -> Ιστορικό Παραγγελιών** στο [Rayo SMS](https://sms.rayosms.nl/sms_credit_sales), έχετε πρόσβαση στο πλήρες αρχείο όλων των αγορών μονάδων του λογαριασμού σας. Για κάθε παραγγελία εμφανίζονται αναλυτικά: - **Ημερομηνία & Ώρα** καταχώρησης της παραγγελίας. - **Μονάδες (Credits)** που προστέθηκαν στον λογαριασμό σας. - **Ποσά Χρέωσης**: Καθαρή αξία (χωρίς ΦΠΑ), ποσό ΦΠΑ και συνολικό πληρωτέο ποσό (με ΦΠΑ). - **Τρόπος Πληρωμής**: `Αγορά με Κάρτα`, `Τραπεζική Κατάθεση` ή `Αγορά με Πίστωση`. - **Κατάσταση Επικύρωσης (`Επικυρώθηκε;`)**: Δείχνει αν η παραγγελία έχει εξοφληθεί και επιβεβαιωθεί (ειδικά χρήσιμο για παραγγελίες που έγιναν με πίστωση). - **Στοιχεία Κάρτας / Συναλλαγής**: Τα τελευταία ψηφία, ο τύπος της κάρτας και ο κωδικός αναφοράς της συναλλαγής για εύκολη λογιστική αντιπαραβολή. --- ## Παραλήπτες Ειδοποιήσεων Χαμηλού Υπολοίπου (`/settings/low_credit_alert_recipients`) Για να αποφύγετε τυχόν διακοπή στη ροή των μηνυμάτων σας (π.χ. αποστολή κωδικών OTP ή αυτοματοποιημένων ειδοποιήσεων μέσω API), μπορείτε να ορίσετε έως δύο αριθμούς κινητών τηλεφώνων που θα λαμβάνουν αυτόματη ειδοποίηση SMS όταν το υπόλοιπό σας μειωθεί. ### Ρύθμιση Αριθμών Ειδοποίησης 1. Από το αριστερό μενού πλοήγησης, επιλέξτε **Προχωρημένες Ενέργειες -> Ρυθμίσεις -> Ειδοποιήσεις Για Χαμηλό Υπόλοιπο** (ή μεταβείτε στη σελίδα [Παραλήπτες Ειδοποιήσεων Χαμηλού Υπολοίπου](https://sms.rayosms.nl/settings/low_credit_alert_recipients)). 2. Συμπληρώστε το πεδίο **`1ο Κινητό`** με τον κύριο αριθμό κινητού τηλεφώνου που θέλετε να λαμβάνει την ειδοποίηση. 3. Προαιρετικά, συμπληρώστε το πεδίο **`2ο Κινητό`** (π.χ. του υπεύθυνου λογιστηρίου ή του τεχνικού διαχειριστή). 4. Πατήστε αποθήκευση για να ενεργοποιήσετε τις ειδοποιήσεις. --- ### Πώς Υπολογίζεται το Όριο Ειδοποίησης (Threshold) Αντί για ένα στατικό όριο που μπορεί να είναι πολύ μικρό για μεγάλους αποστολείς ή πολύ μεγάλο για μικρότερους λογαριασμούς, το Rayo SMS προσαρμόζει δυναμικά το όριο ειδοποίησης στον δικό σας ρυθμό χρήσης: - **Μέση Ημερήσια Κατανάλωση 30 Ημερών**: Το σύστημα υπολογίζει αυτόματα τον **μέσο όρο ημερήσιας κατανάλωσης μονάδων των τελευταίων 30 ημερών** του λογαριασμού σας. - **Προεπιλεγμένο Όριο (100 Μονάδες)**: Εάν δεν υπάρχει πρόσφατη δραστηριότητα αποστολών τις τελευταίες 30 ημέρες, το όριο ασφαλείας ορίζεται αυτόματα στις **100 μονάδες**. - **Αυτόματη Αποστολή Ειδοποίησης SMS**: Μόλις το διαθέσιμο υπόλοιπο μονάδων σας πέσει κάτω από αυτήν τη μέση ημερήσια κατανάλωση, το Rayo SMS αποστέλλει αυτόματα προειδοποιητικό SMS στο **`1ο Κινητό`** και στο **`2ο Κινητό`** που έχετε δηλώσει, δίνοντάς σας επαρκή χρόνο μιας ολόκληρης ημέρας λειτουργίας για να ανανεώσετε τις μονάδες σας. > **TIP: Συνδυασμός με Έλεγχο Υπολοίπου μέσω API** > Εάν χρησιμοποιείτε το Rayo SMS μέσω API, οι προγραμματιστές σας μπορούν επίσης να ελέγχουν το υπόλοιπο προγραμματιστικά μέσω του endpoint `GET /v1/balance_in_credits`. Δείτε περισσότερα στον οδηγό [Επισκόπηση API & Διαχείριση Κλειδιών API](https://docs.rayosms.nl/el/developers/api-overview-and-keys/). --- ## Σχετικοί Οδηγοί - [Αγορά Μονάδων & Τρόποι Πληρωμής](https://docs.rayosms.nl/el/billing/purchasing-credits): Ανανεώστε άμεσα τις μονάδες σας με κάρτα, τραπεζική κατάθεση ή πίστωση. - [Μέλη Ομάδας, Προσκλήσεις & Εναλλαγή Λογαριασμού](https://docs.rayosms.nl/el/account-and-security/team-members): Δώστε πρόσβαση στους τεχνικούς σας για τη διαχείριση των ρυθμίσεων ειδοποιήσεων. --- ## Ενότητα: Απόρρητο, Ασφάλεια & Ομάδα (Privacy, Security & Team — Greek) ### Μόνιμη Απόκρυψη Μηνυμάτων (Μασκάρισμα) & GDPR Source: https://docs.rayosms.nl/el/account-and-security/message-masking/ Description: Προστασία προσωπικών δεδομένων (GDPR) και ευαίσθητου περιεχομένου (OTP, PIN) μέσω χειροκίνητης ή αυτόματης μόνιμης απόκρυψης του σώματος των SMS. Η **Μόνιμη Απόκρυψη Μηνυμάτων (Μασκάρισμα)** είναι μια εξειδικευμένη λειτουργία ασφαλείας και ιδιωτικότητας του [Rayo SMS](https://sms.rayosms.nl) που σας επιτρέπει να διαγράφετε μη αναστρέψιμα το κείμενο (σώμα) των απεσταλμένων SMS, διατηρώντας παράλληλα ακέραιο το ιστορικό παράδοσης και χρέωσης. --- ## Γιατί είναι Κρίσιμο το Μασκάρισμα Μηνυμάτων (GDPR & Ασφάλεια) Πολλές επιχειρήσεις και οργανισμοί αποστέλλουν μέσω SMS πληροφορίες υψηλής ευαισθησίας ή δεδομένα προσωπικού χαρακτήρα: - **Κωδικούς μιας χρήσης (OTPs), PINs & Κωδικούς Επαλήθευσης (2FA)** - **Προσωπικές ειδοποιήσεις πελατών**, ιατρικά ραντεβού ή οικονομικές ενημερώσεις - **Εμπιστευτικές εσωτερικές επικοινωνίες** Για τη συμμόρφωση με τον **Γενικό Κανονισμό για την Προστασία Δεδομένων (GDPR)** (αρχή της ελαχιστοποίησης των δεδομένων και του περιορισμού της περιόδου αποθήκευσης), το περιεχόμενο αυτών των μηνυμάτων δεν πρέπει να παραμένει αποθηκευμένο σε ευανάγνωστη μορφή μετά την εκπλήρωση του σκοπού του. --- ## Πώς Λειτουργεί η Μόνιμη Απόκρυψη Όταν εφαρμόζεται μόνιμη απόκρυψη σε ένα μήνυμα: - Το **σώμα του μηνύματος** αντικαθίσταται μόνιμα στη βάση δεδομένων από **60 αστερίσκους**: ```text ************************************************************ ``` - Η διαδικασία είναι **μη αναστρέψιμη**: ούτε οι χρήστες του λογαριασμού ούτε το προσωπικό υποστήριξης του Rayo SMS μπορούν να ανακτήσουν το αρχικό κείμενο. - **Όλα τα μεταδεδομένα διατηρούνται κανονικά**: Ο παραλήπτης, το αναγνωριστικό αποστολέα, οι χρονοσφραγίδες αποστολής/παράδοσης, η κατάσταση παράδοσης (DLR) και οι χρεωθείσες μονάδες παραμένουν πλήρως διαθέσιμα για έλεγχο και τιμολόγηση. > **DANGER: Μη Αναστρέψιμη Ενέργεια** > Η μόνιμη απόκρυψη αντικαθιστά οριστικά το κείμενο των μηνυμάτων με `************************************************************`. Βεβαιωθείτε ότι δεν χρειάζεστε πλέον το κείμενο των μηνυμάτων πριν ενεργοποιήσετε τη χειροκίνητη ή την αυτόματη απόκρυψη. --- ## Οι 3 Τρόποι Μόνιμης Απόκρυψης Μηνυμάτων Το Rayo SMS προσφέρει τρεις ευέλικτους τρόπους εφαρμογής του μασκαρίσματος, ανάλογα με τις απαιτήσεις συμμόρφωσης της επιχείρησής σας: #### 1. Χειροκίνητη Απόκρυψη ### 1. Χειροκίνητη Μόνιμη Απόκρυψη Μπορείτε να αποκρύψετε μαζικά το περιεχόμενο όλων των έως τώρα απεσταλμένων μηνυμάτων σας ανά πάσα στιγμή: 1. Μεταβείτε στη σελίδα **Απεσταλμένα** από το κεντρικό μενού πλοήγησης. 2. Πατήστε το κουμπί **`Μόνιμη Απόκρυψη Σώματος Μηνυμάτων`**. 3. Επιβεβαιώστε την ενέργεια. Η εργασία εκτελείται ασύγχρονα στο παρασκήνιο και **θα λάβετε ενημερωτικό email μόλις ολοκληρωθεί** η απόκρυψη όλων των μηνυμάτων. #### 2. Άμεση Αυτόματη Απόκρυψη ### 2. Άμεση Αυτόματη Απόκρυψη Ιδανική επιλογή για συστήματα αποστολής κωδικών OTP/2FA όπου το περιεχόμενο του SMS δεν πρέπει να παραμένει ορατό ούτε για ένα λεπτό μετά τη διεκπεραίωση της αποστολής: 1. Μεταβείτε στο μενού **Προχωρημένες Ενέργειες -> Ρυθμίσεις -> Μασκάρισμα Μηνυμάτων**. 2. Πατήστε το κουμπί **`Ενεργοποίηση Άμεσης Μόνιμης Απόκρυψης`**. 3. Από εκείνη τη στιγμή και έπειτα, κάθε νέο εξερχόμενο SMS θα μασκάρεται αυτόματα αμέσως μετά την αποστολή του. #### 3. Καθυστερημένη Αυτόματη Απόκρυψη ### 3. Καθυστερημένη Αυτόματη Απόκρυψη (Μετά από X Λεπτά) Σας επιτρέπει να διατηρείτε το κείμενο των μηνυμάτων ορατό για ένα καθορισμένο χρονικό διάστημα (π.χ. μερικές ώρες ή ημέρες για σκοπούς εξυπηρέτησης πελατών και ελέγχου) και στη συνέχεια να το αποκρύπτετε αυτόματα: 1. Μεταβείτε στο μενού **Προχωρημένες Ενέργειες -> Ρυθμίσεις -> Μασκάρισμα Μηνυμάτων**. 2. Ορίστε τον επιθυμητό χρόνο καθυστέρησης σε λεπτά: από **`1`** έως **`129.600` λεπτά** (δηλαδή έως **90 ημέρες** το μέγιστο). 3. Πατήστε **`Ενεργοποίηση Μόνιμης Απόκρυψης Μετά από Αυτόν τον Αριθμό Λεπτών`**. | Επιθυμητή Περίοδος Διατήρησης | Τιμή σε Λεπτά | | :--- | :--- | | 1 ώρα | `60` | | 24 ώρες (1 ημέρα) | `1440` | | 7 ημέρες | `10080` | | 30 ημέρες | `43200` | | 90 ημέρες (Μέγιστο) | `129600` | --- ## Σχετικοί Οδηγοί - [Ιστορικό & Αναφορές Παράδοσης](https://docs.rayosms.nl/el/messaging/delivery-history-and-reports): Δείτε πώς εμφανίζονται τα μεταδεδομένα και οι αναφορές παράδοσης στη σελίδα Απεσταλμένα. - [Μέλη Ομάδας, Προσκλήσεις & Εναλλαγή Λογαριασμού](https://docs.rayosms.nl/el/account-and-security/team-members): Διαχειριστείτε την πρόσβαση μελών με ρόλο developer στις ρυθμίσεις ασφαλείας. --- ### Μέλη Ομάδας, Προσκλήσεις & Εναλλαγή Λογαριασμού Source: https://docs.rayosms.nl/el/account-and-security/team-members/ Description: Πρόσκληση συνεργατών και προγραμματιστών (ρόλος developer), διαχείριση προσκλήσεων και γρήγορη εναλλαγή μεταξύ πολλαπλών λογαριασμών Rayo SMS. Το [Rayo SMS](https://sms.rayosms.nl) σάς επιτρέπει να προσκαλείτε εξωτερικούς συνεργάτες ή μέλη της τεχνικής σας ομάδας στον λογαριασμό σας με ελεγχόμενα δικαιώματα πρόσβασης, καθώς και να εργάζεστε σε πολλαπλούς λογαριασμούς κάτω από τα ίδια στοιχεία σύνδεσης. --- ## Πρόσκληση Συνεργατών (`Προσκλήσεις Μελών`) Για να προσκαλέσετε έναν νέο συνεργάτη στον λογαριασμό σας: 1. Από το αριστερό μενού πλοήγησης, επιλέξτε **Προχωρημένες Ενέργειες -> Προσκλήσεις Μελών**. 2. Πατήστε το κουμπί **`Πρόσκληση Μέλους`**. 3. Εισαγάγετε τη διεύθυνση email του συνεργάτη, επιλέξτε τον ρόλο του (`developer`) και αποστείλετε την πρόσκληση. --- ## Ο Ρόλος `developer` (Προγραμματιστής) Ο ρόλος **`developer`** έχει σχεδιαστεί ειδικά σύμφωνα με την αρχή των ελαχίστων προνομίων (principle of least privilege), ώστε οι προγραμματιστές και οι τεχνικοί σας συνεργάτες να μπορούν να υλοποιήσουν τη διασύνδεση API χωρίς να έχουν πρόσβαση σε εμπορικά ή προσωπικά δεδομένα. #### Τι Επιτρέπεται στον Ρόλο developer Πρόσβαση στις τεχνικές ρυθμίσεις διασύνδεσης (`Προχωρημένες Ενέργειες -> Ρυθμίσεις`) και στις προσωπικές προτιμήσεις χρήστη: - **Κεντρική Σελίδα (Dashboard)** - **Προτιμήσεις Χρήστη & Προτίμηση Γλώσσας** (`/preferences`) - **Κλειδιά API** (δημιουργία, ενεργοποίηση, απενεργοποίηση, διαγραφή) - **Callbacks** (ρύθμιση, έλεγχος και διαχείριση κρυφής λέξης Webhooks αναφορών παράδοσης) #### Τι Δεν Εκτίθεται στον Ρόλο developer Προστασία ευαίσθητων επιχειρηματικών δεδομένων και ρυθμίσεων ιδιοκτήτη: - **Δεν έχει πρόσβαση** στο **Μασκάρισμα Μηνυμάτων** και στους **Παραλήπτες Ειδοποιήσεων Χαμηλού Υπολοίπου** - **Δεν έχει πρόσβαση** σε καμπάνιες και ιστορικό **Απεσταλμένων** SMS - **Δεν έχει πρόσβαση** στις **Επαφές** και στις **Ομάδες** παραληπτών - **Δεν έχει πρόσβαση** σε **Μονάδες**, τιμολόγια ή **Ιστορικό Παραγγελιών** --- ## Διαχείριση Απεσταλμένων & Ληφθεισών Προσκλήσεων Στη σελίδα **Προχωρημένες Ενέργειες -> Προσκλήσεις Μελών**, οι προσκλήσεις χωρίζονται σε δύο καρτέλες/ενότητες: ### 1. `Απεσταλμένες` (Προσκλήσεις που έχετε στείλει) Για κάθε πρόσκληση που έχετε αποστείλει από τον λογαριασμό σας, μπορείτε να εκτελέσετε τις εξής ενέργειες: - **`Επαναποστολή`**: Στέλνει ξανά το email πρόσκλησης στον παραλήπτη. - **`Λήξη`**: Ακυρώνει την ισχύ μιας εκκρεμούς πρόσκλησης ώστε να μην μπορεί πλέον να γίνει αποδεκτή. - **`Διαγραφή`**: Διαγράφει την εγγραφή της πρόσκλησης από τη λίστα. ### 2. `Ληφθείσες` (Προσκλήσεις που έχετε λάβει από άλλους λογαριασμούς) Όταν ένας άλλος λογαριασμός Rayo SMS προσκαλέσει το δικό σας email, η πρόσκληση εμφανίζεται στις **Ληφθείσες**, όπου μπορείτε να επιλέξετε: - **`Αποδοχή`**: Συνδέει τον χρήστη σας ως μέλος στον λογαριασμό που σας προσκάλεσε. - **`Απόρριψη`**: Απορρίπτει την πρόσκληση. --- ## Εναλλαγή Λογαριασμού (`Αλλαγή λογαριασμού`) Αφού αποδεχθείτε μία ή περισσότερες προσκλήσεις, μπορείτε να μεταβαίνετε άμεσα μεταξύ του προσωπικού/εταιρικού σας λογαριασμού και των λογαριασμών στους οποίους είστε μέλος, χωρίς να χρειάζεται αποσύνδεση: 1. Κάντε κλικ στο μενού χρήστη (το όνομα/email σας) **επάνω αριστερά** στην εφαρμογή. 2. Επιλέξτε **`Αλλαγή λογαριασμού`**. 3. Στο παράθυρο επιλογής εμφανίζονται διακριτά: - **`Ο λογαριασμός σας`**: Ο κύριος λογαριασμός που σας ανήκει. - **`Άλλοι λογαριασμοί`**: Όλοι οι λογαριασμοί τρίτων στους οποίους συμμετέχετε ως μέλος. 4. Επιλέξτε τον λογαριασμό στον οποίο θέλετε να εργαστείτε. --- ## Προβολή & Αφαίρεση Μελών (`Μέλη`) Ο ιδιοκτήτης του λογαριασμού μπορεί ανά πάσα στιγμή να ελέγξει ποιοι συνεργάτες έχουν ενεργή πρόσβαση και να ανακαλέσει τα δικαιώματά τους: 1. Μεταβείτε στο μενού **Προχωρημένες Ενέργειες -> Μέλη**. 2. Εξετάστε τη λίστα των ενεργών μελών και των ρόλων τους. 3. Πατήστε **`Αφαίρεση`** δίπλα σε οποιοδήποτε μέλος για να ανακαλέσετε ακαριαία την πρόσβασή του στον λογαριασμό σας. --- ## Σχετικοί Οδηγοί - [Επισκόπηση API & Διαχείριση Κλειδιών API](https://docs.rayosms.nl/el/developers/api-overview-and-keys): Πώς οι developers δημιουργούν και διαχειρίζονται κλειδιά πρόσβασης REST API. - [Callbacks Αναφορών Παράδοσης (Webhooks)](https://docs.rayosms.nl/el/developers/webhooks-and-callbacks): Ρύθμιση αυτοματοποιημένων ειδοποιήσεων παράδοσης (DLR) και επαλήθευση υπογραφής. --- ## Ενότητα: Προγραμματιστές, API & Webhooks (Developers & API — Greek) ### Επισκόπηση API & Διαχείριση Κλειδιών API Source: https://docs.rayosms.nl/el/developers/api-overview-and-keys/ Description: Οδηγός διασύνδεσης με το REST API του Rayo SMS, διαχείριση έως 25 κλειδιών API, αυθεντικοποίηση, βασικά endpoints και λειτουργία προσομοίωσης (simulateSendFlag). Το **Rayo SMS HTTP REST API** σάς επιτρέπει να ενσωματώσετε την αποστολή μεμονωμένων και μαζικών SMS, τον προγραμματισμό αποστολών και τον έλεγχο υπολοίπου απευθείας στο ERP, το CRM, το e-shop ή την custom εφαρμογή σας. > **TIP: Πλήρης Τεχνική Τεκμηρίωση API** > Για αναλυτικά παραδείγματα κώδικα, σχήματα JSON (schemas) και κωδικούς σφαλμάτων, επισκεφθείτε την [Πλήρης Τεκμηρίωση Rayo SMS API](https://api-docs.rayosms.nl) στη διεύθυνση `https://api-docs.rayosms.nl`. --- ## Βασικό URL (Base URL) & Ασφάλεια HTTPS Όλες οι κλήσεις προς το REST API πραγματοποιούνται αποκλειστικά μέσω κρυπτογραφημένης σύνδεσης **HTTPS** στο ακόλουθο Base URL: - **Base URL**: `https://api.rayosms.nl/v1` Κάθε αίτημα (request) και απάντηση (response) με σώμα δεδομένων χρησιμοποιεί μορφή `application/json; charset=utf-8`. --- ## Διαχείριση Κλειδιών API (`Κλειδιά API`) Για την αυθεντικοποίηση των κλήσεών σας απαιτείται ένα ενεργό **Κλειδί API (API Key)**. Μπορείτε να διαχειριστείτε τα κλειδιά σας από το μενού **Προχωρημένες Ενέργειες -> Ρυθμίσεις -> Κλειδιά API** στο [Περιβάλλον Εφαρμογής Rayo SMS](https://sms.rayosms.nl/settings/api_keys). - **Όριο έως 25 Κλειδιά API**: Κάθε λογαριασμός μπορεί να διατηρεί έως **25 Κλειδιά API** ταυτόχρονα, ώστε να απομονώνετε διαφορετικές εφαρμογές, περιβάλλοντα (production, staging) ή εξωτερικούς συνεργάτες. - **Διαθέσιμες Ενέργειες**: - **`Δημιουργία Κλειδιού API`**: Παράγει ένα νέο μοναδικό κλειδί API. - **`Ενεργοποίηση` / `Απενεργοποίηση`**: Σας επιτρέπει να αναστείλετε προσωρινά ή να επαναφέρετε την πρόσβαση ενός κλειδιού χωρίς να το διαγράψετε. - **`Διαγραφή`**: Καταργεί οριστικά το κλειδί API, ακυρώνοντας αμέσως κάθε μελλοντική κλήση που το χρησιμοποιεί. --- ## Αυθεντικοποίηση (`Authorization` Header) Κάθε κλήση προς το API πρέπει να περιλαμβάνει ένα **ενεργό** Κλειδί API στην κεφαλίδα HTTP **`Authorization`** μέσω HTTPS: ```http Authorization: Bearer ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ_API Content-Type: application/json ``` > **CAUTION: Προστασία Κλειδιών API** > Μην ενσωματώνετε ποτέ τα Κλειδιά API σε κώδικα frontend (browser JavaScript, mobile apps) ή σε δημόσια αποθετήρια Git. Αποθηκεύστε τα σε μεταβλητές περιβάλλοντος στον server σας. Εάν υποψιαστείτε διαρροή, πατήστε αμέσως **`Απενεργοποίηση`** ή **`Διαγραφή`** από τη σελίδα **Κλειδιά API**. --- ## Σύνοψη Βασικών Endpoints Παρακάτω συνοψίζονται τα κύρια endpoints του Rayo SMS API (σχετικά με το Base URL `https://api.rayosms.nl/v1`): | Μέθοδος & Endpoint | Περιγραφή | | :--- | :--- | | **`POST /v1/send_sms`** | Αποστολή άμεσου ή χρονοπρογραμματισμένου SMS σε έναν ή περισσότερους παραλήπτες. | | **`GET /v1/balance_in_credits`** | Ανάκτηση του τρέχοντος διαθέσιμου υπολοίπου μονάδων (credits) του λογαριασμού. | | **`GET /v1/check_status`** | Έλεγχος διαθεσιμότητας της υπηρεσίας API και εγκυρότητας του Κλειδιού API σας. | | **`DELETE /v1/sms_request_schedules/:id`** | Ακύρωση μιας προγραμματισμένης αποστολής SMS πριν την ώρα εκτέλεσής της. | --- ## Δωρεάν Δοκιμές με Λειτουργία Προσομοίωσης (`simulateSendFlag`) Κατά την ανάπτυξη και τον έλεγχο της διασύνδεσής σας στο `POST /v1/send_sms`, μπορείτε να χρησιμοποιήσετε την παράμετρο **`simulateSendFlag`** (θέτοντάς την σε `true`): - Το API επικυρώνει πλήρως το αίτημά σας (αυθεντικοποίηση, αναγνωριστικό αποστολέα, αριθμούς παραληπτών, μήκος μηνύματος, παραμέτρους χρονοπρογραμματισμού). - Επιστρέφει ρεαλιστική απάντηση επιτυχίας ή σφάλματος **χωρίς να αποσταλεί πραγματικό SMS** στο δίκτυο κινητής τηλεφωνίας και **χωρίς καμία χρέωση μονάδων**. --- ## Σχετικοί Οδηγοί - [Callbacks Αναφορών Παράδοσης (Webhooks)](https://docs.rayosms.nl/el/developers/webhooks-and-callbacks): Λάβετε ενημερώσεις κατάστασης παράδοσης (DLR) σε πραγματικό χρόνο στον server σας. - [Μέλη Ομάδας, Προσκλήσεις & Εναλλαγή Λογαριασμού](https://docs.rayosms.nl/el/account-and-security/team-members): Προσκαλέστε τους προγραμματιστές σας με τον εξειδικευμένο ρόλο developer. --- ### Callbacks Αναφορών Παράδοσης (Webhooks) & Επαλήθευση Υπογραφής Source: https://docs.rayosms.nl/el/developers/webhooks-and-callbacks/ Description: Ρύθμιση Webhooks (Callbacks) για λήψη αναφορών παράδοσης SMS σε πραγματικό χρόνο, επαλήθευση κρυπτογραφικής υπογραφής και εναλλαγή κρυφής λέξης χωρίς διακοπή. Τα **Callbacks Αναφορών Παράδοσης (Webhooks)** επιτρέπουν στο [Rayo SMS](https://sms.rayosms.nl) να ενημερώνει αυτόματα τον server σας σε πραγματικό χρόνο κάθε φορά που αλλάζει η κατάσταση παράδοσης (Delivery Report / DLR) ενός απεσταλμένου μηνύματος SMS. Για πλήρεις τεχνικές προδιαγραφές των παραμέτρων του payload, συμβουλευτείτε την [Πλήρης Τεκμηρίωση Rayo SMS API](https://api-docs.rayosms.nl) (`https://api-docs.rayosms.nl`). --- ## Ρύθμιση Callback URL & Μεθόδου HTTP Η διαχείριση των Webhooks πραγματοποιείται από το μενού **Προχωρημένες Ενέργειες -> Ρυθμίσεις -> Callbacks** ([Ρυθμίσεις Callbacks](https://sms.rayosms.nl/settings/callbacks)): 1. **Καθορισμός Callback URL** Εισαγάγετε το πλήρες URL του endpoint στον server σας (π.χ. `https://example.com/webhooks/rayo-dlr`) που θα υποδέχεται τις αναφορές παράδοσης. 2. **Επιλογή Μεθόδου HTTP (`get` ή `post`)** Επιλέξτε την επιθυμητή μέθοδο HTTP: - **`post`**: Αποστέλλει τα δεδομένα της αναφοράς παράδοσης στο σώμα του αιτήματος (συνιστάται). - **`get`**: Αποστέλλει τις παραμέτρους της αναφοράς παράδοσης ως query parameters στο URL. 3. **Δοκιμή με το Κουμπί `Έλεγχος` (`Test`)** Πριν αποθηκεύσετε τις ρυθμίσεις σας, πατήστε το κουμπί **`Έλεγχος`** (`Test`). Το Rayo SMS θα στείλει αμέσως ένα δοκιμαστικό αίτημα στο URL σας και θα επιβεβαιώσει ότι ο server σας απαντά επιτυχώς (HTTP `2xx`). 4. **Αποθήκευση ή Απενεργοποίηση** - Πατήστε **`Αποθήκευση`** για να ενεργοποιήσετε την αποστολή των Callbacks. - Εάν επιθυμείτε να σταματήσετε τη λήψη Webhooks και να καθαρίσετε τις ρυθμίσεις, πατήστε **`Διαγραφή και Απενεργοποίηση`**. --- ## Ασφάλεια Webhook & Επαλήθευση Υπογραφής (`Signing Secret`) Για να είστε βέβαιοι ότι κάθε αίτημα Callback προέρχεται αυθεντικά από το Rayo SMS και δεν έχει αλλοιωθεί κατά τη μεταφορά, κάθε λογαριασμός διαθέτει μια μοναδική **`Κρυφή Λέξη`** (**`Signing Secret`**) στη σελίδα **Callbacks**. - Κάθε HTTP αίτημα που αποστέλλει το Rayo SMS προς το Callback URL σας περιλαμβάνει την κεφαλίδα (header) υπογραφής: - **Κεφαλίδα Υπογραφής**: `X-sms-rayosms-nl-Signature` - Ο server σας πρέπει να υπολογίζει την αναμενόμενη υπογραφή HMAC χρησιμοποιώντας την **`Κρυφή Λέξη`** (`Signing Secret`) σας και να τη συγκρίνει (με constant-time σύγκριση) με την τιμή της κεφαλίδας `X-sms-rayosms-nl-Signature` πριν επεξεργαστεί την αναφορά παράδοσης. --- ## Εναλλαγή Κρυφής Λέξης Χωρίς Διακοπή Λειτουργίας (Zero-Downtime Rotation) Εάν χρειαστεί να αντικαταστήσετε την **`Κρυφή Λέξη`** σας (π.χ. στο πλαίσιο περιοδικής πολιτικής ασφαλείας), το Rayo SMS υποστηρίζει **εναλλαγή χωρίς καμία απώλεια Webhooks (zero-downtime rotation)**: 1. **Έναρξη Ακύρωσης (`Ακύρωση Κρυφής Λέξης`)** Στη σελίδα **Προχωρημένες Ενέργειες -> Ρυθμίσεις -> Callbacks**, πατήστε **`Ακύρωση Κρυφής Λέξης`** (`Expire Signing Secret`). 2. **Περίοδος Χάριτος & Νέα Κρυφή Λέξη** Το σύστημα δημιουργεί αμέσως μια νέα `Κρυφή Λέξη`, ενώ διατηρεί την παλιά σε ισχύ για μια μεταβατική περίοδο χάριτος. Κατά τη διάρκεια αυτής της περιόδου, μπορείτε να ενημερώσετε τον κώδικα/διαμόρφωση του server σας με τη νέα κρυφή λέξη χωρίς να απορρίπτονται τα εισερχόμενα Callbacks. 3. **Αναίρεση Ακύρωσης (Προαιρετικά)** Εάν αλλάξετε γνώμη πριν λήξει η περίοδος χάριτος της προηγούμενης κρυφής λέξης, μπορείτε να πατήσετε **`Μην Ακυρώσεις την Κρυφή Λέξη`** ώστε να ακυρώσετε τη διαδικασία λήξης. > **TIP: Βέλτιστη Πρακτική Υποδοχής Webhooks** > Το endpoint σας θα πρέπει να απαντά γρήγορα με κωδικό επιτυχίας HTTP `200 OK` και να διεκπεραιώνει τυχόν χρονοβόρες ενημερώσεις βάσης δεδομένων ασύγχρονα. --- ## Σχετικοί Οδηγοί - [Επισκόπηση API & Διαχείριση Κλειδιών API](https://docs.rayosms.nl/el/developers/api-overview-and-keys): Δείτε τα endpoints του REST API και πώς να διαχειριστείτε τα Κλειδιά API σας. - [Ιστορικό & Αναφορές Παράδοσης](https://docs.rayosms.nl/el/messaging/delivery-history-and-reports): Παρακολουθήστε τις καταστάσεις παράδοσης των SMS και μέσα από το περιβάλλον της εφαρμογής. --- ## Ενότητα: Διασυνδέσεις (Integrations — Greek) ### WSMS (SMS για WordPress & WooCommerce) Source: https://docs.rayosms.nl/el/integrations/wsms/ Description: Στείλτε ειδοποιήσεις SMS, κωδικούς OTP/2FA και καμπάνιες μάρκετινγκ από το WordPress και το WooCommerce μέσω της επίσημης διασύνδεσης του Rayo SMS με το WSMS. Το Rayo SMS είναι επίσημα ενσωματωμένο ως προεγκατεστημένη πύλη SMS (gateway) στο **[WSMS (πρώην WP SMS)](https://wsms.io)**, το κορυφαίο πρόσθετο (plugin) αποστολής SMS για WordPress και WooCommerce. Μέσω αυτής της διασύνδεσης, οι χρήστες του WSMS μπορούν να συνδέσουν τον λογαριασμό τους στο Rayo SMS απευθείας από το περιβάλλον διαχείρισης του WordPress—χωρίς καμία ανάγκη προγραμματισμού—αξιοποιώντας αυτοματοποιημένες ειδοποιήσεις παραγγελιών WooCommerce, ταυτοποίηση δύο παραγόντων (2FA) και είσοδο με OTP, ειδοποιήσεις φορμών, καθώς και μαζικές καμπάνιες SMS με υψηλή ταχύτητα, αξιοπιστία παράδοσης και ανταγωνιστικές χρεώσεις. - [Ρυθμίστε την πύλη Rayo SMS στο WSMS](https://wsms.io/docs/rayo-gateway-setup/): Ακολουθήστε τις αναλυτικές οδηγίες για να συνδέσετε τον λογαριασμό σας στο Rayo SMS με το WSMS. - [Επισκεφθείτε το WSMS (wsms.io)](https://wsms.io): Ανακαλύψτε τις δυνατότητες και την τεκμηρίωση του προσθέτου WSMS για WordPress & WooCommerce. --- ## Ενότητα: Πλατφόρμα White-Label (White-Label — Greek) ### Οδηγός Συνεργατών White-Label (Μεταπώληση Υπηρεσίας) Source: https://docs.rayosms.nl/el/white-label/partner-guide/ Description: Πλήρης οδηγός λειτουργίας της δικής σας White-Label πλατφόρμας SMS πάνω στην υποδομή του Rayo SMS: διασύνδεση πληρωμών, διαχείριση χρηστών, παραγγελιών και στοιχείων εταιρείας. Η πλατφόρμα **White-Label** του [Rayo SMS](https://sms.rayosms.nl) σάς δίνει τη δυνατότητα να λειτουργείτε τη δική σας επώνυμη υπηρεσία Web-to-SMS και REST API (μεταπώληση υπηρεσίας SMS) στους δικούς σας πελάτες, αξιοποιώντας την αξιοπιστία, την ταχύτητα δρομολόγησης και την τεχνολογική υποδομή του Rayo SMS. --- ## Η Δική σας Επώνυμη Πλατφόρμα SMS Ως συνεργάτης White-Label, προσφέρετε μια ολοκληρωμένη εμπειρία με τη δική σας εταιρική ταυτότητα: - **Προσαρμοσμένο Domain (Custom Domain)**: Η εφαρμογή, η τεκμηρίωση και το API λειτουργούν κάτω από το δικό σας domain name. - **Εταιρικό Λογότυπο & Επωνυμία**: Το περιβάλλον χρήστη προβάλλει το δικό σας λογότυπο και τα στοιχεία της επιχείρησής σας. - **Αυτοματοποιημένα Emails**: Όλες οι ειδοποιήσεις συστήματος, οι προσκλήσεις και τα μηνύματα επιβεβαίωσης αποστέλλονται με τη δική σας επωνυμία και στην προτιμώμενη γλώσσα κάθε παραλήπτη. - **Υποστηριζόμενες Γλώσσες ανά Brand**: Κάθε White-Label εγκατάσταση μπορεί να διαθέτει τις υποστηριζόμενες γλώσσες της πλατφόρμας (**Ελληνικά**, **Αγγλικά**, **Ολλανδικά**), τις οποίες οι χρήστες επιλέγουν μέσα από τις **Προτιμήσεις** τους (`/preferences`). --- ## Διασύνδεση Τρόπων Πληρωμής Για να δέχεστε πληρωμές απευθείας από τους πελάτες σας (τόσο online με κάρτα όσο και μέσω τραπεζικής κατάθεσης), ρυθμίστε τις μεθόδους είσπραξης από το μενού **`Προχωρημένες Ενέργειες`**: #### Λογαριασμοί Stripe Μεταβείτε στο **Προχωρημένες Ενέργειες -> Λογαριασμοί Stripe** για να συνδέσετε τον δικό σας λογαριασμό Stripe. Έτσι, οι online αγορές μονάδων με κάρτα των πελατών σας εκκαθαρίζονται απευθείας στον λογαριασμό σας. #### Τραπεζικοί Λογαριασμοί Μεταβείτε στο **Προχωρημένες Ενέργειες -> Τραπεζικοί Λογαριασμοί** για να καταχωρήσετε τους τραπεζικούς λογαριασμούς (IBAN) της επιχείρησής σας που θα εμφανίζονται στους πελάτες σας κατά την **Τραπεζική Κατάθεση**. --- ## Διαχείριση των Στοιχείων του Brand σας (`Ρυθμίσεις -> Brand`) Ως **Ιδιοκτήτης Brand**, μπορείτε να προβάλλετε και να ενημερώνετε τα στοιχεία του brand σας ανά πάσα στιγμή από το μενού **Προχωρημένες Ενέργειες -> Ρυθμίσεις -> Brand**: - **Domains**: - **URL Ιστοσελίδας**, **URL Τεκμηρίωσης Προγραμματιστών**, **URL Τεκμηρίωσης SDKs** και **URL Τεκμηρίωσης Εφαρμογής**. - **URL Σελίδας Facebook**, **URL Σελίδας X** και **URL Σελίδας LinkedIn**. - Τα πεδία **Host Header** και **Email Αποστολέα Επικοινωνίας** εμφανίζονται **μόνο για ανάγνωση** (διαχειρίζονται σε επίπεδο υποδομής πλατφόρμας). - **Ονόματα**: - **Όνομα Εφαρμογής**: Η πλήρης επωνυμία του brand σας που εμφανίζεται στο περιβάλλον της εφαρμογής, στους τίτλους σελίδων και στα εξερχόμενα emails. - **Σύντομο Όνομα**: Έως 5 χαρακτήρες που εμφανίζονται όταν η αριστερή πλευρική στήλη είναι συμπτυγμένη. - **Επικοινωνία**: - **Λογότυπο Σύνδεσης**: Μεταφορτώστε ή αντικαταστήστε την εικόνα λογοτύπου που εμφανίζεται στις σελίδες εισόδου. - **Ετικέτα Αποστολέα SMS**: Το προεπιλεγμένο αλφαριθμητικό αναγνωριστικό αποστολέα του brand σας (έως 11 χαρακτήρες· δεν επιτρέπεται αριθμός κινητού). - **Επαφές**: - **Έδρα**, **Τηλέφωνο Επικοινωνίας** και **Όνομα CEO**. - **Άλλα**: - **Μέγιστος Αριθμός Μονάδων Με Πίστωση**: Ο προκαθορισμένος αριθμός μονάδων που πιστώνεται άμεσα σε έναν δικαιούχο πελάτη του brand σας όταν χρησιμοποιεί την επιλογή **Αγορά με Πίστωση** (ορίστε `0` για να απενεργοποιήσετε την αγορά με πίστωση). - **Online Αγορά**: Ενεργοποιήστε ή απενεργοποιήστε την online αγορά μονάδων για τους πελάτες του brand σας. - Τα πεδία **Δημιουργήθηκε Στις** και **Ενημερώθηκε Στις** προβάλλονται ενημερωτικά ως μη επεξεργάσιμα. Πατήστε **Αποθήκευση** και επιβεβαιώστε το μήνυμα επιβεβαίωσης για να εφαρμοστούν άμεσα οι αλλαγές σας. --- ## Ορισμός Τιμοκαταλόγων του Brand σας (`Προχωρημένες Ενέργειες -> Τιμοκατάλογοι`) Ως **Ιδιοκτήτης Brand**, μπορείτε να ορίζετε και να διαχειρίζεστε την τιμολόγηση μονάδων SMS του brand σας μεταβαίνοντας στο μενού **Προχωρημένες Ενέργειες -> Τιμοκατάλογοι** (`/price_lists`): - **Προβολή Τιμοκαταλόγων**: Όλοι οι τιμοκατάλογοι του brand σας εμφανίζονται σε αύξουσα σειρά ως προς το **Πλήθος Μονάδων** (`ID`, `Πλήθος Μονάδων`, `Τιμή`, `Χρέωση ΦΠΑ`, `Ποσοστό ΦΠΑ`, `Δημιουργήθηκε Στις` και `Ενημερώθηκε Στις`). Η εγγραφή με `number_of_credits = -1` αφορά οποιαδήποτε ποσότητα μονάδων και προβάλλεται ως **Οποιοδήποτε**. - **Δημιουργία Τιμοκαταλόγου**: Πατήστε **Νέος Τιμοκατάλογος** (`/price_lists/new`) επάνω δεξιά στον πίνακα, συμπληρώστε τα πεδία και πατήστε **Δημιουργία** (επιβεβαιώνοντας το σχετικό μήνυμα): - **Πλήθος Μονάδων**: Το μέγεθος του πακέτου μονάδων (χρησιμοποιήστε `-1` για οποιοδήποτε πλήθος μονάδων). - **Τιμή**: Η τιμή ανά μονάδα **χωρίς ΦΠΑ**. Αν είναι επιλεγμένο το **Χρέωση ΦΠΑ**, ο ΦΠΑ υπολογίζεται και προστίθεται επιπλέον αυτής της τιμής. - **Χρέωση ΦΠΑ**: Επιλέξτε το αν πρέπει να χρεώνεται ΦΠΑ επιπλέον της τιμής ανά μονάδα. - **Ποσοστό ΦΠΑ**: Ο ακέραιος συντελεστής ΦΠΑ (`0`–`100`). - **Επεξεργασία ή Διαγραφή Τιμοκαταλόγου**: Κάντε κλικ σε οποιαδήποτε γραμμή του πίνακα τιμοκαταλόγων για να ανοίξετε τη σελίδα επεξεργασίας (`/price_lists/:id/edit`), όπου μπορείτε: - Να ενημερώσετε τα πεδία και να πατήσετε **Αποθήκευση** (με επιβεβαίωση) για να αποθηκεύσετε τις αλλαγές σας. - Να πατήσετε **Διαγραφή** (με επιβεβαίωση) για να διαγράψετε τον τιμοκατάλογο από το brand σας. --- ## Διαχείριση Πελατών μέσω του Μενού `Διαχείριση` Όλες οι καθημερινές εργασίες διαχείρισης του πελατολογίου σας συγκεντρώνονται στο ειδικό μενού **`Διαχείριση`**: #### 1. Χρήστες ### `Χρήστες` (Διαχείριση Λογαριασμών Πελατών) Στην ενότητα **Διαχείριση -> Χρήστες** έχετε πλήρη εποπτεία και έλεγχο σε κάθε εγγεγραμμένο πελάτη της πλατφόρμας σας: - **Ενεργοποίηση & Απενεργοποίηση Χρηστών**: Ενεργοποιήστε ή αναστείλετε την πρόσβαση οποιουδήποτε λογαριασμού πελάτη. - **Παρακολούθηση Υπολοίπων**: Δείτε σε πραγματικό χρόνο το διαθέσιμο υπόλοιπο μονάδων κάθε χρήστη. - **Δικαίωμα Αγοράς με Πίστωση (`Allowed To Purchase With Credit`)**: Ενεργοποιήστε την επιλογή **`Allowed To Purchase With Credit`** σε αξιόπιστους εταιρικούς πελάτες, ώστε να μπορούν να παραγγέλνουν μονάδες με πίστωση και να λαμβάνουν τις μονάδες τους αμέσως πριν την τραπεζική εξόφληση. - **Ημερήσιες Αναφορές (Daily Reports)**: Ρυθμίστε την αποστολή ημερήσιων αναφορών κίνησης και κατανάλωσης. - **Απαίτηση Στοιχείων Εταιρείας**: Ελέγξτε ή διαμορφώστε την απαίτηση συμπλήρωσης επιβεβαιωμένων φορολογικών στοιχείων ανά χρήστη. #### 2. Παραγγελίες Χρηστών ### `Παραγγελίες Χρηστών` (Καταχώρηση & Επικύρωση Πωλήσεων) Στην ενότητα **Διαχείριση -> Παραγγελίες Χρηστών** διαχειρίζεστε όλες τις αγορές μονάδων των πελατών σας: - **Καταχώρηση Παραγγελιών Τραπεζικής Κατάθεσης**: Όταν ένας πελάτης εξοφλεί μέσω τραπεζικής κατάθεσης, καταχωρείτε την παραγγελία του ώστε να πιστωθούν οι μονάδες στον λογαριασμό του. - **Επικύρωση Παραγγελιών με Πίστωση (`Επιβεβαίωσε`)**: Παρακολουθείτε τις εκκρεμείς παραγγελίες που έγιναν με πίστωση και, μόλις επιβεβαιώσετε την τραπεζική εξόφληση, τις επικυρώνετε ώστε ο πελάτης να μπορεί να πραγματοποιήσει και επόμενη αγορά με πίστωση. #### 3. Στοιχεία Εταιρείας Χρηστών ### `Στοιχεία Εταιρείας Χρηστών` (Έλεγχος & Επιβεβαίωση Τιμολόγησης) Στην ενότητα **Διαχείριση -> Στοιχεία Εταιρείας Χρηστών** ελέγχετε τα φορολογικά και εταιρικά στοιχεία που υποβάλλουν οι πελάτες σας: - **Έλεγχος & Επιβεβαίωση**: Εξετάστε την επωνυμία, το ΑΦΜ, τη ΔΟΥ και τη διεύθυνση έδρας κάθε πελάτη και επιβεβαιώστε την εγκυρότητά τους για την ορθή τιμολόγηση και τον υπολογισμό ΦΠΑ. --- ## Σχετικοί Οδηγοί - [Αγορά Μονάδων & Τρόποι Πληρωμής](https://docs.rayosms.nl/el/billing/purchasing-credits): Δείτε πώς βλέπουν οι τελικοί πελάτες τη διαδικασία αγοράς μονάδων. - [Στοιχεία Εταιρείας & Τιμολόγησης](https://docs.rayosms.nl/el/getting-started/company-details): Πώς οι χρήστες καταχωρούν και ενημερώνουν τα φορολογικά τους στοιχεία. --- ## Ενότητα: Υποστήριξη & Επίλυση Προβλημάτων (Support & FAQ — Greek) ### Συχνές Ερωτήσεις (FAQ) & Υποστήριξη Source: https://docs.rayosms.nl/el/support/faq-and-contact/ Description: Απαντήσεις σε συχνές ερωτήσεις (λογαριασμός, στοιχεία εταιρείας, ελληνικοί χαρακτήρες 160 χαρακτήρων, Sender IDs, χρεώσεις) και κανάλια επικοινωνίας 24/7. Βρείτε γρήγορες απαντήσεις στα πιο συχνά ερωτήματα σχετικά με τη λειτουργία του [Rayo SMS](https://sms.rayosms.nl) ή επικοινωνήστε απευθείας με την ομάδα υποστήριξής μας. --- ## Συχνές Ερωτήσεις (FAQ) & Επίλυση Προβλημάτων ### Λογαριασμός & Στοιχεία Εταιρείας #### Γιατί πρέπει να συμπληρώσω τα Στοιχεία Εταιρείας μου; Η συμπλήρωση και επιβεβαίωση των φορολογικών στοιχείων στην ενότητα **Στοιχεία Εταιρείας** είναι απαραίτητη για τον αυτόματο υπολογισμό του ΦΠΑ, την ενεργοποίηση των αγορών μονάδων και την αυτόματη έκδοση των νόμιμων τιμολογίων σας. Δείτε αναλυτικά τον οδηγό [Στοιχεία Εταιρείας & Τιμολόγησης](https://docs.rayosms.nl/el/getting-started/company-details/). #### Μπορώ να δώσω πρόσβαση στον προγραμματιστή μου χωρίς να βλέπει τις επαφές και τα τιμολόγιά μου; Ναι. Μέσα από το μενού **Προχωρημένες Ενέργειες -> Προσκλήσεις Μελών**, μπορείτε να προσκαλέσετε τον τεχνικό σας με τον ρόλο **`developer`**. Ο ρόλος αυτός παρέχει πρόσβαση μόνο στις τεχνικές **Ρυθμίσεις** (`Κλειδιά API`, `Callbacks`) και στις προσωπικές του **Προτιμήσεις** (`/preferences`) χωρίς καμία πρόσβαση σε επαφές, καμπάνιες ή οικονομικά στοιχεία. #### Πώς μπορώ να αλλάξω τη γλώσσα της εφαρμογής και των ενημερωτικών emails που λαμβάνω; Κάντε κλικ στο **όνομα χρήστη (email)** σας επάνω αριστερά στην πλευρική στήλη, επιλέξτε **Προτιμήσεις** (`/preferences`), διαλέξτε την επιθυμητή **Γλώσσα** (**Ελληνικά**, **Αγγλικά** ή **Ολλανδικά**) στην ενότητα **Προτίμηση Γλώσσας** και πατήστε **Αποθήκευση**. Η επιλογή σας εφαρμόζεται αμέσως στο περιβάλλον εργασίας, διατηρείται στις επόμενες συνδέσεις σας και καθορίζει τη γλώσσα όλων των αυτοματοποιημένων emails που σας αποστέλλει η πλατφόρμα. Δείτε περισσότερα στον οδηγό [Δημιουργία & Πρόσβαση στον Λογαριασμό](https://docs.rayosms.nl/el/getting-started/account-and-login#προτιμήσεις-χρήστη--προτίμηση-γλώσσας-preferences). --- ### Μήκος SMS & Μετατροπή Ελληνικών σε 160 Χαρακτήρες #### Πώς μπορώ να στέλνω SMS 160 χαρακτήρων στα Ελληνικά χωρίς διπλή χρέωση; Στο πρότυπο GSM 7-bit, ένα απλό SMS χωράει έως **160 χαρακτήρες**. Αν χρησιμοποιηθούν πεζοί ελληνικοί χαρακτήρες με τόνους (Unicode / UCS-2), το όριο ανά SMS μειώνεται στους **70 χαρακτήρες**. Το Rayo SMS επιλύει αυτό το πρόβλημα μετατρέποντας αυτόματα το ελληνικό κείμενο σε κεφαλαία συμβατά με το αλφάβητο GSM, ώστε να απολαμβάνετε **πλήρες μήκος 160 χαρακτήρων ανά SMS** στα Ελληνικά. Δείτε περισσότερα στον οδηγό [Όρια Χαρακτήρων & Κωδικοποίηση](https://docs.rayosms.nl/el/messaging/length-and-encoding/). #### Πόσους παραλήπτες μπορώ να προσθέσω σε μία αποστολή; Στο πεδίο χειροκίνητης εισαγωγής αριθμών μπορείτε να επικολλήσετε έως **500 αριθμούς κινητών** ανά αποστολή. Για αποστολή σε **περισσότερους από 500 αριθμούς**, δημιουργήστε μια ομάδα στην ενότητα [Ομάδες Επαφών & Μαζική Εισαγωγή](https://docs.rayosms.nl/el/contacts-and-groups/groups/) και επιλέξτε την κατά την αποστολή. #### Γιατί δεν αποστέλλεται το ίδιο μήνυμα στον ίδιο αριθμό κινητού για δεύτερη φορά; Για την προστασία σας από άσκοπες διπλές χρεώσεις και ενοχλητικές διπλοαποστολές, το Rayo SMS δεν επιτρέπει την αποστολή **του ίδιου ακριβώς κειμένου SMS** στον **ίδιο αριθμό κινητού** μέσα σε **διάστημα 6 ωρών** (`has already been sent this message within the last 6 hours`). Αν χρειάζεται να στείλετε νέο μήνυμα στον ίδιο αριθμό εντός 6 ωρών, διαφοροποιήστε το κείμενο του μηνύματος. --- ### Αναγνωριστικά Αποστολέα (Sender IDs) #### Γιατί δεν μπορώ να προσθέσω δεύτερο αριθμό κινητού ως Αναγνωριστικό Αποστολέα; Το σύστημα επιτρέπει **μόνο ένα (1)** κινητό αναγνωριστικό αποστολέα να βρίσκεται **σε κατάσταση αναμονής επιβεβαίωσης** κάθε φορά. Ολοκληρώστε την επιβεβαίωση με τον **5-ψήφιο κωδικό** SMS (εντός **15 λεπτών**) ή διαγράψτε το εκκρεμές αναγνωριστικό πριν καταχωρήσετε νέο αριθμό κινητού. #### Γιατί εμφανίζεται το μήνυμα «Δεν μπορεί να διαγραφεί. Έχει χρησιμοποιηθεί στο παρελθόν για αποστολή μηνύματος.»; Για να διατηρείται ακέραιο το ιστορικό των απεσταλμένων μηνυμάτων και των αναφορών παράδοσης, όσα αναγνωριστικά αποστολέα έχουν χρησιμοποιηθεί έστω και μία φορά δεν μπορούν να διαγραφούν οριστικά. Μπορείτε όμως να πατήσετε **`Απενεργοποίηση`** ώστε να μην εμφανίζονται πλέον στις επιλογές αποστολής. Δείτε τον οδηγό [Διαχείριση Αναγνωριστικών Αποστολέα](https://docs.rayosms.nl/el/sender-ids/managing-sender-ids/). --- ### Μονάδες, Πληρωμές & Ισχύς Υπολοίπου #### Γιατί στην Αγορά με Κάρτα λαμβάνω ελαφρώς λιγότερες μονάδες; Όπως αναφέρεται στη σελίδα αγοράς: **`Η αγορά μονάδων με χρήση κάρτας επιφέρει επιπλέον χρέωση η οποία επιβάλλεται με τη μορφή μειωμένων μονάδων`**. Ο ακριβής αριθμός των καθαρών μονάδων εμφανίζεται πριν την πληρωμή. Εάν θέλετε μηδενικές προμήθειες διεκπεραίωσης, επιλέξτε **Τραπεζική Κατάθεση**. #### Πότε λήγουν οι μονάδες που έχω αγοράσει; Οι προπληρωμένες μονάδες έχουν διάρκεια ισχύος **1 έτους (365 ημερών)** από την ημερομηνία αγοράς τους (**`θα πρέπει να καταναλώσετε μέσα σε 1 χρόνο τις μονάδες που έχετε αγοράσει`**). --- ## Επικοινωνία & Υποστήριξη 24/7 Η ομάδα υποστήριξης του Rayo SMS βρίσκεται δίπλα σας για οποιοδήποτε τεχνικό ή εμπορικό ζήτημα: #### Φόρμα Επικοινωνίας εντός Εφαρμογής Συνδεθείτε στον λογαριασμό σας και επιλέξτε **`Επικοινωνία`** από το μενού πλοήγησης για να στείλετε άμεσα το αίτημά σας ή το αποδεικτικό τραπεζικής κατάθεσης. #### Δημόσια Φόρμα Επικοινωνίας Ακόμη και αν δεν έχετε συνδεθεί, μπορείτε να μας στείλετε μήνυμα μέσω της σελίδας [Φόρμα Επικοινωνίας](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us). #### 24/7 Live Chat Χρησιμοποιήστε το **24/7 live chat** που είναι διαθέσιμο στην ιστοσελίδα και στην εφαρμογή μας για άμεση συνομιλία με εκπρόσωπο υποστήριξης. #### Όροι Χρήσης Υπηρεσίας Συμβουλευτείτε ανά πάσα στιγμή τους επίσημους [Όροι και Προϋποθέσεις Παροχής Υπηρεσιών](https://sms.rayosms.nl/set_locale?locale=el&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fterms_and_conditions_of_service). --- # Part 3: Nederlandse Documentatie / Dutch Documentation (`/nl/`) ## Sectie: Aan de slag (Getting Started — Dutch) ### Platformoverzicht Source: https://docs.rayosms.nl/nl/getting-started/overview/ Description: Ontdek wat Rayo SMS biedt, hoe de belangrijkste onderdelen samenwerken en hoe u door de webapplicatie navigeert. **Rayo SMS** is een compleet Web-to-SMS Software-as-a-Service (SaaS) platform dat is ontworpen voor bedrijven, ontwikkelaars en white-label wederverkopers. Of u nu promotionele bulkcampagnes vanuit uw browser wilt verzenden of tijdgevoelige transactionele meldingen vanuit uw backendsystemen wilt activeren: Rayo SMS biedt een betrouwbare workflow waarin privacy centraal staat. ## Kernfunctionaliteiten #### Bulkmarketing-sms Organiseer ontvangers in **Groepen** en verstuur gerichte campagnes naar duizenden nummers tegelijk. Dubbele mobiele nummers binnen geselecteerde groepen ontvangen het bericht automatisch slechts één keer, en contacten die zijn gemarkeerd als **Ongeldig** worden automatisch overgeslagen. #### Transactionele & geplande sms Verstuur directe orderbevestigingen, afspraakherinneringen en eenmalige wachtwoorden (OTP's), of plan berichten in voor toekomstige bezorging met volledig inzicht en annuleringsmogelijkheden. #### AVG/GDPR-bestendige berichtmaskering Bescherm gevoelige klantgegevens door verzonden berichtinhoud permanent te vervangen door `******`, op aanvraag, onmiddellijk na verwerking of automatisch na een instelbaar aantal minuten. #### Ontwikkelaars-API & webhooks Integreer sms-functionaliteit in elke applicatie via de HTTP API (`https://api.rayosms.nl/v1`), beheer tot 25 onafhankelijke API-sleutels, test kosteloos met de simulatiemodus en ontvang ondertekende aflever-webhooks. #### Teamsamenwerking Nodig ontwikkelaars uit in uw account met specifieke, op rollen gebaseerde rechten, zodat zij API-sleutels en webhook-callbacks kunnen beheren zonder toegang tot facturering of marketingcampagnes. #### White-Label SaaS Start en exploiteer uw eigen sms-platform onder uw eigen domeinnaam en logo, koppel uw eigen Stripe- en bankrekeningen en beheer uw eigen klantenbestand. --- ## Navigeren door de Rayo SMS-webapplicatie Wanneer u inlogt op de Rayo SMS-webapplicatie ([sms.rayosms.nl](https://sms.rayosms.nl)), is de interface onderverdeeld in drie primaire navigatiegebieden: ### 1. Linkerzijbalkmenu (Dagelijkse werkzaamheden) Beschikbaar voor de accounteigenaar voor dagelijkse berichtverzending en contactbeheer: | Menu-item | Doel | | :--- | :--- | | **Hoofdpagina** | Dashboardoverzicht en startpunt. | | **Bericht versturen** | Stel individuele en bulk-sms-berichten op, bekijk live teken- en creditberekeningen, plan berichten in of voer een simulatie uit. | | **Verzonden** | Doorzoekbare verzendgeschiedenis met realtime statusfilters (`Nieuw`, `Verzonden`, `Afgeleverd`, `Niet afgeleverd`, `Verwerkingsfout`) en handmatige berichtmaskering. | | **Planningen** | Bekijk, filter, inspecteer of annuleer geplande toekomstige sms-zendingen. | | **Groepen** | Maak ontvangersgroepen aan en voeg leden individueel of via bulkimport regel voor regel toe. | | **Contacten** | Doorzoek en beheer uw adresboek, referentienummers en onderdrukkingsvlaggen voor ongeldige nummers. | | **Afzender-id's** | Registreer en beheer alfanumerieke afzendernamen (tot 11 tekens) en via sms geverifieerde mobiele nummers. | | **Credits** | Bekijk uw creditsaldo, koop credits (kaart, bankstorting of op krediet) en raadpleeg uw bestelgeschiedenis. | | **Contact** | Stuur rechtstreeks een ondersteuningsverzoek naar het Rayo SMS-team. | ### 2. Bovenste navigatiebalk (Menu `Geavanceerd`) Klik op **Geavanceerd** in de bovenste navigatiebalk voor toegang tot accountconfiguratie, teambeheer en ontwikkelaarsinstellingen: - **Instellingen**: - **API-sleutels**: Genereer, activeer, deactiveer of verwijder tot 25 API-sleutels. - **Callbacks**: Configureer uw webhook-URL, HTTP-methode (`GET`/`POST`), test de verbinding en beheer of roteer uw **Signing Secret** (ondertekeningsgeheim). - **Berichten maskeren**: Configureer onmiddellijke of vertraagde automatische permanente berichtmaskering. - **Ontvangers van meldingen bij laag creditsaldo**: Registreer tot 2 mobiele nummers om sms-waarschuwingen te ontvangen wanneer uw creditsaldo onder uw daggemiddelde van de afgelopen 30 dagen zakt. - **Merk** *(alleen voor merkeigenaren)*: Bekijk en wijzig uw merkgegevens (website-, documentatie- en socialmedia-URL's, applicatienaam en korte naam, inloglogo, standaard sms-afzenderlabel en contactgegevens). - **Stripe-accounts** *(alleen voor White-Label merkeigenaren)*: Koppel en activeer uw Stripe-account om kaartbetalingen van klanten te ontvangen. - **Bankrekeningen**: Beheer IBAN-bankrekeningen. - **Prijslijsten** *(alleen voor merkeigenaren)*: Definieer en beheer de prijslijsten voor sms-credits van uw merk. - **Bedrijfsgegevens**: Dien uw geverifieerde bedrijfs- en belastingprofiel in en bekijk deze voor facturering en naleving. - **Leden**: Bekijk en beheer teamleden die toegang hebben tot uw account. - **Lid-uitnodigingen**: Verstuur uitnodigingen naar teamleden en bekijk uitnodigingen die u van andere accounts heeft ontvangen. - **Ontwikkelaars**: Opent de [Interactieve API-referentie](https://api-docs.rayosms.nl) in een nieuw tabblad. - **Algemene voorwaarden van de dienst**: Bekijk of download de algemene voorwaarden van het platform. ### 3. Gebruikersprofielmenu & saldo-indicator - **Gebruikersprofielmenu** (linksboven in de zijbalk): Toont de gebruikersnaam van uw actieve account. Klik op uw gebruikersnaam om het menu te openen: - **Voorkeuren** (`/preferences`): Beheer uw gebruikersvoorkeuren, waaronder uw **Taalvoorkeur** (**Engels**, **Grieks** of **Nederlands**), die zowel de taal van de webinterface als de taal van systeem-e-mails bepaalt die naar u worden verzonden. - **Wissel van account**: Als u lid bent van andere Rayo SMS-accounts, kunt u van actieve werkruimte wisselen zonder uit te loggen. - **Uitloggen**: Log uit bij uw huidige sessie. - **Resterende credits-badge** (groene badge rechtsboven): Toont uw realtime sms-creditsaldo en linkt rechtstreeks naar de pagina **Credits**. > **TIP: Klaar om te beginnen?** > Volg de [Snelstartgids](https://docs.rayosms.nl/nl/getting-started/quick-start/) om uw account in te stellen en binnen 5 minuten uw eerste sms te versturen. --- ### Uw account aanmaken en openen Source: https://docs.rayosms.nl/nl/getting-started/account-and-login/ Description: Hoe u zich registreert voor Rayo SMS, uw e-mailadres bevestigt, uw standaardland voor verzending instelt, inlogt, uw wachtwoord opnieuw instelt en uw taalvoorkeur wijzigt. Deze handleiding begeleidt u bij het registreren van een nieuw Rayo SMS-account, legt uit hoe uw **Standaardland voor verzending** de opmaak van telefoonnummers beïnvloedt, en laat zien hoe u inlogt en uw inloggegevens beheert. ## Een nieuw account aanmaken 1. **Open de registratiepagina** Ga naar de [Rayo SMS-registratiepagina](https://sms.rayosms.nl/set_locale?locale=nl&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsign_ups%2Fnew) (of klik op **Account aanmaken** op het inlogscherm). 2. **Vul uw accountgegevens in** Vul de volgende gegevens in op het registratieformulier: - **Uw e-mailadres**: Uw e-mailadres dient als uw **Gebruikersnaam** om in te loggen en als primair contactadres voor facturen, beveiligingsmeldingen en systeemmeldingen. - **Uw wachtwoord**: Kies een sterk wachtwoord (maximaal **72 tekens**). - **Herhaal hier uw wachtwoord**: Voer uw wachtwoord nogmaals in ter bevestiging. - **Standaardland voor verzending**: Selecteer het primaire land waarnaar u de meeste sms-berichten verstuurt (bijvoorbeeld `Nederland`, `Griekenland`, `Cyprus`, `Verenigd Koninkrijk`, `Duitsland`, `Bulgarije`, `Roemenië`, `België` of `Ierland`). 3. **Verstuur en bevestig uw e-mailadres** Klik op **Registreren**. U wordt doorgestuurd naar een bevestigingspagina (`Bedankt voor uw registratie!`) en Rayo SMS stuurt een e-mail met een activatielink naar uw postvak IN (in de taal die was geselecteerd toen u het registratieformulier indiende). Klik op de bevestigingslink in die e-mail om uw account te activeren — uw gekozen taal wordt automatisch opgeslagen als de **Taalvoorkeur** van uw account. --- ## "Standaardland voor verzending" begrijpen Tijdens de registratie selecteert u een **Standaardland voor verzending**. Deze instelling bepaalt hoe Rayo SMS mobiele nummers van ontvangers normaliseert wanneer er geen landcode is opgegeven: - **Nummers met een expliciete landcode**: Als u een sms stuurt naar een nummer dat begint met een ondersteunde internationale landcode (met of zonder voorloop-`+`, zoals `+306972669767` of `306972669767` voor Griekenland, of `+357...` voor Cyprus), stuurt Rayo SMS het bericht naar dat specifieke land. - **Lokale nummers zonder landcode**: Als een mobiel nummer **niet** begint met een ondersteunde landcode, voegt Rayo SMS automatisch de landcode van uw **Standaardland voor verzending** toe. > **NOTE: Voorbeeld: Normalisatie met standaardlandcode** > Als uw **Standaardland voor verzending** is ingesteld op **Griekenland** (landcode `30`) en u voert `6972669767` in als ontvanger, dan normaliseert en verzendt Rayo SMS het bericht automatisch naar **`306972669767`**. --- ## Inloggen en uitloggen - **Inloggen**: Ga naar de [Inlogpagina](https://sms.rayosms.nl/set_locale?locale=nl&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsessions%2Fnew), voer uw **Gebruikersnaam of e-mailadres** en **Wachtwoord** in en klik op **Inloggen**. - Bij het inloggen past Rayo SMS automatisch uw opgeslagen **Taalvoorkeur** toe op uw sessie (of slaat de actieve taal van het inlogscherm op als er nog geen voorkeur was ingesteld). - Als er voor uw account **openstaande teamuitnodigingen** van een andere accounteigenaar zijn, wordt u bij het inloggen gevraagd deze te **Accepteren** of te **Weigeren**. - **Uitloggen**: Klik op **Uitloggen** rechtsboven in de navigatiebalk (of open het profielmenu linksboven in de zijbalk en klik op **Uitloggen**). --- ## Een vergeten wachtwoord opnieuw instellen Als u uw wachtwoord bent vergeten, kunt u het op elk moment opnieuw instellen: 1. Klik op de [Inlogpagina](https://sms.rayosms.nl/set_locale?locale=nl&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsessions%2Fnew) op **Bent u uw wachtwoord vergeten? Klik hier en volg de betreffende procedure**. 2. Voer het e-mailadres in dat aan uw account is gekoppeld en klik op **Verzoek versturen**. 3. Controleer uw e-mail voor de instructies om uw wachtwoord opnieuw in te stellen en klik op de unieke tokenlink in het bericht. 4. Voer uw **Nieuw wachtwoord** en **Bevestiging nieuw wachtwoord** in (maximaal 72 tekens) en klik vervolgens op **Opnieuw instellen**. 5. Log in met uw nieuwe wachtwoord. > **CAUTION: Verlopen herstellinks** > Links voor het opnieuw instellen van wachtwoorden zijn voor uw veiligheid beperkt geldig. Als u de melding *"Uw wachtwoord is niet gewijzigd. Mogelijk is uw verzoek om het wachtwoord opnieuw in te stellen verlopen"* ziet, dient u eenvoudig een nieuw verzoek in via het inlogscherm. --- ## Gebruikersvoorkeuren & taalvoorkeur (`/preferences`) De Rayo SMS-webapplicatie en e-mailmeldingen ondersteunen **Engels (`en`)**, **Grieks (`el`)** en **Nederlands (`nl`)** (afhankelijk van de talen die voor het merk zijn ingeschakeld). ### Uw taalvoorkeur wijzigen terwijl u bent ingelogd U kunt uw voorkeurstaal op elk moment wijzigen via uw gebruikersprofielmenu zonder uit te loggen: 1. Klik op uw **gebruikersnaam** linksboven in de linkerzijbalk om het profielmenu te openen. 2. Selecteer **Voorkeuren** (`/preferences`). 3. Kies onder **Taalvoorkeur** uw gewenste **Taal** (**Engels**, **Grieks** of **Nederlands**). 4. Klik op **Opslaan**. U ziet het bevestigingsbericht *"De voorkeuren zijn bijgewerkt!"* en de interface schakelt onmiddellijk over naar de door u geselecteerde taal. ### Hoe uw taalvoorkeur werkt - **Openbare authenticatieschermen**: Op de pagina's Inloggen, Registreren en Wachtwoord opnieuw instellen kunt u de actieve taal wisselen met de vlagpictogrammen (**Grieks**, **Engels**, **Nederlands**) bovenaan het formulier. - **Automatisch behoud bij registratie en inloggen**: - Wanneer u een nieuw account registreert, wordt de taal die actief is op de registratiepagina opgeslagen bij uw aanmelding en wordt deze automatisch uw **Taalvoorkeur** zodra u uw e-mailadres bevestigt. - Wanneer u inlogt, herstelt Rayo SMS automatisch uw opgeslagen **Taalvoorkeur** voor uw sessie. Als uw account nog geen opgeslagen voorkeur had, wordt de taal die actief was op de inlogpagina opgeslagen als uw voorkeur. - **Gelokaliseerde e-mailmeldingen**: Alle uitgaande systeem- en account-e-mails die door Rayo SMS naar u worden verzonden — waaronder e-mailbevestiging, welkomstberichten, links voor wachtwoordherstel, betalings- en terugbetalingsbewijzen voor credits, dagelijkse rapporten, maandelijkse afleverexporten, bevestigingen van berichtmaskering, updates van bedrijfsgegevens en uitnodigingen voor teamleden — worden automatisch geleverd in uw voorkeurstaal. - **Persoonlijke gebruikersinstelling**: Uw taalvoorkeur hoort bij uw individuele gebruikersprofiel, zodat zowel **Accounteigenaren** als **`developer`**-teamleden onafhankelijk hun eigen voorkeurstaal kunnen instellen. --- ### Bedrijfs- en belastinggegevens Source: https://docs.rayosms.nl/nl/getting-started/company-details/ Description: Hoe u uw bedrijfs- en belastinggegevens indient en laat verifiëren in Rayo SMS om live sms-verzending en automatische facturering te activeren. Voordat u live sms-berichten kunt verzenden via het Rayo SMS-platform, moet u uw **Bedrijfsgegevens** indienen ter verificatie. ## Waarom bedrijfsgegevens vereist zijn Rayo SMS gebruikt uw geverifieerde bedrijfsprofiel voor twee essentiële doeleinden: 1. **Platformnaleving en misbruikpreventie**: Het beoordelen van uw legitimiteit als bedrijf dat gemachtigd is om commerciële en transactionele sms-berichten te verzenden. 2. **Geautomatiseerde facturering**: Het opstellen van officiële belastingfacturen voor elke creditaankoop die u op het platform doet. > **CAUTION: Vereist vóór het verzenden van live sms-berichten** > Totdat uw bedrijfsgegevens zijn ingediend en bevestigd, verschijnt bij een poging om een sms te verzenden de melding: > *"U moet uw bedrijfsgegevens opgeven voordat u berichten kunt verzenden"* of *"Uw bedrijfsgegevens worden beoordeeld."* --- ## Uw bedrijfsgegevens indienen 1. **Open de pagina Bedrijfsgegevens** Klik in de bovenste navigatiebalk op **Geavanceerd** → **Bedrijfsgegevens** (`/company_details`). 2. **Vul uw bedrijfs- en belastingprofiel in** Vul de verplichte velden nauwkeurig in: | Veld | Beschrijving | | :--- | :--- | | **Officiële bedrijfsnaam** | Uw geregistreerde handelsnaam of officiële naam van uw eenmanszaak/rechtspersoon. | | **Beroep** | Beschrijving van uw primaire bedrijfsactiviteit of beroep. | | **Btw-nummer** | Uw fiscaal identificatienummer / btw-registratienummer. | | **Belastingkantoor** | Uw lokale belastingkantoor (indien van toepassing volgens de lokale belastingwetgeving). | | **Adres** | Geregistreerd straatadres en huisnummer. | | **Plaats** | Stad of gemeente. | | **Postcode** | Postcode. | | **Land** | Land van vestiging. | | **Website-URL** | De URL van uw bedrijfswebsite (bijv. `https://www.example.com`). | 3. **Controleren en versturen** Klik op **Versturen** (of **Opslaan**) en bevestig het dialoogvenster. Controleer goed of uw btw-nummer en officiële bedrijfsnaam exact kloppen voordat u bevestigt. --- ## Verificatiestatussen Na het indienen toont de pagina Bedrijfsgegevens de huidige verificatiestatus in de paginakop (`Bedrijfsgegevens [Status]`): - **In beoordeling**: Uw gegevens zijn verstuurd en ons complianceteam is op de hoogte gebracht. Beoordelingen worden doorgaans **binnen 24 uur** afgerond en u ontvangt een e-mailmelding zodra uw profiel is bijgewerkt. Zolang uw gegevens in beoordeling zijn, kunt u nog op **Bewerken** klikken om eventuele typefouten te corrigeren. - **Bevestigd**: Uw bedrijfsprofiel is goedgekeurd! U heeft nu volledige toegang tot het live verzenden van sms-berichten en het kopen van credits, en facturen worden automatisch aangemaakt op basis van deze gegevens. - **Afgewezen**: De ingediende gegevens konden niet worden geverifieerd. Controleer uw e-mail voor instructies of gebruik het **Contact**-formulier in de applicatie om contact op te nemen met de klantenservice. --- ## Bevestigde bedrijfsgegevens bijwerken Zodra uw bedrijfsgegevens de status **Bevestigd** hebben bereikt, worden ze vergrendeld tegen zelfbedieningswijzigingen om de fiscale en factureringsintegriteit te waarborgen (`Uw bedrijfsgegevens kunnen niet worden bewerkt`). Als uw bedrijf in de toekomst van officiële naam, adres, belastingkantoor of btw-nummer verandert, opent u eenvoudig de pagina **Contact** (`/contact_us_requests/new`) via de linkerzijbalk en stuurt u ons de gewijzigde gegevens — ons team werkt uw profiel dan voor u bij. --- ### Snelstart: Verstuur uw eerste sms in 5 minuten Source: https://docs.rayosms.nl/nl/getting-started/quick-start/ Description: Stapsgewijze checklist om vanaf een gloednieuw Rayo SMS-account uw eerste sms te versturen en de afleverstatus te controleren. Volg deze gids in 5 stappen om uw Rayo SMS-account in te stellen en uw eerste tekstbericht vanuit het webdashboard te verzenden. 1. **Maak uw account aan en bevestig uw e-mailadres** Registreer u op de [Registratiepagina](https://sms.rayosms.nl/set_locale?locale=nl&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fsign_ups%2Fnew), kies uw **Standaardland voor verzending** (bijv. `Griekenland` of `België`) en klik op de bevestigingslink die naar uw e-mailadres is verzonden. Zie [Uw account aanmaken en openen](https://docs.rayosms.nl/nl/getting-started/account-and-login/). 2. **Dien uw bedrijfsgegevens in** Ga naar **Geavanceerd** → **Bedrijfsgegevens** in de bovenste navigatiebalk, voer uw bedrijfs- en btw-gegevens in en klik op **Versturen**. Ons team beoordeelt inzendingen binnen 24 uur. Zie [Bedrijfs- en belastinggegevens](https://docs.rayosms.nl/nl/getting-started/company-details/). 3. **Maak een afzender-identificatie (Afzender-id) aan** Voordat u een sms kunt verzenden, heeft u ten minste één actieve en bevestigde **Afzender-identificatie** nodig: - Klik in de linkerzijbalk op **Afzender-id's** → **Nieuwe afzender-identificatie**. - **Optie A — Alfanumeriek label (Snelst)**: Voer uw merknaam in met maximaal **11 Latijnse tekens** (bijv. `MYBRAND` of `MY-SHOP`) en klik op **Aanmaken**. Alfanumerieke labels worden **onmiddellijk bevestigd**. - **Optie B — Mobiel nummer**: Voer uw mobiele nummer in (bijv. `306972669700`), klik op **Aanmaken** en vul binnen 15 minuten de **5-cijferige bevestigingscode** in die naar uw telefoon is gestuurd. Zie [Afzender-id's beheren](https://docs.rayosms.nl/nl/sender-ids/managing-sender-ids/). 4. **Waardeer credits op (of gebruik de simulatiemodus)** - Om een echte sms naar een mobiele telefoon te sturen, klikt u in de linkerzijbalk op **Credits** → **Credits bestellen** en koopt u credits via **Online aankoop met kaart**, **Bankstorting** of **Kopen op krediet**. - Om de workflow te testen zonder credits te verbruiken, kunt u in de volgende stap het selectievakje **Simulatie (bericht wordt niet verzonden)** inschakelen! 5. **Verstuur uw eerste sms & controleer de afleverstatus** - Klik op **Bericht versturen** in de linkerzijbalk (`/messages/new`). - Selecteer uw **Afzender-identificatie** in het keuzemenu. - Voer bij **Naar mobiele nummers** uw mobiele nummer in (bijv. `+306972669766` of `6972669766`). - Typ bij **Bericht** uw tekst en bekijk hoe de live tellers voor **Aantal tekens** en **Aantal credits** onder het tekstvak direct worden bijgewerkt. - Klik op **Bericht versturen** en bevestig het dialoogvenster. - Klik op **Verzonden** in de linkerzijbalk (`/messages`) om te zien hoe uw bericht overgaat van `Nieuw` → `Verzonden` → `Afgeleverd`! > **TIP: Liever integreren via de API?** > Bij uw registratie wordt automatisch een actieve API-sleutel voor uw account aangemaakt. Ga naar **Geavanceerd** → **Instellingen** → **API-sleutels** om uw sleutel te kopiëren en lees vervolgens [API-overzicht en API-sleutels](https://docs.rayosms.nl/nl/developers/api-overview-and-keys/). ## Wat u hierna kunt verkennen #### Bulkverzending met groepen Importeer uw klantenlijst in **Groepen** om campagnes naar meer dan 500 ontvangers tegelijk te verzenden. [Meer informatie over contactgroepen →](https://docs.rayosms.nl/nl/contacts-and-groups/groups/) #### Tekenlimieten & niet-Latijnse/GSM-compatibele sms Ontdek hoe Rayo SMS niet-Latijnse/GSM-compatibele tekst automatisch omzet naar het GSM-alfabet van 160 tekens, zodat u credits bespaart. [Lees Tekenlimieten en codering →](https://docs.rayosms.nl/nl/messaging/length-and-encoding/) --- ## Sectie: Sms verzenden en plannen (Sending & Scheduling — Dutch) ### Individuele en bulk-sms verzenden Source: https://docs.rayosms.nl/nl/messaging/sending-sms/ Description: Hoe u sms-berichten opstelt en verzendt naar individuele mobiele nummers, lijsten tot 500 nummers of een onbeperkt aantal ontvangers via contactgroepen. U kunt sms-berichten rechtstreeks verzenden naar één ontvanger, een lijst met nummers of een of meer contactgroepen via de pagina **Bericht versturen** in de linkerzijbalk (`/messages/new`). ## Een bericht opstellen en verzenden 1. **Selecteer een afzender-identificatie** Kies in het keuzemenu **Afzender-identificatie** de actieve en bevestigde afzender-id die ontvangers op hun telefoon moeten zien. - Als u een nieuwe afzender-id wilt registreren, klikt u op de link **Nieuwe afzender-identificatie** direct boven het keuzemenu. - Alleen afzender-identificaties die zowel **Bevestigd** als **Actief** zijn (`Bruikbaar? = Ja`) verschijnen in deze lijst. 2. **Geef uw ontvangers op (`Naar mobiele nummers` en/of `Groepen`)** U kunt ontvangers opgeven via **Naar mobiele nummers**, **Groepen**, of **beide tegelijk**: - **Directe mobiele nummers (`Naar mobiele nummers`)**: Voer een of meer mobiele nummers in, gescheiden door een **spatie**, **komma (`,`)**, **puntkomma (`;`)**, of plaats **elk nummer op een eigen regel**. - U kunt de internationale landcode toevoegen (bijv. `+306972669766` of `306972669766`) of weglaten (bijv. `6972669766`) om automatisch het **Standaardland voor verzending** van uw account te gebruiken. - **Maximaal 500 directe nummers**: U kunt in één verzending maximaal **500 mobiele nummers** rechtstreeks in het veld `Naar mobiele nummers` invoeren. - **Contactgroepen (`Groepen`)**: Selecteer een of meer groepen in het meervoudige selectieveld **Groepen** (`Selecteer de groepen waarnaar u het bericht wilt verzenden`). - Vereist wanneer u naar **meer dan 500 ontvangers** tegelijk verzendt. - **Automatische ontdubbeling**: Als een mobiel nummer in meerdere geselecteerde groepen voorkomt, stuurt Rayo SMS het bericht binnen hetzelfde verzoek **slechts één keer** naar dat nummer. - **Automatische onderdrukking van ongeldige nummers**: Elk contact dat in uw contactendatabase is gemarkeerd als **Ongeldig** (`Ongeldig? = Ja`), wordt automatisch overgeslagen — zelfs als het deel uitmaakt van een geselecteerde groep. 3. **Schrijf uw berichttekst (of hergebruik een eerder bericht)** Typ uw sms-inhoud in het vak **Bericht** (maximaal **1.000 tekens**). - **Eerdere tekst hergebruiken**: Klik op **Eerdere berichten** onder het tekstvak om een venster te openen met uw recent verzonden berichtteksten en klik vervolgens op **Gebruik deze** om de tekst direct in te voegen. - Bekijk tijdens het typen de live tellers **Aantal tekens** en **Aantal credits** onder het formulier. (Zie [Tekenlimieten en codering](https://docs.rayosms.nl/nl/messaging/length-and-encoding/) voor meer details.) 4. **Stel optionele opties in (Referentienummer, Plannen of Simulatie)** - **Referentienummer**: Voer optioneel uw eigen aangepaste kenmerk in (zoals een campagnenaam als `zomer-actie-2026` of een bestel-/klant-ID). U kunt uw **Verzonden**-geschiedenis later op dit exacte referentienummer filteren. - **Plannen op**: Laat dit veld leeg om onmiddellijk te verzenden, of kies een toekomstige datum en tijd om de bezorging in te plannen. - **Simulatie (bericht wordt niet verzonden)**: Vink dit vakje aan als u de volledige indienings- en statusworkflow wilt testen zonder daadwerkelijk sms-berichten te verzenden of credits te verbruiken. 5. **Bevestigen en verzenden** Klik op de knop **Bericht versturen** en bevestig het dialoogvenster (`Weet u zeker dat u dit bericht wilt verzenden?`). Uw verzoek wordt in de wachtrij geplaatst voor directe asynchrone verwerking (`Uw bericht is opgeslagen voor verdere verwerking`). --- ## Vergelijking: Directe nummers vs. Groepen | Kenmerk | Veld `Naar mobiele nummers` | Selectie `Groepen` | | :--- | :--- | :--- | | **Maximaal aantal ontvangers per verzending** | Tot **500** nummers | **Onbeperkt** | | **Invoerformaat** | Gescheiden door spatie, komma, puntkomma of nieuwe regel | Meervoudige selectie uit uw opgeslagen contactgroepen | | **Te combineren?** | Ja — u kunt directe nummers invoeren én groepen selecteren in hetzelfde verzoek | Ja | | **Preventie van dubbele berichten (6-uursvenster)** | Blokkeert het verzenden van exact dezelfde berichttekst naar hetzelfde mobiele nummer binnen een **tijdsbestek van 6 uur** | Ontdubbelt automatisch nummers die in meerdere groepen voorkomen en handhaaft de **6-uurs** bescherming tegen dubbele verzending | | **Onderdrukking van ongeldige contacten** | Controleert of het nummer als Ongeldig is gemarkeerd in uw Contacten | Slaat automatisch alle groepsleden over die als **Ongeldig** zijn gemarkeerd | > **NOTE: 6-uurs bescherming tegen dubbele berichten** > Om onbedoelde dubbele verzendingen te voorkomen en uw credits te beschermen, verstuurt Rayo SMS niet **exact dezelfde sms-inhoud** naar **hetzelfde mobiele nummer** binnen een **tijdsbestek van 6 uur** (`has already been sent this message within the last 6 hours`). Dit geldt zowel wanneer een nummer in meerdere geselecteerde groepen binnen dezelfde campagne voorkomt, als wanneer binnen 6 uur een afzonderlijk verzoek met identieke berichttekst wordt ingediend. > **TIP: Testen zonder creditkosten** > Wanneer u **Simulatie (bericht wordt niet verzonden)** inschakelt, verwerkt Rayo SMS het verzoek van begin tot eind, maakt het afleverrecords aan (met het voorvoegsel `simulation-`) en activeert het webhook-callbacks — zonder een daadwerkelijke sms naar de telecomprovider te sturen of credits van uw saldo af te schrijven. --- ### Tekenlimieten, codering en kostenberekening Source: https://docs.rayosms.nl/nl/messaging/length-and-encoding/ Description: Begrijp hoe Rayo SMS tekens telt en credits berekent voor enkelvoudige en meerdelige sms-berichten. Inzicht in hoe de tekenlengte en codering van sms-berichten werken, helpt u duidelijke berichten te schrijven en tegelijkertijd uw creditverbruik te optimaliseren. ## Basisregels voor sms-lengte | Regel | Limiet / Waarde | Details | | :--- | :--- | :--- | | **Limiet voor één sms** | **160 tekens** | Elk bericht tot 160 GSM-tekens kost **1 sms-credit** per ontvanger. | | **Segmentgrootte bij meerdelige (gekoppelde) sms** | **153 tekens per deel** | Wanneer een bericht langer is dan 160 GSM-tekens, worden 7 tekens per deel gereserveerd voor koppelingsheaders (UDH), waardoor elk segment **153 tekens** bevat. | | **Maximale berichtlengte** | **1.000 tekens** | Eén berichtverzending kan maximaal 1.000 tekens bevatten (tot 7 gekoppelde sms-delen). | ### Creditberekening op basis van aantal tekens Wanneer uw bericht langer is dan **160 GSM-tekens**, wordt het totale aantal sms-delen (en credits per ontvanger) als volgt berekend: ```text Sms-delen = Math.ceil(Totaal aantal GSM-tekens / 153) ``` | Aantal GSM-tekens | Sms-delen (Credits per ontvanger) | | :--- | :--- | | **1 – 160** tekens | **1** sms-deel | | **161 – 306** tekens | **2** sms-delen | | **307 – 459** tekens | **3** sms-delen | | **460 – 612** tekens | **4** sms-delen | | **613 – 765** tekens | **5** sms-delen | | **766 – 918** tekens | **6** sms-delen | | **919 – 1.000** tekens | **7** sms-delen | > **TIP: Let op de live teller** > In het scherm **Bericht versturen** (`/messages/new`) berekenen de live indicatoren **Aantal tekens** en **Aantal credits** onder het tekstvak automatisch en in realtime de tekenlengte en de opsplitsing in segmenten van 153 tekens terwijl u typt. --- ### Geplande berichten Source: https://docs.rayosms.nl/nl/messaging/scheduled-messages/ Description: Hoe u sms-berichten inplant voor toekomstige bezorging, uw geplande wachtrij filtert, de uitvoeringsstatus controleert en niet-uitgevoerde planningen annuleert. Met Rayo SMS kunt u individuele of bulk-sms-campagnes vooraf klaarmaken en inplannen voor automatische bezorging op een specifieke datum en tijd in de toekomst. ## Een sms inplannen voor toekomstige bezorging 1. Open **Bericht versturen** in de linkerzijbalk (`/messages/new`). 2. Selecteer uw **Afzender-identificatie**, voer uw **Naar mobiele nummers** in en/of selecteer **Groepen**, en stel uw **Bericht** op. 3. Klik op het veld **Plannen op** om de datum- enimkiezer te openen. 4. Selecteer de gewenste toekomstige datum en tijd en klik op **Toepassen**. 5. Klik op **Bericht versturen** en bevestig het dialoogvenster. U ziet de bevestigingsmelding: *"U heeft met succes een gepland bericht aangemaakt"*. --- ## Geplande berichten bekijken en filteren Om alle geplande sms-verzoeken te bekijken, klikt u op **Planningen** in de linkerzijbalk (`/sms_request_schedules`). De pagina **Verzoekplanningen** toont het totale aantal planningen (`Aantal planningen`) en biedt vier zoekfilters: | Filterveld | Beschrijving | | :--- | :--- | | **Niet uitgevoerd** | Vink dit vakje aan om alleen openstaande planningen te tonen die nog niet zijn uitgevoerd. | | **Mobiel** | Filter planningen die gericht zijn op een specifiek mobiel nummer van een ontvanger. | | **Gepland op** | Filter planningen op het datumbereik en tijdstip waarop ze zijn ingepland. | | **Groepen** | Filter planningen die gericht zijn op een of meer specifieke contactgroepen. | ### Planningsgegevens Klik op **Bekijken** bij een rij in de lijst om de pagina **Planningsgegevens** (`/sms_request_schedules/:id`) te openen, waar het volgende wordt weergegeven: - **Identificatie**: Unieke UUID van de planning. - **Afzender-id**: De afzender-identificatie die voor de verzending is ingesteld. - **Naar mobiele nummers** & **Groepen**: De geselecteerde ontvangers. - **Bericht**: De tekstinhoud van de sms. - **Plannen op**: De exacte datum en tijd waarop de planning wordt uitgevoerd. - **Uitgevoerd?**: Geeft aan of het geplande tijdstip is bereikt en het sms-verzoek is verzonden (`Ja` / `Nee`). --- ## Een gepland bericht annuleren (verwijderen) Als een gepland bericht **nog niet is uitgevoerd**, kunt u het annuleren zodat er geen sms-berichten worden verzonden: 1. Ga naar **Planningen** (`/sms_request_schedules`). 2. Zoek de niet-uitgevoerde planning die u wilt annuleren (of klik op **Bekijken** om de pagina **Planningsgegevens** te openen). 3. Klik op **Verwijderen** en bevestig het dialoogvenster (`Weet u zeker dat u deze planning wilt verwijderen?`). Na verwijdering wordt de geplande opdracht onmiddellijk uit de uitvoeringswachtrij gehaald (`De planning is verwijderd`) en worden er geen credits verbruikt. > **NOTE: Plannen en annuleren via de HTTP API** > U kunt berichten ook programmatisch inplannen met de parameter `scheduledAt` in `POST /v1/send_sms` en openstaande planningen annuleren met `DELETE /v1/sms_request_schedules/`. Zie [API-overzicht en API-sleutels](https://docs.rayosms.nl/nl/developers/api-overview-and-keys/) voor meer details. --- ### Verzendgeschiedenis en afleverrapporten Source: https://docs.rayosms.nl/nl/messaging/delivery-history-and-reports/ Description: Hoe u uw verzonden sms-geschiedenis doorzoekt, filtert op afleverstatus en datumbereik, afleverstatussen begrijpt en creditkosten per bericht bekijkt. Elke sms die u verstuurt — of dat nu via het webdashboard of via de HTTP API is — wordt per ontvanger afzonderlijk bijgehouden onder **Verzonden** (`Verzonden berichten`, te vinden op `/messages`). ## Sms-afleverstatussen begrijpen Elk mobiel nummer van een ontvanger in een sms-verzoek genereert een eigen uitgaand afleverrecord (`SmsOutDelivery`) dat de volgende statussen doorloopt: | UI-statuslabel | Interne status | Betekenis | | :--- | :--- | :--- | | **Nieuw** | `new` | Het bericht is geaccepteerd en in de wachtrij geplaatst voor asynchrone verzending. | | **Verzonden** | `sent` (of `unknown_delivery`) | Het bericht is succesvol overgedragen aan de telecomprovider en wacht op het definitieve afleverrapport (DLR) van het toestel. | | **Afgeleverd** | `delivered` | De telecomprovider heeft bevestigd dat de sms is afgeleverd op het mobiele toestel van de ontvanger. | | **Niet afgeleverd** | `not_delivered` | De provider heeft gemeld dat het bericht niet kon worden afgeleverd (bijvoorbeeld omdat de telefoon uitstond of buiten bereik was totdat de geldigheidsduur van het bericht verstreek, of omdat het nummer buiten gebruik is). | | **Verwerkingsfout** | `processing_error` / `failure` | Het bericht kon niet worden verzonden (bijvoorbeeld vanwege onvoldoende accountcredits, een ongeldige telefoonnummernotatie of een blokkade wegens een dubbel bericht). | --- ## Verzonden berichten zoeken en filteren Bovenaan de pagina **Verzonden berichten** (`/messages`) kunt u meerdere filters combineren en op **Zoeken** klikken: ### 1. Filteren op selectievakjes voor afleverstatus Vink een of meer statusvakjes aan om de lijst te beperken tot specifieke resultaten: - **Nieuw** - **Verwerkingsfout** - **Verzonden** - **Afgeleverd** - **Niet afgeleverd** ### 2. Filteren op mobiel nummer (`Mobiel`) Voer een volledig of gedeeltelijk mobiel nummer van een ontvanger in het invoerveld **Mobiel** in. ### 3. Filteren op verzenddatum (`Verzenddatum`) Klik op het kalenderveld **Verzenddatum** om een vooraf ingestelde periode of een aangepast datum-/tijdbereik te selecteren: - **Vandaag** - **Gisteren** - **Laatste 7 dagen** - **Laatste 30 dagen** - **Deze maand** - **Vorige maand** - **Aangepast** ### 4. Filteren op referentienummer (`Ref.nummer`) Voer het aangepaste **Referentienummer** (`clientRequestId`) in dat u heeft toegewezen bij het verzenden van het bericht via het webformulier of de API om alle afleveringen van een specifieke campagne of transactie te bekijken. --- ## De tabelkolommen van Verzonden berichten begrijpen | Kolom | Beschrijving | | :--- | :--- | | **Identificatie** | Unieke UUID van het individuele afleverrecord per ontvanger (`sms_out_delivery.id`). Voor gesimuleerde berichten begint dit met `simulation-`. | | **Datum/tijd verzonden** | Tijdstip waarop het afleverrecord is aangemaakt. | | **Afzender-id** | Het alfanumerieke label of mobiele nummer dat als afzender is gebruikt. | | **Mob.nummer** | Het genormaliseerde mobiele nummer van de ontvanger (inclusief landcode). | | **Bericht** | Voorbeeldweergave van de sms-tekst (beweeg de muis over de cel om de volledige tekst te lezen, of `******` indien permanent gemaskeerd). | | **Status** | Huidige afleverstatus (`Nieuw`, `Verzonden`, `Afgeleverd`, `Niet afgeleverd` of `Verwerkingsfout`). | | **Fout** | Korte foutreden als de bezorging is mislukt (beweeg de muis over de cel om de volledige diagnostische foutbeschrijving te bekijken). | | **Referentienummer** | Uw optionele aangepaste referentie / `client_request_id`. | | **Credits** | Het exacte aantal sms-credits dat voor deze aflevering in rekening is gebracht. | > **TIP: Realtime webhook-updates & AVG/GDPR-privacy** > - Wilt u updates over de afleverstatus automatisch naar uw eigen server laten sturen? Configureer een **Callback-URL** in [Aflever-callbacks (Webhooks)](https://docs.rayosms.nl/nl/developers/webhooks-and-callbacks/). > - Wilt u gevoelige berichttekst na het verzenden uit de kolom **Bericht** wissen? Gebruik de knop **Berichten permanent maskeren** bovenaan de tabel Verzonden berichten of stel automatische maskering in via [Berichten maskeren (AVG/GDPR)](https://docs.rayosms.nl/nl/account-and-security/message-masking/). --- ## Sectie: Afzender-identificaties (Sender IDs — Dutch) ### Afzender-identificaties (Afzender-id's) beheren Source: https://docs.rayosms.nl/nl/sender-ids/managing-sender-ids/ Description: Registreer, bevestig, activeer, deactiveer en beheer alfanumerieke en mobiele telefoonnummer-afzender-identificaties in Rayo SMS. Een **Afzender-identificatie** (ook wel een **Afzender-id** genoemd) is de **"Van"**-naam of het mobiele telefoonnummer dat op de telefoon van de ontvanger wordt weergegeven wanneer deze uw sms-bericht ontvangt. Om uw afzender-identificaties te bekijken en te beheren, logt u in op de [Webapplicatie](https://sms.rayosms.nl) en klikt u in de linkerzijbalk op **Afzender-id's** (`Afzender-identificaties`). --- ## Soorten afzender-identificaties Rayo SMS ondersteunt twee soorten afzender-identificaties: **Alfanumerieke labels** en **Mobiele telefoonnummers**. #### 1. Alfanumerieke labels Voorbeelden: `ROMEO`, `MY-SHOP`, `COMPANY.GR` - **Maximale lengte**: Tot **11 tekens** (inclusief spaties). - **Toegestane tekens**: Latijnse letters (`A-Z`, `a-z`), cijfers (`0-9`), spaties, streepjes (`-`), underscores (`_`) en punten (`.`). - **Bevestiging**: Onmiddellijk bevestigd bij het aanmaken (`Bevestigd`) en direct klaar voor gebruik. #### 2. Mobiele telefoonnummers Voorbeelden: `306972669700` of `+306972669700` - **Lengte**: Tussen **10 en 15 cijfers** (maximaal 15 cijfers). - **Bevestiging**: Vereist **sms-bevestiging** (`pending_confirmation`) via een 5-cijferige verificatiecode die naar dat mobiele nummer wordt gestuurd. - **Vervaldatum**: Moet binnen **15 minuten** na het aanmaken worden bevestigd. --- ## Een alfanumerieke afzender-identificatie registreren 1. Ga naar **Afzender-id's** in de linkerzijbalk en klik op **Nieuwe afzender-identificatie**. 2. Voer uw gewenste alfanumerieke label in (maximaal **11 tekens**, met gebruik van `A-Z`, `a-z`, `0-9`, spaties, `-`, `_` of `.`). 3. Verstuur het formulier. Alfanumerieke identificaties krijgen onmiddellijk de status **Bevestigd** en worden direct geactiveerd, zodat u meteen berichten kunt gaan verzenden. > **CAUTION: Belangrijk: Voorafgaande registratie per bestemmingsland** > Hoewel alfanumerieke labels in de meeste gevallen direct kunnen worden gebruikt, kan voorafgaande registratie vereist zijn afhankelijk van het bestemmingsland waarvoor u een dergelijke afzender-id wilt gebruiken. Uw uitgaande sms kan ons platform verlaten, maar vervolgens op het bestemmingsnetwerk worden geblokkeerd als de afzender-id daar niet is geregistreerd. Neem [contact met ons op](https://sms.rayosms.nl/set_locale?locale=nl&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us) met uw afzender-id en het land waarvoor u deze wilt gebruiken; wij laten u dan weten of registratie nodig is of niet. --- ## Een mobiel telefoonnummer registreren en bevestigen Wanneer u een mobiel telefoonnummer registreert als afzender-identificatie, verifieert Rayo SMS eerst dat u de eigenaar of beheerder van het nummer bent voordat het als afzender mag worden gebruikt. 1. Ga naar **Afzender-id's** in de linkerzijbalk en maak een nieuwe afzender-identificatie aan met uw mobiele nummer (10 tot 15 cijfers, bijv. `306972669700` of `+306972669700`). 2. Na het aanmaken krijgt de identificatie de status `pending_confirmation` (`is niet bevestigd`) en stuurt Rayo SMS onmiddellijk een **5-cijferige bevestigingscode** per sms naar dat mobiele nummer. 3. Open de pagina **Bevestig mobiele afzender-id**, vul de **5-cijferige code** in en klik binnen **15 minuten** op **Bevestigen**. 4. Zodra het nummer is bevestigd, krijgt het de status **Bevestigd** en is het klaar voor gebruik. > **CAUTION: Vervaltijd van 15 minuten & limiet van één openstaande bevestiging** > - Als u de 5-cijferige bevestigingscode niet binnen **15 minuten** invoert, verloopt de openstaande bevestiging automatisch (status `expired`). > - Er kan slechts **één** mobiele afzender-identificatie tegelijk de status `pending_confirmation` hebben. U moet eerst het openstaande nummer bevestigen of 15 minuten wachten totdat het automatisch verloopt voordat u een ander mobiel telefoonnummer kunt registreren. --- ## Afzender-identificaties activeren en deactiveren Elke afzender-identificatie heeft zowel een **Bevestigingsstatus** als een **Actief?-status**, samengevat in de kolom **Bruikbaar?**: - Alleen afzender-identificaties die **zowel Bevestigd als Actief** zijn (`Bruikbaar? = Ja`) verschijnen in het keuzemenu van **Bericht versturen** in de webapplicatie en worden geaccepteerd door de HTTP API. - U kunt elke bevestigde afzender-identificatie op elk moment in- of uitschakelen door op **Deactiveren** te klikken (om deze te verbergen in het verzendscherm en API-gebruik te blokkeren) of op **Activeren** (om deze opnieuw in te schakelen). --- ## Een afzender-identificatie verwijderen U kunt een afzender-identificatie **alleen permanent verwijderen als deze nog nooit is gebruikt** om een sms-bericht te verzenden. > **NOTE: Waarom gebruikte afzender-id** > Zodra een afzender-identificatie in het verleden is gebruikt om ten minste één sms te verzenden, **kan deze niet meer worden verwijderd** (`Kan niet worden verwijderd omdat deze in het verleden is gebruikt voor sms-bezorging`). Deze beperking waarborgt de integriteit van uw historische aflever- en auditlogboeken. > > Als u een eerder gebruikte afzender-identificatie niet langer wilt gebruiken, klikt u in plaats daarvan op **Deactiveren** — hiermee wordt deze uit actieve keuzemenu's verwijderd en geblokkeerd voor nieuwe berichten, terwijl de historische gegevens behouden blijven. --- ## Sectie: Contacten en groepen (Contacts & Groups — Dutch) ### Contacten beheren Source: https://docs.rayosms.nl/nl/contacts-and-groups/contacts/ Description: Bewaar, doorzoek, bewerk, verwijder en onderdruk individuele contactpersonen in uw Rayo SMS-adresboek. Met de map **Contacten** in Rayo SMS kunt u uw adresboek van ontvangers beheren, klantreferentie-ID's uit uw CRM of ERP koppelen en bezorgingsonderdrukking regelen met de vlag **Ongeldig?**. Om uw contacten te openen, logt u in op de [Webapplicatie](https://sms.rayosms.nl) en klikt u op **Contacten** in de linkerzijbalk. --- ## Contactgegevens (Attributen) Elk contactrecord in Rayo SMS ondersteunt de volgende velden: | Attribuut | Verplicht | Beschrijving | | :--- | :--- | :--- | | **Voornaam** | Optioneel | De voornaam van de contactpersoon. | | **Achternaam** | Optioneel | De achternaam / familienaam van de contactpersoon. | | **Mob.nummer** | **Verplicht** | Het mobiele telefoonnummer van de ontvanger. Kan **met of zonder** landcode worden ingevoerd. Als er geen landcode is opgegeven, wordt automatisch de landcode van het **Standaardland voor verzending** van uw account toegepast. | | **Ref.nummer** | Optioneel | Een door u gedefinieerde aangepaste referentiecode (bijv. `cust-2343`, een ERP-klantcode of een CRM-record-ID). | | **Ongeldig?** (`is_it_invalid`) | Optioneel | Selectievakje dat aangeeft of sms-bezorging naar dit contact automatisch moet worden onderdrukt. | --- ## Contacten zoeken Gebruik bovenaan de pagina **Contacten** het zoekvak **Geef een woord of nummer op om naar te zoeken** om snel records te vinden. De zoekopdracht zoekt in: - **Mobiele nummers** (`Mob.nummer`) - **Voornamen** (`Voornaam`) - **Achternamen** (`Achternaam`) - **Referentienummers** (`Ref.nummer`) --- ## Contacten aanmaken en bewerken ### Een nieuw contact aanmaken 1. Klik op **Contacten** in de linkerzijbalk. 2. Klik op de knop **Nieuw contact**. 3. Vul het **Mob.nummer** in (verplicht) en geef optioneel **Voornaam**, **Achternaam**, **Ref.nummer** en het selectievakje **Ongeldig?** op. 4. Klik op **Nieuw contact aanmaken** om het record op te slaan. ### Een bestaand contact bewerken 1. Zoek het contact in uw **Contacten**-lijst (of gebruik de zoekbalk). 2. Klik op **Contact bewerken** naast het record. 3. Werk de naam, het mobiele nummer, het referentienummer of de status **Ongeldig?** van het contact bij en sla uw wijzigingen op. --- ## Bezorging onderdrukken met de vlag "Ongeldig?" Wanneer bij een contact het selectievakje **Ongeldig?** (`is_it_invalid`) is ingeschakeld, **slaat Rayo SMS de sms-bezorging naar dat mobiele nummer automatisch over en onderdrukt deze**. > **TIP: Automatische onderdrukking bij groepscampagnes** > Door een contact te markeren als **Ongeldig** worden berichten naar dat nummer ook geblokkeerd wanneer u een bulkcampagne verstuurt naar een [Contactgroep](https://docs.rayosms.nl/nl/contacts-and-groups/groups/) waarin dat contact nog steeds is opgenomen. > > Dit maakt de vlag **Ongeldig?** ideaal voor het beheren van: > - **Afmeldingen / uitschrijvingen van klanten** (AVG/GDPR- en marketingnaleving) > - **Bekende afgesloten of gedeactiveerde nummers** > - **Tijdelijke verzendblokkades** zonder het historische record, de referentie-ID of de groepslidmaatschappen van het contact te verliezen --- ## Een contact verwijderen Om een contact permanent uit uw account te verwijderen, klikt u op **Nummer verwijderen** naast het contact. > **CAUTION: Verwijderen wist ook alle groepslidmaatschappen** > Als u op **Nummer verwijderen** klikt, wordt het contact permanent verwijderd uit uw **Contacten**-lijst **én wordt het nummer automatisch verwijderd uit elke [Groep](https://docs.rayosms.nl/nl/contacts-and-groups/groups/) waartoe het behoort**. > > Als u een ontvanger alleen uit één specifieke groep wilt halen maar wel in uw contactendatabase wilt bewaren, verwijder deze persoon dan uit de ledenlijst van die groep. Of, als u wilt voorkomen dat er per ongeluk berichten worden verzonden bij toekomstige imports en campagnes, markeer het contact dan als **Ongeldig?** in plaats van het te verwijderen. --- ### Contactgroepen en bulkimport Source: https://docs.rayosms.nl/nl/contacts-and-groups/groups/ Description: Organiseer ontvangers in contactgroepen, importeer duizenden nummers asynchroon in bulk en verstuur grootschalige sms-campagnes. Met **Contactgroepen** kunt u ontvangers organiseren in herbruikbare lijsten en bulk-sms-campagnes van elke omvang verzenden. Om uw groepen te beheren, logt u in op de [Webapplicatie](https://sms.rayosms.nl) en klikt u op **Groepen** in de linkerzijbalk. --- ## Waarom contactgroepen gebruiken? #### Campagnes met meer dan 500 ontvangers Het rechtstreeks plakken van nummers in het veld van **Bericht versturen** is beperkt tot 500 ontvangers per verzending. Om een campagne naar **meer dan 500 mobiele nummers** tegelijk te verzenden, plaatst u ze in een groep en selecteert u die groep bij het verzenden. #### Automatische ontdubbeling (6-uursvenster) Rayo SMS voorkomt dat exact dezelfde sms-inhoud binnen een **tijdsbestek van 6 uur** naar hetzelfde mobiele nummer wordt verzonden. Als een nummer tot meerdere geselecteerde groepen behoort (of als u dezelfde campagne binnen 6 uur opnieuw verstuurt), ontvangt de ontvanger de sms **slechts één keer**. #### Automatische onderdrukking van ongeldige nummers Elk lid van wie het [contactrecord](https://docs.rayosms.nl/nl/contacts-and-groups/contacts/) is gemarkeerd als **Ongeldig** (`Ongeldig? = Ja`), wordt automatisch overgeslagen bij het verzenden naar een groep, waardoor uw credits worden beschermd en afmeldingen worden gerespecteerd. #### Doelgroepsegmentatie Beheer afzonderlijke lijsten voor vip-klanten, regionale vestigingen, personeelsmeldingen of seizoensgebonden marketingsegmenten. --- ## Een groep aanmaken 1. Klik op **Groepen** in de linkerzijbalk. 2. Klik op **Nieuwe groep**. 3. Voer in het veld **Geef de naam van de groep op** een beschrijvende naam voor uw groep in. 4. Klik op **Aanmaken**. --- ## Eén lid toevoegen (`Nieuw lid toevoegen`) Om één individuele ontvanger aan een bestaande groep toe te voegen: 1. Open **Groepen** in de linkerzijbalk en zoek uw groep. 2. Klik op **Nieuw lid toevoegen**. 3. Voer het **Mobiel nummer** in (verplicht) en vul optioneel **Voornaam**, **Achternaam** en **Referentiecode** (`Ref.nummer`) in. 4. Verstuur het formulier. > **NOTE** > Als het mobiele nummer dat u invoert nog niet bestaat in uw map [Contacten](https://docs.rayosms.nl/nl/contacts-and-groups/contacts/), maakt Rayo SMS automatisch ook het bijbehorende contactrecord aan. --- ## Leden in bulk importeren (`Meerdere leden toevoegen`) U kunt honderden of duizenden ontvangers tegelijk in een groep importeren met de bulkimportfunctie. 1. Ga naar **Groepen** en klik bij de gewenste groep op **Meerdere leden toevoegen**. 2. Plak uw lijst met ontvangers in het tekstvak met **één ontvanger per regel**. 3. Elke regel kan alleen het mobiele nummer bevatten, of door komma's gescheiden waarden in de indeling: `MobielNummer,Voornaam,Achternaam,Referentiecode` 4. Verstuur het formulier om de import op de achtergrond te starten. ### Voorbeeld van bulkimportformaat Hieronder ziet u het exacte formaat dat wordt geaccepteerd door de functie **Meerdere leden toevoegen**: ```text +306972669766 +306972669762 +306972669761,John,Smith +306972669760,Mary,Foo,cust-2343 +306972669759,James ``` - **Landcode is optioneel**: Mobiele nummers hoeven niet te beginnen met een landcode. Als u bijvoorbeeld `6972669766` invoert, wordt automatisch de landcode van het **Standaardland voor verzending** van uw account toegepast (zoals `+30`). - **Optionele velden**: U kunt op elke regel de laatste velden weglaten (bijv. alleen mobiel nummer, mobiel + voornaam, of mobiel + voornaam + achternaam + referentiecode). ### Asynchrone achtergrondimport Wanneer u een bulkimport indient, plaatst Rayo SMS de lijst in de wachtrij voor asynchrone verwerking op de achtergrond en toont het de bevestigingsmelding: > `De mobiele nummers zijn opgeslagen voor verdere verwerking` U hoeft uw browservenster niet open te houden. Zodra alle mobiele nummers zijn verwerkt en aan de groep zijn toegevoegd, stuurt Rayo SMS een **e-mailmelding** naar het e-mailadres van uw account. --- ## Groepsleden bekijken en verwijderen Om de ontvangers binnen een groep te bekijken, klikt u op de ledenlijst van de groep op de pagina **Groepen**. - Om een ontvanger uit een specifieke groep te verwijderen, klikt u naast de vermelding op **Mobiel nummer uit de groep verwijderen**. - **Contactendatabase blijft behouden**: Als u op **Mobiel nummer uit de groep verwijderen** klikt, wordt het nummer alleen uit die specifieke groep losgekoppeld — **het contact blijft behouden in uw algemene [Contacten](https://docs.rayosms.nl/nl/contacts-and-groups/contacts/)-database** (en in eventuele andere groepen waartoe het behoort). --- ## Sectie: Credits en facturering (Credits & Billing — Dutch) ### Credits bestellen en betaalmethoden Source: https://docs.rayosms.nl/nl/billing/purchasing-credits/ Description: Ontdek hoe prepaid credits bij Rayo SMS werken, wat de commerciële voorwaarden zijn en hoe u credits koopt via kaart, bankstorting of op krediet. Rayo SMS werkt met een transparant prepaid creditmodel. Om credits te kopen, logt u in op de [Webapplicatie](https://sms.rayosms.nl) en klikt u op **Credits** in de linkerzijbalk (of klikt u op de badge **Resterende credits** in de bovenste navigatiebalk), en selecteert u vervolgens **Credits bestellen**. --- ## Hoe sms-credits werken - **Prepaid model**: Credits moeten beschikbaar zijn in uw accountsaldo voordat u live sms-berichten kunt verzenden (testen met de simulatiemodus verbruikt `0` credits). - **Prijzen & btw**: De weergegeven prijzen per credit zijn exclusief btw. Eventueel verschuldigde btw wordt bij het afrekenen berekend en toegevoegd op basis van uw bevestigde belastingprofiel. - **Creditverbruik**: **1 credit = 1 standaard sms-deel** (tot 160 GSM 7-bit-tekens; meerdelige berichten van meer dan 160 tekens verbruiken 1 credit per segment van 153 tekens) volgens het tarief voor uw bestemmingsland. - **Geldigheid van 1 jaar**: Gekochte credits moeten binnen **1 jaar (365 dagen)** na de aankoopdatum worden gebruikt. Eventuele ongebruikte credits die na 1 jaar overblijven, komen automatisch te vervallen. - **Geen terugbetalingen of annuleringen**: Alle creditaankopen zijn definitief en kunnen niet worden terugbetaald of geannuleerd. - **Facturering**: Officiële belastingfacturen worden automatisch opgesteld op basis van uw bevestigde **Bedrijfsgegevens** en verzonden naar het contact-e-mailadres van uw account. --- ## Drie betaalmethoden Op de pagina **Credits bestellen** kunt u kiezen uit drie betaalmethoden, afhankelijk van of u de voorkeur geeft aan directe toewijzing of aan nul betalingsverwerkingskosten: #### 1. Online aankoop met kaart ### Online aankoop met kaart (Direct) Betaal online met elke gangbare creditcard of betaalkaart (VISA, Mastercard), veilig verwerkt via Stripe voor **onmiddellijke toewijzing van credits**. 1. Open **Credits -> Credits bestellen** en selecteer het tabblad **Online aankoop met kaart**. 2. Voer het gewenste **Aantal credits** in (moet minimaal gelijk zijn aan de weergegeven minimale aankoopdrempel). 3. Controleer het berekende totaalbedrag (inclusief btw) en het geschatte netto aantal credits dat wordt toegewezen, en klik vervolgens op de blauwe betaalknop met het berekende EUR-bedrag. 4. Voer de **Naam kaarthouder**, het **Kaartnummer** en de **Vervalmaand / het Vervaljaar** in om de betaling te voltooien. > **NOTE: Verwerkingskosten bij kaartbetalingen** > Bij aankopen met een kaart worden verwerkingskosten van de betalingsverwerker in rekening gebracht, wat tot uiting komt in een kleine vermindering van het netto aantal credits dat aan uw saldo wordt toegevoegd. Voordat u betaalt, toont de interface een schatting van het verwachte aantal credits (dit kan licht variëren afhankelijk van het kaarttype en het land/de valuta van uitgifte). > > **Om 100% van uw bestelde credits zonder verwerkingskosten te ontvangen**, gebruikt u **Bankstorting** of **Kopen op krediet**. > **TIP: Kaartbeveiliging** > Rayo SMS **slaat uw kaartgegevens nooit op** in zijn eigen databases. Alle kaartnummers en gevoelige betalingsgegevens worden rechtstreeks doorgestuurd naar de PCI-DSS-gecertificeerde betalingsverwerker (Stripe). #### 2. Bankstorting ### Bankstorting (Geen verwerkingskosten) Betaal via een bankoverschrijving / bankstorting om kosten van kaartverwerkers volledig te vermijden. 1. Open **Credits -> Credits bestellen** en selecteer het tabblad **Bankstorting**. 2. Bekijk de vermelde **IBAN-bankrekeningen** en het minimale stortingsbedrag (inclusief btw). 3. Maak een bedrag dat gelijk is aan of hoger is dan het minimale stortingsbedrag over naar een van de weergegeven IBAN-rekeningen. 4. Stuur uw betalingsbewijs per e-mail naar het adres dat op de pagina wordt vermeld, of stuur een bericht via het **Contact**-formulier in de applicatie ([Neem contact op](https://sms.rayosms.nl/set_locale?locale=nl&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us)). 5. Zodra uw storting door onze financiële administratie is geverifieerd, wordt het volledige aantal credits aan uw account toegewezen. #### 3. Kopen op krediet ### Kopen op krediet (Direct + Bankafwikkeling) **Kopen op krediet** combineert de snelheid van onmiddellijke credittoewijzing met het kosteloze voordeel van een bankstorting. Deze optie is beschikbaar voor in aanmerking komende accounts waarvoor dit door de platform- of accountbeheerder is ingeschakeld (`Mag op krediet kopen`). 1. Open **Credits -> Credits bestellen** en selecteer het tabblad **Kopen op krediet**. 2. Klik op **Kopen op krediet**. 3. Uw account wordt **onmiddellijk en automatisch opgewaardeerd** met het vooraf goedgekeurde creditpakket, zodat u dringende sms-campagnes kunt verzenden zonder op de verwerking van de bank te hoeven wachten. 4. Voldoe vervolgens het bijbehorende EUR-bedrag (inclusief btw) via een bankoverschrijving naar een van de vermelde IBAN-bankrekeningen. > **CAUTION: Vereiste bevestiging van bestelling** > Zodra uw bankoverschrijving is ontvangen en verwerkt, **bevestigt** (`Bevestigen`) de beheerder uw kredietbestelling. > > **Let op:** Een eerdere kredietbestelling moet eerst door de beheerder zijn bevestigd voordat u een nieuwe bestelling via **Kopen op krediet** kunt plaatsen. U kunt de status **Bevestigd?** van uw bestellingen op elk moment controleren in de [Bestelgeschiedenis](https://docs.rayosms.nl/nl/billing/orders-and-alerts/). --- ### Bestelgeschiedenis en meldingen bij laag saldo Source: https://docs.rayosms.nl/nl/billing/orders-and-alerts/ Description: Volg uw eerdere aankopen van sms-credits, controleer de bevestigingsstatus van bestellingen en configureer automatische sms-meldingen bij een laag saldo. Rayo SMS biedt een volledig overzicht van al uw creditaankopen, samen met geautomatiseerde sms-meldingen zodat uw account nooit onverwacht zonder credits komt te zitten. --- ## Bestelgeschiedenis bekijken Om alle eerdere credittransacties te bekijken, logt u in op de [Webapplicatie](https://sms.rayosms.nl) en gaat u naar **Credits -> Bestelgeschiedenis** (`/sms_credit_sales`). Elk record in uw **Bestelgeschiedenis** toont: - **Verkocht op**: De exacte datum en tijd waarop de creditbestelling is aangemaakt. - **Aantal credits**: Het netto aantal sms-credits dat aan uw saldo is toegevoegd. - **Bedrag (Excl. btw & Betaald met btw)**: De netto geldwaarde en het totaalbedrag inclusief btw. - **Betaalmethode**: Geeft aan of de bestelling is geplaatst via `Creditcard of betaalkaart` of `Bankstorting`. - **Bevestigd?**: Toont of een bankstorting of een bestelling via [Kopen op krediet](https://docs.rayosms.nl/nl/billing/purchasing-credits/) door de beheerder is gecontroleerd en bevestigd. - **Transactie- & kaartmetadata**: Toont bij kaartaankopen het kaarttype, de laatste 4 cijfers van de kaart, de transactie-ID van de betalingsverwerker en de kosten van de kaartbetaling uitgedrukt in credits. --- ## Sms-meldingen bij een laag saldo instellen Wanneer u geautomatiseerde transactionele sms-stromen (zoals OTP's, boekingsbevestigingen of orderupdates via de API) of geplande campagnes uitvoert, kan een tekort aan credits uw verzendingen onderbreken. U kunt maximaal twee mobiele nummers instellen om automatisch een sms-waarschuwing te ontvangen zodra uw creditsaldo bijna op is. 1. Klik in de bovenste navigatiebalk op **Geavanceerd -> Instellingen -> Ontvangers van meldingen bij laag creditsaldo** (`/settings/low_credit_alert_recipients`). 2. Voer uw primaire mobiele nummer in het veld **1e mobiel** in. 3. Voer optioneel een tweede ontvanger in het veld **2e mobiel** in (bijvoorbeeld een financieel medewerker of een dienstdoende engineer). 4. Klik op **Opslaan**. ### Hoe de dynamische waarschuwingsdrempel werkt In plaats van een vast getal te hanteren dat voor grootverbruikers te laag kan zijn, past Rayo SMS de drempel dynamisch aan uw daadwerkelijke verzendvolume aan: - Rayo SMS berekent uw **gemiddelde dagelijkse creditverbruik over de afgelopen 30 dagen** (`DAILY_BALANCE_AVERAGE_RANGE = 30`). - Als uw account de afgelopen 30 dagen geen verzendactiviteit heeft gehad, wordt een **standaarddrempel van 100 credits** gebruikt. - Zodra uw resterende creditsaldo onder deze daggemiddelde drempel zakt, verstuurt Rayo SMS automatisch een waarschuwings-sms naar de door u ingestelde nummers bij **1e mobiel** en **2e mobiel**. > **TIP: Meldingen bij laag saldo uitschakelen** > Om geen sms-meldingen bij een laag saldo meer te ontvangen, gaat u naar **Geavanceerd -> Instellingen -> Ontvangers van meldingen bij laag creditsaldo**, maakt u zowel het veld **1e mobiel** als **2e mobiel** leeg en klikt u op **Opslaan**. --- ## Sectie: Privacy, beveiliging en team (Privacy, Security & Team — Dutch) ### Berichten maskeren & AVG/GDPR-privacy Source: https://docs.rayosms.nl/nl/account-and-security/message-masking/ Description: Maskeer gevoelige sms-berichtinhoud (OTP's, wachtwoorden, persoonsgegevens) permanent op aanvraag, onmiddellijk of na een instelbare vertraging. Organisaties die eenmalige wachtwoorden (OTP's), tijdelijke inloggegevens, bankmeldingen, medische afspraakherinneringen of persoonsgegevens (PII) verzenden, moeten vaak kunnen **aantonen dat een sms is afgeleverd** zonder de gevoelige berichtinhoud in logboeken van derden te bewaren. Rayo SMS biedt ingebouwde **Permanente berichtmaskering** om u te helpen voldoen aan de AVG (GDPR) en strenge interne richtlijnen voor gegevensbewaring. --- ## Wat permanente maskering doet Wanneer een bericht in Rayo SMS wordt gemaskeerd: 1. **Vervanging van de berichttekst**: De `sms_body` van voltooide berichten (berichten met een eindstatus: `sent`, `delivered`, `not_delivered`, `unknown_delivery` of `failure`) wordt in de database overschreven met exact **60 sterretjes**: ```text ************************************************************ ``` 2. **Onomkeerbare verwijdering**: De oorspronkelijke berichttekst wordt definitief uit de database gewist en **kan door niemand meer worden hersteld** — ook niet door beheerders van Rayo SMS. 3. **Behoud van auditmetadata**: Alle niet-inhoudelijke aflevermetadata blijven volledig bewaard voor factuurcontrole, klantenservice en compliance-audits: - Tijdstempels van indiening en aflevering - Mobiel nummer van de ontvanger - Afzender-identificatie (Afzender-id) - Definitieve afleverstatus (`delivered`, `not_delivered`, enz.) - Eigen referentienummer (`clientRequestId`) - Kosten in credits > **DANGER: Maskeren is permanent en onomkeerbaar** > Zodra een berichttekst is gemaskeerd met `************************************************************`, is de oorspronkelijke tekst definitief overschreven in de opslag. Dit kan niet ongedaan worden gemaakt of worden teruggehaald. --- ## Drie manieren om berichten te maskeren U kunt berichten op elk moment handmatig maskeren of automatische maskeringsregels instellen in [de Webapplicatie](https://sms.rayosms.nl). ### Optie 1: Handmatig maskeren op aanvraag Gebruik handmatig maskeren wanneer u de tekst van alle eerder verzonden berichten direct wilt wissen: 1. Ga naar **Verzonden** (`/messages`) in de linkerzijbalk. 2. Klik op de rode knop **Berichten permanent maskeren**. 3. Bevestig de vraag in het dialoogvenster. 4. Een achtergrondproces begint onmiddellijk met het maskeren van alle in aanmerking komende voltooide berichten in uw account en stuurt u een **bevestigingsmail** zodra het proces is voltooid. --- ### Optie 2: Onmiddellijk automatisch maskeren Gebruik onmiddellijk maskeren als uw beveiligingsbeleid vereist dat berichttekst nooit wordt bewaard nadat een sms is verwerkt (ideaal voor OTP- en 2FA-verkeer): 1. Ga naar **Geavanceerd** (bovenste balk) -> **Instellingen** -> **Berichten maskeren** (`/settings/mask_messages`). 2. Klik op **Onmiddellijk maskeren inschakelen**. 3. Vanaf dat moment wordt van elk uitgaand bericht de `sms_body` permanent gemaskeerd zodra de verwerking is afgerond. --- ### Optie 3: Vertraagd automatisch maskeren (na X minuten) Gebruik vertraagd maskeren wanneer uw klantenserviceteam een korte periode nodig heeft om recente berichtinhoud in te zien voor probleemoplossing, waarna berichten automatisch moeten worden geanonimiseerd: 1. Ga naar **Geavanceerd** (bovenste balk) -> **Instellingen** -> **Berichten maskeren** (`/settings/mask_messages`). 2. Voer de gewenste bewaartermijn in minuten in — van **`1` minuut** tot **`129.600` minuten** (**90 dagen**). 3. Klik op **Maskeren inschakelen na dit aantal minuten** (of op **Aantal minuten bijwerken** als vertraagd maskeren al actief is). 4. Berichtteksten blijven zichtbaar gedurende het door u ingestelde tijdsvenster en worden automatisch en permanent gemaskeerd zodra de timer afloopt. --- ### Teamleden, uitnodigingen en van account wisselen Source: https://docs.rayosms.nl/nl/account-and-security/team-members/ Description: Nodig ontwikkelaars uit voor uw Rayo SMS-account, beheer op rollen gebaseerde rechten en wissel naadloos tussen meerdere accounts. Met Rayo SMS kunt u veilig samenwerken met technische teamleden — zoals software-engineers en systeemintegrators — door hen uit te nodigen voor uw account in plaats van uw eigen inloggegevens als accounteigenaar te delen. --- ## Teamrollen en rechten Rayo SMS ondersteunt momenteel de teamrol **`developer`**, die specifiek is ontworpen voor technische integratie en beveiligingsconfiguratie, terwijl commerciële gegevens, contacten en berichtinhoud uitsluitend toegankelijk blijven voor de **Accounteigenaar**. | Functie / Onderdeel | Accounteigenaar | `developer`-lid | | :--- | :---: | :---: | | **Dashboardoverzicht** | Ja | Ja | | **Gebruikersvoorkeuren & taalvoorkeur** (`/preferences`) | Ja | Ja | | **Geavanceerd -> Instellingen -> API-sleutels** (`/settings/api_keys`) | Ja | Ja | | **Geavanceerd -> Instellingen -> Callbacks** (`/settings/callbacks`) | Ja | Ja | | **Geavanceerd -> Instellingen -> Berichten maskeren** (`/settings/mask_messages`) | Ja | Nee | | **Geavanceerd -> Instellingen -> Ontvangers van meldingen bij laag creditsaldo** | Ja | Nee | | **Bericht versturen (UI-campagnes)** | Ja | Nee | | **Verzonden berichtgeschiedenis** (`/messages`) | Ja | Nee | | **Contacten & Groepen** | Ja | Nee | | **Credits & Bestelgeschiedenis** | Ja | Nee | | **Bedrijfsgegevens & Factureringsprofiel** | Ja | Nee | | **Leden & Lid-uitnodigingen beheren** | Ja | Nee | --- ## Een teamlid uitnodigen 1. Log in op de [Webapplicatie](https://sms.rayosms.nl) als de accounteigenaar. 2. Ga in de bovenste navigatiebalk naar **Geavanceerd -> Lid-uitnodigingen** en klik op **Nodig een lid uit**. 3. Voer het e-mailadres van de genodigde in bij **E-mailadres** en herhaal dit bij **Bevestig e-mailadres**. 4. Selecteer de rol (`developer`). 5. Klik op **Uitnodiging versturen**. > **NOTE: Regels voor uitnodigingen** > - De uitgenodigde gebruiker moet een geregistreerd account hebben op **hetzelfde merk/platform**. > - U kunt geen uitnodiging naar uw eigen e-mailadres sturen. > - U kunt geen dubbele uitnodiging aanmaken als er al een openstaande uitnodiging voor die gebruiker bestaat. --- ## Verzonden uitnodigingen beheren Ga naar **Geavanceerd -> Lid-uitnodigingen -> Verzonden** om alle uitnodigingen die u heeft verstuurd en hun huidige status te bekijken: - `Verzonden` — De uitnodiging wacht op een reactie van de ontvanger. - `Geaccepteerd` — De gebruiker heeft de uitnodiging geaccepteerd en is een actief lid (of was eerder lid). - `Verlopen` — De uitnodiging is verlopen voordat deze werd geaccepteerd. - `Geweigerd` — De ontvanger heeft de uitnodiging afgewezen. ### Acties voor openstaande uitnodigingen Voor elke uitnodiging met de status `Verzonden` kunt u: - **Opnieuw versturen**: Laat de huidige uitnodiging automatisch verlopen en verstuurt een nieuwe uitnodigingsmail. - **Laten verlopen**: Maakt de openstaande uitnodiging onmiddellijk ongeldig zodat deze niet meer kan worden geaccepteerd. - **Verwijderen**: Verwijdert een nog niet geaccepteerde uitnodiging. *(Let op: **Geaccepteerde** uitnodigingen kunnen niet worden verwijderd, zodat er een permanent beveiligingslogboek behouden blijft van iedereen die toegang heeft gehad tot uw account.)* --- ## Ontvangen uitnodigingen accepteren of weigeren Wanneer een andere accounteigenaar u uitnodigt om lid te worden van zijn of haar team: 1. Log in op uw Rayo SMS-account. U krijgt direct bij het inloggen een melding, of u kunt navigeren naar **Geavanceerd -> Lid-uitnodigingen -> Ontvangen**. 2. Controleer de gegevens van het uitnodigende account en de toegewezen rol. 3. Klik op **Accepteren** om toegang te krijgen, of op **Weigeren** om de uitnodiging af te wijzen. --- ## Wisselen tussen accounts (`Wissel van account`) Zodra u een uitnodiging voor een of meer andere accounts heeft geaccepteerd, kunt u op elk moment van actieve werkruimte wisselen zonder uit te loggen: 1. Klik op uw **gebruikersnaam** linksboven in de zijbalk. 2. Selecteer **Wissel van account** (`/account_selection/new`). 3. Kies tussen **Uw account** (uw persoonlijke/primaire account) en **Andere accounts** (accounts waarvan u teamlid bent). 4. Klik op **Doorgaan**. De interface wordt onmiddellijk opnieuw geladen binnen de context van het geselecteerde account. --- ## Een actief teamlid verwijderen Als accounteigenaar kunt u de toegang van een teamlid op elk moment intrekken: 1. Klik in de bovenste navigatiebalk op **Geavanceerd -> Leden** (`/members`). 2. Zoek het actieve lid in de lijst. 3. Klik op **Verwijderen** om de toegang tot uw account onmiddellijk in te trekken. --- ## Sectie: Ontwikkelaars, API en webhooks (Developers & API — Dutch) ### API-overzicht en API-sleutels beheren Source: https://docs.rayosms.nl/nl/developers/api-overview-and-keys/ Description: Integreer Rayo SMS in uw applicaties met onze RESTful HTTP API, beheer tot 25 API-sleutels en verken de belangrijkste endpoints. Integreer Rayo SMS rechtstreeks in uw ERP, CRM, webshop, boekingsplatform of maatwerkapplicatie met onze snelle en betrouwbare **RESTful HTTP API**. > **TIP: Interactieve API-referentie** > Raadpleeg voor volledige request-/responseschema's, statuscodes, foutmeldingen en codevoorbeelden de **[Volledige Rayo SMS API-referentie](https://api-docs.rayosms.nl)** op `https://api-docs.rayosms.nl`. --- ## API-basis-URL Alle HTTP API-verzoeken moeten via **HTTPS** worden verzonden naar de volgende basis-URL: `https://api.rayosms.nl/v1` --- ## API-sleutels beheren U kunt uw API-inloggegevens beheren in de [Webapplicatie](https://sms.rayosms.nl) door te navigeren naar **Geavanceerd -> Instellingen -> API-sleutels** (`/settings/api_keys`). - **Automatische eerste sleutel**: Zodra uw account wordt aangemaakt, wordt er automatisch een eerste API-sleutel voor u gegenereerd. - **Tot 25 API-sleutels per account**: Klik op **API-sleutel genereren** om extra sleutels aan te maken (maximaal **25 sleutels**). Het gebruik van afzonderlijke sleutels wordt aanbevolen om productie-, test- en individuele microservices of externe integraties van elkaar te scheiden. - **Levenscyclusbeheer**: U kunt individuele API-sleutels op elk moment **Activeren**, **Deactiveren** of **Verwijderen** zonder dat dit invloed heeft op uw andere actieve sleutels. --- ## Authenticatie Elk API-verzoek moet via HTTPS een actieve API-sleutel bevatten in de HTTP-header `Authorization`: ```http Authorization: ****** Content-Type: application/json ``` > **CAUTION: Account en sleutel moeten beide actief zijn** > Om een API-verzoek te laten slagen, moeten **zowel** uw Rayo SMS-gebruikersaccount als de specifieke API-sleutel in de `Authorization`-header **Actief** zijn. Als een sleutel is gedeactiveerd, worden verzoeken met die sleutel onmiddellijk geweigerd. --- ## Overzicht van de belangrijkste endpoints Hieronder vindt u een overzicht van de primaire Rayo SMS API v1-endpoints. Ga naar de [Volledige Rayo SMS API-referentie](https://api-docs.rayosms.nl) voor gedetailleerde parameterspecificaties en voorbeeldpayloads. ### `POST /v1/send_sms` — Individuele, bulk- of geplande sms verzenden Verzendt een sms-bericht naar een of meer mobiele nummers en/of [Contactgroepen](https://docs.rayosms.nl/nl/contacts-and-groups/groups/). - **Ontvangers & groepen**: Geef een array van mobiele nummers, groeps-ID's of beide door (met automatische ontdubbeling en onderdrukking van contacten die zijn gemarkeerd als **Ongeldig**). - **Plannen (`scheduledAt`)**: Plan het bericht optioneel in voor toekomstige bezorging door een ISO-8601-tijdstempel mee te sturen. - **Idempotentie & tracking (`clientRequestId`)**: Geef uw eigen unieke referentie-ID mee om statuscontroles en [webhook-callbacks](https://docs.rayosms.nl/nl/developers/webhooks-and-callbacks/) aan elkaar te koppelen. - **Webhook-callbacks**: Schakel callbacks voor afleverstatussen per verzoek in. - **Gratis sandbox-testen (`simulateSendFlag`)**: Stel `simulateSendFlag: true` in om uw request-payload en integratie van begin tot eind te valideren tegen **0 credits** en zonder daadwerkelijke sms-berichten naar telefoons te sturen. ### `GET /v1/balance_in_credits` — Creditsaldo controleren Retourneert het huidige beschikbare sms-creditsaldo van uw account als een geheel getal (integer), zodat u het verbruik programmatisch kunt monitoren. ### `GET /v1/check_status` — Afleverstatus opvragen Haalt de huidige verwerkingsstatus en de afleverrapporten per ontvanger op van een eerder ingediend sms-verzoek door te zoeken op uw eigen `clientRequestId` of op het `smsServerRequestId` van Rayo SMS. ### `DELETE /v1/sms_request_schedules/:id` — Een geplande sms annuleren Annuleert en verwijdert een openstaand gepland sms-verzoek (`scheduledAt`) vóór het geplande uitvoeringstijdstip, waarbij eventueel gereserveerde credits vrijblijven. --- ### Aflever-callbacks (Webhooks) en handtekeningverificatie Source: https://docs.rayosms.nl/nl/developers/webhooks-and-callbacks/ Description: Configureer realtime HTTP webhook-callbacks voor sms-afleverstatussen, verifieer cryptografische handtekeningen en roteer ondertekeningsgeheimen zonder downtime. De **Rayo SMS Callback API** (Webhooks) stuurt uw server vrijwel in realtime automatisch een melding zodra een uitgaand sms-bericht een definitieve afleverstatus bereikt (`sent`, `delivered`, `not_delivered`, `unknown_delivery` of `failure`) — waardoor u niet langer periodiek `GET /v1/check_status` hoeft aan te roepen. --- ## Uw callback-endpoint configureren U kunt uw webhook-listener configureren en testen in de [Webapplicatie](https://sms.rayosms.nl) onder **Geavanceerd -> Instellingen -> Callbacks** (`/settings/callbacks`). 1. Ga naar **Geavanceerd** (bovenste balk) -> **Instellingen** -> **Callbacks** (`/settings/callbacks`). 2. Zet **Ingeschakeld** op **Ja**. 3. Voer in het veld **URL** (`Callback-URL`) de volledige **HTTPS**-URL van uw webhook-endpoint in. 4. Selecteer de gewenste **HTTP-methode** (`HTTP Verb`): `get` of `post`. 5. Klik op **Testen** om een live test-webhookverzoek vanuit Rayo SMS naar uw server te sturen. Controleer of uw endpoint antwoordt met HTTP `200 OK` en of de melding verschijnt: > `De Callback-API-eigenschappen lijken in orde te zijn` 6. Klik op **Opslaan** om uw configuratie op te slaan. > **NOTE: Callbacks uitschakelen** > Om geen webhook-meldingen meer te ontvangen en uw opgeslagen endpoint-instellingen te wissen, klikt u op **Callback-URL verwijderen en uitschakelen** op de instellingenpagina voor Callbacks. --- ## Webhook-handtekeningen verifiëren (`Signing Secret`) Omdat uw webhook-URL openbaar bereikbaar is via het internet, moet uw server controleren of elke binnenkomende callback daadwerkelijk afkomstig is van Rayo SMS en onderweg niet is gemanipuleerd of vervalst door een derde partij. - **Handtekeningheader**: Elk callback-HTTP-verzoek dat door Rayo SMS wordt verzonden, bevat een cryptografische handtekening in de HTTP-header `X-sms-rayosms-nl-Signature`. - **Ondertekeningsgeheim van het account (`Signing Secret`)**: De handtekening wordt berekend met het unieke **Signing Secret** van uw account (weergegeven naast `Signing Secret:` op de pagina **Geavanceerd -> Instellingen -> Callbacks**). - **Implementatiedetails**: Raadpleeg [de Callback-sectie in de API-referentie](https://api-docs.rayosms.nl) (`https://api-docs.rayosms.nl`) voor het exacte HMAC-verificatiealgoritme, de query-/body-parameters en het retry-gedrag. --- ## Ondertekeningsgeheim roteren zonder downtime (`Geheim laten verlopen`) Als uw beveiligingsbeleid periodieke sleutelrotatie vereist — of als u vermoedt dat uw huidige Signing Secret mogelijk is gelekt — kunt u een gecontroleerde vervaldatum instellen onder **Geavanceerd -> Instellingen -> Callbacks**: 1. Open **Geavanceerd -> Instellingen -> Callbacks** (`/settings/callbacks`). 2. Klik naast uw **Signing Secret** op **Geheim laten verlopen...**. 3. Selecteer wanneer het huidige geheim moet verlopen, zodat uw ontwikkelteam tijd heeft om de rotatie voor te bereiden. 4. Als u een geplande rotatie wilt afbreken voordat de timer afloopt, klikt u op **Geheim niet laten verlopen...** om het geplande verlopen te annuleren. 5. Zodra het ingestelde vervaltijdstip is bereikt, wordt het oude geheim automatisch buiten gebruik gesteld en wordt er onmiddellijk een **nieuw Signing Secret** gegenereerd. --- ## Sectie: Integraties (Integrations — Dutch) ### WSMS (WordPress & WooCommerce SMS) Source: https://docs.rayosms.nl/nl/integrations/wsms/ Description: Verstuur sms-meldingen, OTP/2FA-codes en marketingcampagnes vanuit WordPress en WooCommerce met de officiële Rayo SMS-integratie in WSMS. Rayo SMS is officieel geïntegreerd als ingebouwde sms-gateway in **[WSMS (voorheen WP SMS)](https://wsms.io)**, de toonaangevende sms- en berichtenplug-in voor WordPress en WooCommerce. Met deze integratie kunnen WSMS-gebruikers hun Rayo SMS-account rechtstreeks vanuit hun WordPress-dashboard koppelen — zonder code te schrijven — voor geautomatiseerde WooCommerce-bestel- en verzendmeldingen, tweefactorauthenticatie (2FA) en OTP-inloggen via sms, formuliermeldingen en gerichte bulk-sms-campagnes met snelle, betrouwbare levering en scherpe tarieven. - [Stel de Rayo SMS-gateway in binnen WSMS](https://wsms.io/docs/rayo-gateway-setup/): Volg de stapsgewijze instructies om uw Rayo SMS-account te koppelen aan WSMS. - [Bezoek WSMS (wsms.io)](https://wsms.io): Ontdek de functies en documentatie van de WSMS-plug-in voor WordPress & WooCommerce. --- ## Sectie: White-Label platform (White-Label — Dutch) ### White-Label partner- & resellerhandleiding Source: https://docs.rayosms.nl/nl/white-label/partner-guide/ Description: Exploiteer uw eigen Web-to-SMS SaaS-platform op de infrastructuur van Rayo SMS, ontvang klantbetalingen rechtstreeks en beheer gebruikersaccounts en bestellingen. Het **Rayo SMS White-Label Programma** stelt partners, bureaus, softwareleveranciers en telecom-wederverkopers in staat om hun eigen volledig gebrande Web-to-SMS SaaS-onderneming te exploiteren — onder hun eigen domeinnaam, logo, e-mailidentiteit en ondersteunde interfacetalen (**Engels**, **Grieks** en **Nederlands**) — terwijl alles draait op de infrastructuur van Rayo SMS. --- ## Hoe White-Label-saldi werken Als **Merkeigenaar** (`Brand Owner`) beschikt uw hoofdaccount over een **groothandelssaldo voor sms-credits**: - Wanneer een van uw klanten online credits koopt (of wanneer u handmatig credits toewijst aan een klant), wordt het bijbehorende aantal credits **automatisch overgeboekt van uw groothandelssaldo als merkeigenaar naar het saldo van de klant**. - Zorg ervoor dat uw hoofdaccount als merkeigenaar altijd voldoende groothandelscredits bevat, zodat kaartaankopen en kredietbestellingen van klanten probleemloos kunnen worden uitgevoerd. --- ## Rechtstreeks betalingen van klanten ontvangen White-Label-partners ontvangen 100% van de betalingen van hun klanten rechtstreeks op hun eigen Stripe- en bankrekeningen. #### Stripe-accounts (Online kaartbetalingen) Ga naar **Geavanceerd -> Stripe-accounts** in de bovenste balk: 1. Klik op **Stripe-account koppelen** om uw eigen zakelijke Stripe-account via OAuth te koppelen. 2. Klik na het koppelen op **Activeren**. 3. Alle online aankopen met betaal- of creditcard door uw klanten worden **rechtstreeks uitbetaald op uw Stripe-account**. #### Bankrekeningen (Bankoverschrijvingen) Ga naar **Geavanceerd -> Bankrekeningen** in de bovenste balk: 1. Voeg de bankrekeningen van uw bedrijf toe en beheer ze (`Naam bank`, `Rekeninghouder`, `IBAN`, `Land` en aanduiding `Particulier` / `Bedrijf`). 2. Actieve bankrekeningen worden automatisch aan uw klanten getoond op de afrekentabbladen **Bankstorting** en **Kopen op krediet**. --- ## Uw merkgegevens beheren (`Instellingen -> Merk`) Als **Merkeigenaar** (`Brand Owner`) kunt u de configuratie van uw merk op elk gewenst moment bekijken en bijwerken in de [Webapplicatie](https://sms.rayosms.nl) via **Geavanceerd -> Instellingen -> Merk**: - **Domeinen**: - **Website-URL**, **URL ontwikkelaarsdocumentatie**, **URL SDK-documentatie** en **URL applicatiedocumentatie**. - **URL Facebook-pagina**, **URL X-pagina** en **URL LinkedIn-pagina**. - **Host-header** en **E-mailadres afzender voor contact** worden **alleen-lezen** weergegeven (beheerd op het infrastructuurniveau van het platform). - **Namen**: - **Applicatienaam**: De volledige merknaam die wordt weergegeven in de interface, paginatitels en e-mails. - **Korte naam**: Maximaal 5 tekens, weergegeven wanneer de linkerzijbalk is ingeklapt. - **Communicatie**: - **Inloglogo**: Upload of vervang het logo dat op uw inlog- en openbare toegangspagina's wordt getoond. - **SMS-afzenderlabel**: Het standaard alfanumerieke afzenderlabel van uw merk (maximaal 11 tekens; mag geen mobiel nummer zijn). - **Contacten**: - **Geregistreerd adres**, **Contacttelefoonnummer** en **Naam CEO**. - **Overig**: - **Maximaal aantal credits op krediet**: Het vaste aantal credits dat direct wordt toegekend aan een in aanmerking komende klant van uw merk wanneer deze gebruikmaakt van **Kopen op krediet** (stel in op `0` om kopen op krediet uit te schakelen). - **Online aankoop**: Schakel online creditaankopen voor klanten van uw merk in of uit. - **Aangemaakt op** en **Bijgewerkt op** worden ter referentie als alleen-lezen velden getoond. Klik op **Opslaan** en bevestig de melding om uw wijzigingen direct door te voeren. --- ## De prijslijsten van uw merk definiëren (`Geavanceerd -> Prijslijsten`) Als **Merkeigenaar** (`Brand Owner`) kunt u de sms-creditprijzen voor uw merk definiëren en beheren via **Geavanceerd -> Prijslijsten** (`/price_lists`): - **Prijslijsten bekijken**: Alle prijslijsten van uw merk worden in oplopende volgorde van **Aantal credits** weergegeven (`ID`, `Aantal credits`, `Prijs`, `Btw berekenen`, `Btw-percentage`, `Aangemaakt op` en `Bijgewerkt op`). Een pakket met `number_of_credits = -1` geldt voor elk aantal credits en wordt weergegeven als **Elk**. - **Een prijslijst aanmaken**: Klik rechtsboven boven de tabel op **Nieuwe prijslijst** (`/price_lists/new`), vul het formulier in en klik op **Aanmaken** (en bevestig de melding): - **Aantal credits**: De pakketgrootte in credits (gebruik `-1` voor elk aantal credits). - **Prijs**: De prijs per credit **exclusief btw**. Als **Btw berekenen** is aangevinkt, wordt de btw berekend en bovenop deze prijs opgeteld. - **Btw berekenen**: Vink aan om btw bovenop de prijs per credit in rekening te brengen. - **Btw-percentage**: Het gehele btw-percentage (`0`–`100`). - **Een prijslijst bewerken of verwijderen**: Klik op een rij in de tabel met prijslijsten om de bewerkingspagina (`/price_lists/:id/edit`) te openen, waar u: - De prijsvelden kunt bijwerken en op **Opslaan** kunt klikken (met bevestiging) om uw wijzigingen op te slaan. - Op **Verwijderen** kunt klikken (met bevestiging) om de prijslijst van uw merk te verwijderen. --- ## Uw klanten beheren (Menu `Beheer`) Merkeigenaren hebben toegang tot een speciaal menu **Beheer** in de bovenste navigatiebalk van de [Webapplicatie](https://sms.rayosms.nl) om klantaccounts, creditbestellingen en belastingprofielen te beheren. ### 1. Gebruikers (`Beheer -> Gebruikers`) Onder **Beheer -> Gebruikers** heeft u overzicht over uw volledige klantenbestand: - **Zoeken & inspecteren**: Zoek klanten op **gebruikersnaam** of **contact-e-mailadres** en bekijk hun huidige sms-creditsaldo en activatietijdstempels. - **Accountstatus**: **Activeer** of **Deactiveer** elk klantaccount onmiddellijk. - **Instellingen per gebruiker**: - **Mag op krediet kopen**: Schakel het tabblad [Kopen op krediet](https://docs.rayosms.nl/nl/billing/purchasing-credits/) in of uit voor vertrouwde klanten die facturen achteraf per bankoverschrijving voldoen. - **Dagelijkse rapport-e-mail versturen**: Schakel geautomatiseerde dagelijkse overzichts-e-mails voor de gebruiker in of uit. - **Moet bedrijfsgegevens opgeven**: Bepaal of de gebruiker verplicht is om bevestigde bedrijfsgegevens te hebben voordat hij of zij live sms-berichten mag verzenden. ### 2. Gebruikersbestellingen (`Beheer -> Gebruikersbestellingen`) Onder **Beheer -> Gebruikersbestellingen** beheert u alle credittransacties van uw klanten: - **Bekijken & filteren**: Blader door alle creditaankopen binnen uw merk of filter bestellingen op een specifieke gebruiker. - **Handmatige toewijzing van bestellingen (`Nieuwe gebruikersbestelling`)**: Klik op **Nieuwe gebruikersbestelling** om handmatig credits toe te voegen aan het account van een klant (bijvoorbeeld na controle van een ontvangen **Bankstorting**) en voeg interne beheernotities (`Interne notities`) toe. - **Kredietbestellingen bevestigen (`Bevestigen`)**: Wanneer een klant gebruikmaakt van **Kopen op krediet** en de betaling vervolgens per bankoverschrijving voldoet, klikt u bij die bestelling op **Bevestigen** om deze als betaald te markeren en nieuwe kredietbestellingen voor die klant weer mogelijk te maken. ### 3. Bedrijfsgegevens van gebruikers (`Beheer -> Bedrijfsgegevens van gebruikers`) Onder **Beheer -> Bedrijfsgegevens van gebruikers** beoordeelt en beheert u de door uw klanten ingediende facturerings- en belastingprofielen: - Controleer nieuw ingediende bedrijfsprofielen (btw-nummer, belastingkantoor, officiële bedrijfsnaam, adres). - Markeer inzendingen als **Bevestigd** (`Bevestigd`) om live sms-verzending en facturering vrij te geven, of als **Afgewezen** (`Afgewezen`) als er correcties nodig zijn. - Werk namens een klant de bedrijfs- en belastinggegevens bij wanneer hun bedrijfsinformatie wijzigt. --- ## Sectie: Ondersteuning en probleemoplossing (Support & FAQ — Dutch) ### Veelgestelde vragen, probleemoplossing & ondersteuning Source: https://docs.rayosms.nl/nl/support/faq-and-contact/ Description: Veelgestelde vragen over accountverificatie, GSM-tekenlimieten, afzender-id's, facturering en hoe u contact opneemt met de 24/7 ondersteuning van Rayo SMS. Vind snel antwoord op veelgestelde vragen over het gebruik van Rayo SMS, of neem contact op met ons 24/7 ondersteunings- en engineeringteam. --- ## Account & verificatie ### Waarom kan ik niet meteen na mijn registratie sms-berichten verzenden? Voordat u live sms-berichten naar mobiele telefoons kunt verzenden, moet uw account aan drie voorwaarden voldoen: 1. **Bevestigde bedrijfsgegevens**: Uw ingediende facturerings-/bedrijfsprofiel moet zijn beoordeeld en gemarkeerd als **Bevestigd**. 2. **Bevestigde & actieve afzender-id**: U moet ten minste één [Afzender-identificatie](https://docs.rayosms.nl/nl/sender-ids/managing-sender-ids/) hebben die zowel **Bevestigd** als **Actief** is (`Bruikbaar? = Ja`). 3. **Beschikbare credits**: Uw account moet een positief sms-creditsaldo hebben. *Tip:* Terwijl u wacht op de bevestiging van uw bedrijfsgegevens of voordat u credits koopt, kunt u zowel de Webapplicatie als de HTTP API volledig testen met de **Simulatiemodus** (`simulateSendFlag`), die `0` credits verbruikt. ### Hoe werk ik mijn bevestigde bedrijfsgegevens bij? Zodra uw bedrijfsgegevens zijn bevestigd, worden ze in de gebruikersinterface vergrendeld om de fiscale en factureringsintegriteit te waarborgen. Om een wijziging aan te vragen (zoals een nieuw adres, nieuwe bedrijfsnaam of gewijzigd btw-nummer), dient u een verzoek in via het **Contact**-formulier in de applicatie of via de [Contactpagina](https://sms.rayosms.nl/set_locale?locale=nl&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us). ### Hoe wijzig ik de taal van de webapplicatie en systeem-e-mails? Klik op uw **gebruikersnaam** linksboven in de zijbalk, selecteer **Voorkeuren** (`/preferences`), kies uw gewenste **Taal** (**Engels**, **Grieks** of **Nederlands**) en klik op **Opslaan**. Uw keuze past de webinterface onmiddellijk aan, blijft behouden bij toekomstige inlogsessies en zorgt ervoor dat alle geautomatiseerde systeem-e-mails in de door u gekozen taal worden verzonden. Zie [Uw account aanmaken en openen](https://docs.rayosms.nl/nl/getting-started/account-and-login/#gebruikersvoorkeuren--taalvoorkeur-preferences). --- ## Berichten & tekentelling ### Waarom telde mijn bericht als 2 of meer credits? Een standaard enkelvoudige sms ondersteunt maximaal **160 tekens** (1 credit). Wanneer een bericht langer is dan 160 tekens (tot het maximum van 1.000 tekens), wordt het opgesplitst in gekoppelde segmenten van **153 tekens per deel** (omdat er 7 tekens aan headergegevens nodig zijn om het bericht op het toestel van de ontvanger weer samen te voegen). Elk segment van 153 tekens verbruikt 1 credit per ontvanger. Zie [Tekenlimieten, codering en kostenberekening](https://docs.rayosms.nl/nl/messaging/length-and-encoding/). ### Waarom kan ik niet meer dan 500 nummers in het veld Ontvangers plakken? Het handmatige tekstvak voor ontvangers in het scherm **Bericht versturen** accepteert maximaal **500 mobiele nummers** per verzending. Om een campagne naar **meer dan 500 ontvangers** tegelijk te sturen, importeert u uw nummers in een [Contactgroep](https://docs.rayosms.nl/nl/contacts-and-groups/groups/) en selecteert u die groep bij het verzenden. ### Waarom werd een bericht geblokkeerd als duplicaat? Om onbedoelde dubbele verzendingen te voorkomen en uw credits te beschermen, blokkeert Rayo SMS het verzenden van **exact dezelfde sms-tekst** naar **hetzelfde mobiele nummer** binnen een **tijdsbestek van 6 uur** (`has already been sent this message within the last 6 hours`). Als u binnen 6 uur nog een bericht naar hetzelfde nummer wilt sturen, wijzigt u de berichttekst (bijvoorbeeld door een unieke code, tijdstempel of andere formulering op te nemen). --- ## Afzender-identificaties (Afzender-id's) ### Waarom kan ik een afzender-id niet verwijderen? Een afzender-identificatie kan alleen worden verwijderd als deze **nog nooit** is gebruikt om een sms te verzenden. Zodra een afzender-id bij ten minste één aflevering is gebruikt, kan deze niet meer worden verwijderd (`Kan niet worden verwijderd omdat deze in het verleden is gebruikt voor sms-bezorging`) om de historische aflever- en auditlogboeken intact te houden. Klik in plaats daarvan op **Deactiveren** om de afzender-id voor actief gebruik te verbergen. Zie [Afzender-identificaties beheren](https://docs.rayosms.nl/nl/sender-ids/managing-sender-ids/). ### Waarom kon ik na mijn nieuwe mobiele afzender-id geen tweede aanmaken? Er kan slechts **één** mobiel telefoonnummer tegelijk als afzender-identificatie de status `pending_confirmation` hebben. U moet eerst het openstaande mobiele nummer bevestigen met de **5-cijferige sms-code** die naar uw telefoon is gestuurd, of **15 minuten** wachten totdat de openstaande bevestiging automatisch verloopt voordat u een ander mobiel nummer kunt registreren. --- ## Facturering & credits ### Waarom heb ik iets minder credits ontvangen bij betaling met een kaart? Bij online kaartbetalingen worden betalingsverwerkingskosten in rekening gebracht, die worden verrekend als een klein aantal credits (het afrekenscherm toont het geschatte netto aantal credits voordat u de betaling voltooit). Om 100% van uw bestelde credits met **nul verwerkingskosten** te ontvangen, kiest u voor **Bankstorting** of **Kopen op krediet** op de pagina [Credits bestellen](https://docs.rayosms.nl/nl/billing/purchasing-credits/). ### Verlopen sms-credits? **Ja.** Gekochte sms-credits zijn **1 jaar (365 dagen)** geldig vanaf de aankoopdatum. Eventuele credits die na 365 dagen ongebruikt zijn, komen te vervallen. --- ## Contact opnemen met Rayo SMS-ondersteuning #### Contactformulier in de app & op de website Ingelogde gebruikers kunnen in de linkerzijbalk op **Contact** (`/contact_us_requests/new`) klikken om ons team rechtstreeks een bericht te sturen met hun accountgegevens automatisch bijgevoegd, of gebruikmaken van onze openbare pagina [Neem contact op](https://sms.rayosms.nl/set_locale?locale=nl&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fcontact_us). #### 24/7 livechat & technische ondersteuning Ons ondersteuningsteam is **24/7** bereikbaar via de livechat op onze [officiële website](https://www.rayosms.nl). Daarnaast bieden wij directe **developer-to-developer technische ondersteuning** voor maatwerk HTTP API- en White-Label-integraties. ### Juridisch & algemene voorwaarden Raadpleeg voor alle commerciële voorwaarden, het privacybeleid en de regels voor acceptabel gebruik onze [Algemene voorwaarden van de dienst](https://sms.rayosms.nl/set_locale?locale=nl&return_back_to=https%3A%2F%2Fsms.rayosms.nl%2Fterms_and_conditions_of_service). ---