Skip to main content

Appointment Reminders

Reduce no-shows by sending automated appointment reminders to customers.

Overview​

Healthcare providers, salons, service businesses, and any appointment-based business can use Transformify to:

  • Send appointment confirmations
  • Send reminders before appointments
  • Collect confirmation responses
  • Track appointment status

Implementation​

Step 1: Create Reminder Template​

curl -X POST https://api.transformify.mk/api/v1/templates/sms \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Appointment Reminder",
    "templateContent": "Hi {{name}}, reminder: You have an appointment on {{date}} at {{time}}. Location: {{location}}. Reply YES to confirm or call us to reschedule."
  }'

Step 2: Create a Transactional SMS Campaign​

Create a long-lived campaign for reminders:

curl -X POST https://api.transformify.mk/api/v1/sms/campaigns \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Appointment Reminders",
    "templateId": "reminder-template-id"
  }'

Response (201 Created):

{
  "campaignId": "generated-campaign-id",
  "name": "Appointment Reminders",
  "status": "InProgress",
  "createdAt": "2024-01-15T09:00:00Z"
}

Step 3: Send Reminders​

Add messages as appointments approach:

curl -X POST https://api.transformify.mk/api/v1/sms/campaigns/{campaignId}/messages \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "38970123456",
    "externalUserId": "apt_001",
    "placeholders": {
      "name": "John Smith",
      "date": "January 16, 2024",
      "time": "10:00 AM",
      "location": "123 Main Street"
    }
  }'

Response (202 Accepted):

{
  "messageId": "generated-message-id",
  "campaignId": "campaign-id",
  "phoneNumber": "38970123456",
  "status": "Pending",
  "queuedAt": "2024-01-15T09:00:00Z"
}
Viber Alternative

For a richer experience with actionable buttons (e.g., "Confirm Appointment"), consider using Viber via POST /api/v1/viber/send with a Button+Text template.

Best Practices​

  1. Send at appropriate times - Schedule reminders during business hours
  2. Include all necessary details - Date, time, location, and any preparation instructions
  3. Track confirmations - Use externalUserId to link messages to appointments
  4. Respect time zones - Schedule based on customer's local time
  5. Send multiple reminders - Consider sending 24h before and 1h before the appointment