How to Integrate Replit with Zocdoc

1import os
2
3# Verify all required secrets are present
4required_secrets = ['ZOCDOC_WEBHOOK_SECRET']
5optional_secrets = ['TWILIO_ACCOUNT_SID', 'TWILIO_AUTH_TOKEN', 'SENDGRID_API_KEY']
6
7print('Checking required secrets:')
8all_ok = True
9for secret in required_secrets:
10    val = os.environ.get(secret)
11    if val:
12        print(f'  OK: {secret} ({len(val)} chars)')
13    else:
14        print(f'  MISSING: {secret}')
15        all_ok = False
16
17print('\nChecking optional secrets:')
18for secret in optional_secrets:
19    val = os.environ.get(secret)
20    status = f'present ({len(val)} chars)' if val else 'not set'
21    print(f'  {secret}: {status}')
22
23if all_ok:
24    print('\nAll required secrets loaded.')
25else:
26    print('\nMissing required secrets — add them to Replit Secrets (lock icon).')

1// Node.js Express webhook receiver for Zocdoc
2const express = require('express');
3const crypto = require('crypto');
4const app = express();
5
6const WEBHOOK_SECRET = process.env.ZOCDOC_WEBHOOK_SECRET;
7
8// Raw body for signature verification
9app.use('/webhook', express.raw({ type: 'application/json' }));
10app.use(express.json());
11
12function verifyZocdocSignature(rawBody, signatureHeader) {
13  if (!WEBHOOK_SECRET) return true; // skip if no secret configured
14  const expected = crypto
15    .createHmac('sha256', WEBHOOK_SECRET)
16    .update(rawBody)
17    .digest('hex');
18  const received = signatureHeader?.replace('sha256=', '') || '';
19  try {
20    return crypto.timingSafeEqual(
21      Buffer.from(expected, 'hex'),
22      Buffer.from(received, 'hex')
23    );
24  } catch {
25    return false;
26  }
27}
28
29app.post('/webhook', async (req, res) => {
30  // Respond quickly to prevent Zocdoc retry
31  const signature = req.headers['x-zocdoc-signature'] || req.headers['x-webhook-signature'];
32  const rawBody = req.body;
33
34  if (!verifyZocdocSignature(rawBody, signature)) {
35    console.log('Rejected webhook: invalid signature');
36    return res.status(401).json({ error: 'Invalid signature' });
37  }
38
39  const event = JSON.parse(rawBody.toString());
40
41  // Acknowledge receipt immediately
42  res.json({ received: true });
43
44  // Process event asynchronously (non-blocking)
45  processAppointmentEvent(event).catch(err =>
46    console.error('Event processing error:', err.message)
47  );
48});
49
50async function processAppointmentEvent(event) {
51  const eventType = event.event_type || event.type;
52  const appointmentId = event.appointment?.id || event.appointment_id;
53
54  // Log non-PHI identifiers only
55  console.log(`Zocdoc event: ${eventType} | Appointment ID: ${appointmentId}`);
56
57  switch (eventType) {
58    case 'appointment.created':
59      await handleNewAppointment(event);
60      break;
61    case 'appointment.cancelled':
62      await handleCancellation(event);
63      break;
64    case 'appointment.updated':
65      await handleUpdate(event);
66      break;
67    default:
68      console.log(`Unhandled event type: ${eventType}`);
69  }
70}
71
72async function handleNewAppointment(event) {
73  // Extract appointment details
74  const appointment = event.appointment || event.data || {};
75  const appointmentDatetime = appointment.datetime || appointment.start_time;
76  const providerId = appointment.provider_id;
77  // Add: send confirmation email, update CRM, schedule reminder SMS
78  console.log(`New appointment scheduled: ${appointmentDatetime} with provider ${providerId}`);
79}
80
81async function handleCancellation(event) {
82  const appointmentId = event.appointment?.id || event.appointment_id;
83  // Add: cancel reminder, update CRM, notify provider
84  console.log(`Appointment ${appointmentId} cancelled`);
85}
86
87async function handleUpdate(event) {
88  console.log('Appointment updated');
89}
90
91app.get('/health', (req, res) => res.json({ status: 'ok', service: 'zocdoc-webhook-receiver' }));
92app.listen(3000, '0.0.0.0', () => console.log('Zocdoc webhook server running on port 3000'));

1# Python: appointment reminder via Twilio
2# Add to requirements: twilio
3import os
4from twilio.rest import Client
5from datetime import datetime, timedelta
6import pytz
7
8TWILIO_SID = os.environ['TWILIO_ACCOUNT_SID']
9TWILIO_TOKEN = os.environ['TWILIO_AUTH_TOKEN']
10TWILIO_FROM = os.environ.get('TWILIO_PHONE_NUMBER', '')
11
12client = Client(TWILIO_SID, TWILIO_TOKEN)
13
14def send_appointment_reminder(patient_phone, provider_name, appointment_dt_str):
15    """
16    Send an SMS confirmation and schedule a reminder.
17    appointment_dt_str: ISO 8601 datetime string
18    """
19    # Immediate confirmation
20    confirmation = (
21        f'Your appointment with {provider_name} has been confirmed. '
22        f'Details: {appointment_dt_str}. '
23        f'Reply STOP to opt out of reminders.'
24    )
25    message = client.messages.create(
26        body=confirmation,
27        from_=TWILIO_FROM,
28        to=patient_phone
29    )
30    print(f'Confirmation SMS sent: {message.sid}')
31
32    # Schedule reminder for 24 hours before appointment
33    try:
34        appt_dt = datetime.fromisoformat(appointment_dt_str.replace('Z', '+00:00'))
35        reminder_time = appt_dt - timedelta(hours=24)
36        now = datetime.now(pytz.UTC)
37
38        if reminder_time > now:
39            reminder_body = (
40                f'Reminder: You have an appointment with {provider_name} tomorrow. '
41                f'Reply STOP to opt out.'
42            )
43            # Twilio Messaging Scheduling
44            scheduled = client.messages.create(
45                body=reminder_body,
46                from_=TWILIO_FROM,
47                to=patient_phone,
48                schedule_type='fixed',
49                send_at=reminder_time.strftime('%Y-%m-%dT%H:%M:%SZ')
50            )
51            print(f'Reminder scheduled: {scheduled.sid} for {reminder_time}')
52    except Exception as e:
53        print(f'Reminder scheduling failed: {e}')
54
55# Usage in appointment.created handler:
56# send_appointment_reminder('+15551234567', 'Dr. Smith', '2025-07-15T10:00:00Z')

1# .replit deployment configuration
2# Set in your .replit file for Reserved VM deployment
3
4# [deployment]
5# run = ["node", "index.js"]
6# deploymentTarget = "cloudrun"
7#
8# For Python:
9# [deployment]
10# run = ["python", "app.py"]
11# deploymentTarget = "cloudrun"
12#
13# [[ports]]
14# internalPort = 3000
15# externalPort = 80