Frequently Asked Questions
Answers to common questions about teammessage
? Getting Started
Are there any signup fees?
No. Registration is free and you receive 20 SMS credits to test the service.
Can I test the service without obligation?
Yes. Use your 20 free SMS credits without any commitment. No credit card required.
Is there a minimum purchase for the EASY tariff?
No minimum quantity required. You receive 20 free test SMS after registration. When you reach 5 remaining SMS (configurable), you will automatically receive an offer to purchase more.
How do I send my first SMS?
There are three ways to send SMS with TeamMessage:
- Via Email: Send an email to your personal TeamMessage address (e.g., myteam@tmsg.de). The email content is automatically converted to SMS.
- Via Dashboard: Log in to your dashboard and use the 'Send SMS' function.
- Via API: Integrate SMS sending into your applications using our REST API.
What is a team list?
A team list is a group of recipients (team members) who receive messages sent to a specific email address. Each team list has its own @tmsg.de address and can contain multiple recipients with different channels (SMS, Email, Voice, etc.).
Do prices apply worldwide?
Our prices apply internationally to all networks. For unusually high volume to expensive destinations, we may contact you to discuss options.
? Channels
What is SMS (text message)?
SMS is the most reliable channel for urgent notifications. Key features:
- 98% of SMS are read within 3 minutes
- Works without internet connection
- Reaches all mobile phones, including older devices
- Up to 1530 characters per message (10 SMS concatenated)
Cost: from 9 ct per SMS to German networks.
What is Voice (text-to-speech)?
Voice messages convert your text to a phone call. The recipient's phone rings and the message is read aloud. Ideal for:
- Night-time alerts when phones are on silent
- Reaching landline phones without SMS capability
- High-priority notifications that require immediate attention
The system automatically retries if the call is not answered. Cost: from 27 ct per call.
What is Fax?
Fax converts your message into a fax document and sends it to a fax number. Useful for:
- Reaching organizations that still rely on fax
- Sending documents to fax machines
- Legal or compliance scenarios requiring fax confirmation
Cost: from 27 ct per fax page.
What is Telegram?
Telegram integration sends your messages as push notifications via the Telegram messenger app. Benefits:
- Instant push notifications
- Rich message formatting supported
- Recipients need the Telegram app installed
What is Pushover?
Pushover is a simple push notification service for iOS, Android, and desktop. Benefits:
- Priority levels for different urgency
- Customizable notification sounds
- Recipients need the Pushover app (one-time purchase)
Can I use multiple channels for the same recipient?
Yes! Each team member can have multiple channels configured. For example, you might send via Telegram first, and if that fails, automatically fall back to SMS. This is configured in the team member settings.
Are Signal and WhatsApp supported?
Signal and WhatsApp integration are currently in development and will be available soon. These messengers have stricter API requirements, but we are working on compliant solutions.
Can incoming SMS be forwarded to email?
Yes, we offer several options for receiving SMS:
- sms2team: Send SMS to our gateway number +4915123710560 to reach your team
- sms2mail: Forward incoming SMS to your email address (free or with dedicated number)
Contact support for pricing on dedicated mobile numbers.
Features
What is mail2team?
mail2team is the core feature of TeamMessage. Send an email to your team address (e.g., myteam-alerts@tmsg.de), and all team members receive the message on their configured channels.
Perfect for:
- Server monitoring alerts
- Automated notifications from any system that can send email
- Team-wide announcements
What is http2sms (API)?
http2sms is our REST API for sending SMS directly from your applications. Features:
- Simple HTTP POST request
- JSON response with status codes
- Delivery status callbacks (webhooks)
- OpenAPI/Swagger documentation
- IP whitelist for security
What is sms2mail (bidirectional SMS)?
With sms2mail, you can receive SMS replies to your messages. When a recipient replies to your SMS, their response is forwarded to your email address.
This feature requires a dedicated mobile number, which is available as an add-on. Contact support for pricing.
What is mail2voice?
mail2voice converts incoming emails to voice calls. Send an email, and the recipient receives a phone call with the message read aloud. Useful for reaching people on landlines or for high-priority alerts.
What is the scheduled messages feature (Terminliste)?
The scheduled messages feature allows you to plan SMS sends in advance. Use cases:
- Appointment reminders (e.g., 24 hours before)
- Recurring notifications
- Campaign messages at specific times
Can I customize the SMS sender ID?
Yes, you can set a custom sender ID (alphanumeric, up to 11 characters) for your SMS. Note that some countries restrict alphanumeric sender IDs, and recipients cannot reply to alphanumeric senders.
How do I forward incoming emails to my mobile phone?
To forward emails to SMS:
- Create a team list (e.g., myteam-forwarder@tmsg.de)
- Add your mobile number as a recipient
- Set the list as 'open group' to allow external senders
- Set up a forwarding rule in your email client to send to the team address
Settings
How do I disable message forwarding for a team member?
Go to 'Team List' in your dashboard, select the member, and disable 'Receive TeamMessages'. The member will remain in the list but won't receive notifications.
What is a closed group vs open group?
Team lists can be configured as:
- Closed group: Only authorized senders (listed in the team) can send messages. Unknown senders are rejected.
- Open group: Anyone can send messages to the team address. Useful for public contact addresses or email forwarding.
How does sender authentication with keywords work?
For closed groups, you can require a keyword in the email subject for authentication. This allows:
- Senders not in the team list to send if they know the keyword
- Additional security layer beyond sender address verification
Configure the keyword in your team list settings.
Can I limit the email size for SMS conversion?
Yes, you can set a maximum size for emails to be converted to SMS. Emails exceeding this size will be forwarded by email only. Set to 0 to allow attachments (which are stripped for SMS).
Technical
Which email servers are supported?
Any email server that can send to external addresses works with TeamMessage. Requirements:
- Valid DNS reverse lookup (PTR record)
- IP address must resolve to hostname
- Valid FQDN in HELO/EHLO
This prevents spam and ensures reliable delivery.
How does IP whitelist work?
The IP whitelist restricts API access to specific IP addresses. Supported formats:
- Single IPv4 address:
10.0.0.1 - Single IPv6 address:
2001:db8::1 - CIDR notation:
192.168.1.0/24 - Multiple addresses separated by comma, semicolon, or space
What are the API rate limits?
Standard accounts allow up to 60 requests per minute. Higher limits are available for enterprise customers. Contact support for custom rate limits.
How long are SMS stored in the log?
SMS logs are retained for 90 days. After that, individual message content is deleted, but aggregated statistics remain available.
Is the API available via IPv6?
Yes, our API fully supports IPv6. Both the email gateway and the REST API are accessible via IPv4 and IPv6.
How do delivery status callbacks work?
When you send an SMS via API, you can specify a callback URL. We will send an HTTP POST request to this URL when:
- The SMS is delivered to the recipient's phone
- The SMS delivery fails
- The SMS expires (not delivered within 48 hours)
Why are emails with 'TeamMessage.de' in the subject deleted?
To prevent mail loops, we automatically filter emails containing 'TeamMessage.de' in the subject line. Move this text to the message body instead.
Which file attachments are filtered?
For security reasons, potentially dangerous file types are automatically filtered: .exe, .scr, .bat, .cmd, .com, .pif, and similar executables. These are stripped and the admin is notified.
? Billing
What happens when my SMS credits run out?
You will receive an offer to purchase more credits at a configurable threshold. With direct debit authorization, you can continue sending even with a negative balance. Without it, you need to wait for payment processing.
How do I ensure uninterrupted SMS delivery?
Three options:
- Option A: Set a high threshold for new offers to have plenty of lead time
- Option B: Provide direct debit authorization for automatic payment
- Option C: Switch to PROFI tariff with monthly billing based on usage
Can I just transfer money without an invoice?
No, please wait for an offer or invoice. However, you can control when you receive it by adjusting your credit threshold settings.
What tariff types are available?
We offer three tariff types:
- EASY (Prepaid): Pay as you go. Purchase credits when you need them.
- PAUSCHAL (Flatrate): Monthly package with included SMS. Overage charged separately.
- PROFI (Postpaid): Enterprise plan with monthly billing. No prepayment required.
How much does an SMS cost?
SMS prices depend on the destination network:
- Germany: from 9 ct per SMS
- Austria/Switzerland: from 12 ct per SMS
- Other countries: varies by destination
Long messages (over 160 characters) are split into multiple SMS and charged accordingly.
Can I get an invoice?
Yes, all purchases include a proper invoice with VAT. Invoices are available for download in your dashboard under 'Billing'.
Do credits expire?
Prepaid credits are valid for 24 months from purchase date. After that, unused credits expire. We send a reminder email 30 days before expiration.
Troubleshooting
Error '-10: account not found' with http2sms gateway
The http2sms API must be activated for your account. Send an email with your customer number to support@teammessage.de. Activation is free and serves as a security measure against unauthorized access.
My SMS is not being delivered. What can I do?
Check the following:
- View the SMS log in your dashboard for the delivery status
- Verify the phone number is correct and in international format (+49...)
- Check if you have sufficient SMS credits
- Ensure the recipient's phone can receive SMS
If the problem persists, contact our support with the message ID from the SMS log.
Emails are rejected by the mail server
Your mail server must be properly configured:
- IP address must resolve to hostname (forward DNS)
- Hostname must resolve back to IP (reverse DNS / PTR)
- Valid fully qualified domain name (FQDN) in HELO command
Contact your mail server administrator to verify these settings.
Error 'NO SEND PERMISSION'
For closed groups, you must be registered in the team list with send permission. Ask your team administrator to add you or verify your permissions.
Error 'UNAUTHORIZED SEND ATTEMPT'
The sender is not listed in the team list, or the required authentication keyword is missing from the subject line. Add the keyword or ask to be added to the sender list.
My email is not converted to SMS. What's wrong?
Common causes:
- Email exceeds size limit for SMS conversion – adjust in settings
- Sender email not authorized – add it to your team's allowed senders
- Missing DNS reverse lookup (PTR record) on your mail server
- Email flagged as spam – check our spam filter settings
- Team list is deactivated – check your dashboard
I receive error code -12 (IP not allowed)
Your IP address is not in the whitelist. Add your server's IP address to the team list's IP whitelist in the dashboard settings. Remember to include both IPv4 and IPv6 if applicable.
Voice call is not delivered
Voice calls may fail due to:
- Recipient does not answer – the system retries automatically
- Invalid phone number
- Recipient's phone is switched off
- Network congestion
Check the delivery log for the specific SIP response code. Common codes:
200– Success480– Temporarily unavailable486– Busy404– Number not found
? Developers
How do I send SMS from PHP?
Two methods available:
Method 1: Via Email
<?php
mail(
"team@tmsg.de",
"Alert",
"Server CPU over 90%"
);
?>
Method 2: Via HTTP API
<?php
$data = [
'tm' => '100031',
'tn' => 'team@tmsg.de',
'ky' => 'secret',
'tsms' => '+491701234567',
'msg' => 'Server alert'
];
$ch = curl_init('https://teammessage.de/api/v1/sms/send/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
?>
How do I configure NAGIOS for SMS alerts?
Set your team email address (e.g., myteam-alerts@tmsg.de) as the contact email in NAGIOS. Define notification timeperiods to control when SMS are sent. The email-to-SMS gateway handles the conversion automatically.
Can I send SMS when a web form is submitted?
Yes, use the PHP mail() function to send to your team address. Example:
<?php
if ($_POST['submit']) {
$name = htmlspecialchars($_POST['name']);
mail(
"myteam-alerts@tmsg.de",
"New form submission",
"New contact from: $name"
);
}
?>
Make sure the sending email address is authorized in your team list settings.
PHP include() for SMS list not working
Enable in php.ini: 'allow_url_include = On' and 'allow_url_fopen = On'. Note: For security reasons, using the HTTP API is recommended instead.
What API response codes should I handle?
Common response codes:
+1– Success-10– Account not found (check tm/tn parameters)-11– SMS sending disabled for this account-12– IP address not in whitelist