Skip to main content

How to Connect SMS Planet to Theraplo

Integrating SMS Planet with Theraplo allows you to automatically send appointment reminders, payment notifications, and other SMS messages to your clients directly from Theraplo.

Below is the complete step-by-step setup guide.


Step 1: Create an SMS Planet Account

  1. Go to the SMS Planet website.

  2. Click Register and complete the account creation process.

  3. After logging in, accept the required agreements (GDPR, security, etc.).

Once your account is active, you can proceed with the API configuration.


Step 2: Generate an API Token in SMS Planet

  1. In the SMS Planet panel, go to API.

  2. Select API Tokens.

  3. Click Create Token.

  4. Enter a name (e.g., “Theraplo”).

  5. Set the validity to unlimited (recommended).

  6. Copy the generated token to your clipboard.

You will need this token inside Theraplo.


Step 3: Add the API Token in Theraplo

  1. Log in to your Theraplo account.

  2. Go to:
    Settings → System → API Integrations

  3. Locate SMS Planet – API Token.

  4. Paste the copied token.

  5. Click Add / Update.

  6. Wait for the green confirmation message indicating that the data has been saved.

This connects Theraplo to your SMS Planet account.


Step 4: Configure the Sender Number

  1. In SMS Planet, go to:
    Messaging → Received Messages → Settings

  2. Copy your Sender ID / phone number.

Then:

  1. In Theraplo, find the field SMS Planet – Phone Number.

  2. Paste the sender number.

  3. Click Add / Update.

  4. Wait for the confirmation message.

If the sender ID is incorrect, messages may fail or be rejected.


Step 5: Set the Webhook URL

When your Theraplo account is created, you receive a dedicated webhook URL.

  1. In SMS Planet, paste the provided URL into the webhook field.

  2. Click Save.

  3. Confirm that the system displays a success message.

The webhook is necessary to receive delivery status updates back into Theraplo.


Step 6: Activate Your Business Account in SMS Planet

Before sending SMS messages in production:

  1. Go to Messaging → Send SMS.

  2. Open My Account.

  3. Enter your company details (VAT number, official company data).

  4. Click Save.

Without completing this step, SMS sending may remain restricted.


Step 7: Optional but Recommended Settings

Inside My Account, you can configure:

⏰ Sending Time Window

Restrict SMS sending to business hours (e.g., 8:00–17:00).

🔒 Sending Block

Temporarily disable outgoing messages if needed.

🔔 Low Balance Alerts

Set a threshold (e.g., 5 credits) to receive email notifications when your balance is low.

If your account runs out of credits, Theraplo will not be able to send SMS messages.


Final Test

After completing the integration:

  1. Create a test appointment in Theraplo.

  2. Enable SMS notification.

  3. Verify that:

    • The SMS is delivered.

    • The delivery status is returned correctly.

If messages fail:

  • Recheck the API token.

  • Verify the sender number.

  • Confirm that your SMS Planet account has sufficient credits.

  • Make sure the webhook URL is correctly configured.


Summary

To connect SMS Planet with Theraplo, you need:

  1. API Token

  2. Sender Number

  3. Webhook URL

Everything else is operational configuration.

If needed, this can also be prepared as a shortened onboarding checklist or formatted for your public Knowledge Base.

Did this answer your question?