sms compliance
sms compliance
Guatemala SMS Best Practices, Compliance, and Features
Complete guide to SMS messaging in Guatemala including compliance requirements, carrier capabilities, and API integration examples.
Guatemala SMS Best Practices, Compliance, and Features
Guatemala SMS Market Overview and Requirements
| Locale name: | Guatemala |
|---|---|
| ISO code: | GT |
| Region | Central America |
| Mobile country code (MCC) | 704 |
| Dialing Code | +502 |
Market Conditions: Three major operators dominate Guatemala's mobile market: Tigo, Claro, and Movistar. While WhatsApp is popular in urban areas, SMS remains essential for business communications and reaching rural populations with limited data connectivity. Android devices account for approximately 85% of mobile devices.
SMS Features and Capabilities for Guatemala
Guatemala supports basic SMS functionality with limited advanced features. Business communications focus primarily on one-way messaging.
Two-way SMS Support
Standard A2P channels in Guatemala do not support two-way SMS. For interactive messaging, work with local aggregators or use alternative communication methods.
Concatenated Messages (Segmented SMS)
Support: Not officially supported.
Message length limits:
- GSM-7 encoding: 160 characters
- Unicode (UCS-2): 70 characters
Encoding: Use GSM-7 for optimal delivery and cost-effectiveness. Both GSM-7 and UCS-2 encodings are supported.
MMS Support
MMS messages automatically convert to SMS with an embedded URL link. Use URL shorteners and ensure your media content is mobile-optimized.
Phone Number Format and Compatibility
Number Portability
Not available in Guatemala. Phone numbers remain tied to their original carrier, ensuring more reliable message routing and delivery.
Sending SMS to Landlines
Not supported. Messages sent to landline numbers fail and may trigger API error responses (for example, Twilio error code 21614).
Compliance and Regulatory Guidelines for SMS in Guatemala
The Superintendencia de Telecomunicaciones (SIT) governs SMS regulations in Guatemala. Adhere to general consumer protection laws and telecommunications regulations. The regulatory framework focuses on protecting consumer rights and preventing spam.
Consent and Opt-In
Explicit Consent Requirements:
- Obtain written or digital confirmation before sending marketing messages
- Disclose message frequency and content type clearly
- Maintain consent documentation for at least 2 years
- Include timestamp, source, and scope of permission in consent records
Best Practices for Obtaining Consent:
- Use double opt-in verification
- Provide clear terms and conditions
- Maintain detailed consent logs
- Run consent refresh campaigns every 12 months
HELP/STOP and Other Commands
- Support STOP, CANCELAR, and NO in both English and Spanish
- Provide AYUDA (HELP) responses with service information in Spanish
- Make keywords case-insensitive
- Process opt-out requests immediately
- Send confirmation messages in the user's preferred language
Do Not Call / Do Not Disturb Registries
Guatemala does not maintain an official DND registry. Maintain your own suppression lists and:
- Honor opt-out requests within 24 hours
- Implement automated opt-out processing
- Clean contact lists regularly
- Share opt-out lists across campaigns and platforms
Time Zone Sensitivity
Guatemala uses Central Time (UTC-6). No strict time restrictions exist, but follow these recommended sending hours:
- Weekdays: 8:00 AM – 8:00 PM CT
- Weekends: 9:00 AM – 6:00 PM CT
- Holidays: Avoid unless urgent
- Emergency messages: Send anytime
SMS Sender ID Options and Phone Number Types in Guatemala
Alphanumeric Sender ID
Operator network capability: Supported with limitations
Registration requirements: None
Sender ID preservation: Not guaranteed. Carriers may overwrite with a random domestic longcode.
Best practice: Use consistent sender IDs across campaigns
Long Codes
Domestic vs. International:
- Domestic long codes: Not supported
- International long codes: Fully supported
Sender ID preservation: No – carriers typically overwrite
Provisioning time: 1–2 business days
Use cases:
- Transactional messages
- Two-factor authentication
- Customer support communications
Short Codes
Not available in Guatemala.
Restricted SMS Content, Industries, and Use Cases
Prohibited Content:
- Gambling and betting services
- Adult or explicit content
- Unauthorized pharmaceutical promotions
- Political campaign messages without proper authorization
- Fraudulent or misleading content
Regulated Industries:
- Financial services: Require additional disclaimers
- Healthcare: Must comply with privacy regulations
- Insurance: Need clear terms and conditions
Content Filtering
Known Carrier Filters:
- URLs from suspicious domains
- Multiple exclamation marks or all-caps text
- High-frequency identical messages
- Restricted keywords
Best Practices to Avoid Filtering:
- Use approved URL shorteners
- Maintain consistent sending patterns
- Avoid excessive punctuation
- Include a clear business identifier
- Keep content professional
Best Practices for Sending SMS in Guatemala
Messaging Strategy
- Keep messages under 160 characters when possible
- Include a clear call-to-action
- Use personalization tokens thoughtfully
- Maintain consistent brand voice
- Include your business name in messages
Sending Frequency and Timing
- Limit to 4–5 messages per month per recipient
- Respect local holidays and cultural events
- Implement frequency capping
- Space out messages appropriately
Localization
Primary language: Spanish
Localization considerations:
- Consider indigenous languages for specific regions
- Use local date and time formats
- Adapt content for cultural context
- Test translations with native speakers
Opt-Out Management
- Process opt-outs within 24 hours
- Maintain a centralized opt-out database
- Send opt-out confirmation messages
- Audit opt-out lists regularly
- Train staff on opt-out procedures
Testing and Monitoring
- Test across all major carriers (Tigo, Claro, Movistar)
- Monitor delivery rates by carrier
- Track engagement metrics
- Run regular A/B tests on message content
- Document and analyze failure patterns
SMS API integrations for Guatemala
Twilio
Twilio provides a robust SMS API with comprehensive support for Guatemala. Integration requires an account SID and auth token for authentication.
Key Parameters:
from: Your Twilio phone number (must be in E.164 format)to: Recipient's number (must include +502 prefix for Guatemala)body: Message content (supports UTF-8 encoding)
import { Twilio } from 'twilio';
// Initialize Twilio client
const client = new Twilio(
process.env.TWILIO_ACCOUNT_SID,
process.env.TWILIO_AUTH_TOKEN
);
async function sendSMSToGuatemala(
to: string,
message: string
): Promise<void> {
try {
// Ensure number starts with Guatemala country code
const formattedNumber = to.startsWith('+502') ? to : `+502${to}`;
const response = await client.messages.create({
body: message,
from: process.env.TWILIO_PHONE_NUMBER,
to: formattedNumber,
// Enable delivery tracking
statusCallback: 'https://your-webhook.com/status'
});
console.log(`Message sent successfully! SID: ${response.sid}`);
} catch (error) {
console.error('Error sending message:', error);
throw error;
}
}Sinch
Sinch offers direct carrier connections in Guatemala with support for both SMS and number verification services.
Key Parameters:
serviceplanId: Your Sinch service plan IDapiToken: Bearer token for authenticationdestination: Recipient number in E.164 format
import axios from 'axios';
class SinchSMSService {
private readonly baseUrl: string;
private readonly headers: Record<string, string>;
constructor(serviceplanId: string, apiToken: string) {
this.baseUrl = `https://sms.api.sinch.com/xms/v1/${serviceplanId}`;
this.headers = {
'Authorization': `Bearer ${apiToken}`,
'Content-Type': 'application/json'
};
}
async sendSMS(to: string, message: string): Promise<void> {
try {
const response = await axios.post(
`${this.baseUrl}/batches`,
{
from: process.env.SINCH_SENDER_ID,
to: [to],
body: message
},
{ headers: this.headers }
);
console.log('Message sent:', response.data.id);
} catch (error) {
console.error('Sinch SMS error:', error);
throw error;
}
}
}MessageBird
MessageBird provides reliable SMS delivery in Guatemala through their global messaging API.
Key Parameters:
apiKey: Your MessageBird API keyoriginator: Sender ID or phone numberrecipients: Array of recipient numbers
import messagebird from 'messagebird';
class MessageBirdService {
private client: any;
constructor(apiKey: string) {
this.client = messagebird(apiKey);
}
sendSMS(to: string, message: string): Promise<void> {
return new Promise((resolve, reject) => {
this.client.messages.create({
originator: 'YourCompany',
recipients: [to],
body: message,
datacoding: 'auto' // Automatic encoding detection
}, (err: any, response: any) => {
if (err) {
reject(err);
} else {
resolve(response);
}
});
});
}
}SMS API Rate Limits and Throughput for Guatemala
Guatemala-specific considerations for SMS API integration:
Rate Limits:
- Twilio: 250 messages per second
- Sinch: 30 messages per second
- MessageBird: 100 messages per second
Throughput Management Strategies:
- Implement exponential backoff for retries
- Use queue systems (for example, Redis or RabbitMQ)
- Batch messages when possible
- Monitor delivery rates by carrier
Error Handling and Reporting
Common Error Scenarios:
- Invalid phone numbers
- Network timeouts
- Carrier rejections
- Rate limit exceeded
Best Practices:
interface SMSError {
code: string;
message: string;
timestamp: Date;
recipient: string;
}
class SMSErrorHandler {
static handleError(error: SMSError): void {
// Log error details
console.error(`SMS Error [${error.code}]:`, {
message: error.message,
recipient: error.recipient,
timestamp: error.timestamp
});
// Implement retry logic for specific error codes
if (this.isRetryableError(error.code)) {
// Add to retry queue
}
// Alert on critical errors
if (this.isCriticalError(error.code)) {
// Send alert to monitoring system
}
}
private static isRetryableError(code: string): boolean {
const retryableCodes = ['TIMEOUT', 'RATE_LIMIT', 'TEMPORARY_FAILURE'];
return retryableCodes.includes(code);
}
private static isCriticalError(code: string): boolean {
const criticalCodes = ['INVALID_CREDENTIALS', 'ACCOUNT_SUSPENDED'];
return criticalCodes.includes(code);
}
}Recap and Additional Resources
Key Takeaways
-
Compliance Priorities:
- Obtain explicit consent
- Honor opt-out requests
- Maintain proper documentation
-
Technical Considerations:
- Use E.164 number formatting
- Implement proper error handling
- Monitor delivery rates
-
Best Practices:
- Send during business hours
- Localize content
- Maintain clean contact lists
Next Steps
- Review SIT (Superintendencia de Telecomunicaciones) regulations
- Consult with local legal counsel
- Set up test accounts with your preferred SMS providers
- Implement monitoring and reporting systems
Additional Resources
- SIT Official Website – Official regulatory body for telecommunications
- Guatemala Telecommunications Law – Complete legal framework
- SMS Provider Documentation:
- Twilio Guatemala Guidelines – Country-specific requirements
- Sinch API Documentation – API reference and integration guides
- MessageBird API Reference – Complete API documentation
Frequently Asked Questions
How to send SMS messages in Guatemala using Twilio?
Use the Twilio SMS API with parameters like 'from' (your Twilio number), 'to' (recipient's number with +502 prefix), and 'body' (message content). Ensure the recipient's number starts with +502 and utilize a status callback for delivery tracking. Refer to the provided code example for a practical implementation in TypeScript.
What are the SMS compliance requirements for Guatemala?
Key requirements include obtaining explicit consent before sending marketing messages, honoring opt-out requests (STOP, CANCELAR, NO in English and Spanish), and maintaining documentation of consent for at least two years. While Guatemala doesn't have a DND registry, maintaining your own suppression list is crucial.
What SMS features are supported in Guatemala?
Basic one-way SMS is supported. Two-way SMS, concatenated messages, and short codes are not supported. MMS messages are automatically converted to SMS with a URL link to the media content. Number portability is also not available.
Why does Guatemala convert MMS to SMS?
MMS is converted to SMS with a URL link to ensure message delivery, especially considering varying data connectivity across the country. This method allows sharing rich media content while leveraging the reliability of SMS.
What are the best practices for sending SMS in Guatemala?
Keep messages concise (under 160 characters), include a clear call to action, personalize content thoughtfully, and use a consistent brand voice. Respect local holidays and time zones, limiting messages to 4-5 per month per recipient.
How to handle SMS API rate limits in Guatemala?
Providers like Twilio, Sinch, and MessageBird have rate limits. Implement strategies like exponential backoff for retries, use queue systems (e.g., Redis, RabbitMQ), batch messages, and monitor delivery rates to manage throughput effectively.
How to format phone numbers for sending SMS in Guatemala?
Use the E.164 format, which includes the country code +502 followed by the local number. This ensures accurate routing and delivery, as number portability is not supported in Guatemala.
When should I send SMS messages in Guatemala?
Recommended sending hours are weekdays from 8:00 AM to 8:00 PM CT and weekends from 9:00 AM to 6:00 PM CT. Avoid sending messages on holidays unless urgent. Emergency messages can be sent 24/7.
What is the process for obtaining consent for SMS marketing in Guatemala?
Explicit consent (written or digital) is required. Clearly disclose message frequency and content type, maintain consent records for at least 2 years, and implement double opt-in verification. Refresh consent campaigns regularly (every 12 months).
Can I send SMS messages to landlines in Guatemala?
No, sending SMS to landlines is not supported. Attempts to do so will result in delivery failure and may generate error responses from the API, such as error code 21614 for Twilio.
What are the restricted content categories for SMS in Guatemala?
Prohibited content includes gambling, adult material, unauthorized pharmaceutical promotions, and fraudulent content. Financial, healthcare, and insurance industries face additional regulations and require specific disclaimers or terms and conditions.
How to integrate Sinch SMS API for sending messages to Guatemala?
Use your Sinch service plan ID and API token for authentication. Specify the recipient's number in E.164 format, include the message body, and use the provided TypeScript code example as a guide for integration.
What are the common error scenarios when sending SMS in Guatemala?
Common errors include invalid phone numbers, network timeouts, carrier rejections, and exceeding rate limits. Implement robust error handling and reporting mechanisms to address these issues effectively.
What are the recommended SMS providers for sending messages in Guatemala?
The article mentions Twilio, Sinch, and MessageBird as providers offering reliable SMS delivery in Guatemala. They provide APIs with specific parameters and code examples for integration.
What is the role of Superintendencia de Telecomunicaciones (SIT) in Guatemala SMS?
SIT governs SMS regulations in Guatemala. While specific SMS marketing laws are evolving, businesses must adhere to general consumer protection and telecommunication regulations enforced by SIT.