Calendly

              
              curl https://api.calendly.com/users/me \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN"

            

              
              https://api.calendly.com/organizations/xxxxxxxxxxxxxxxx

            

              
              curl -X POST https://api.calendly.com/webhook_subscriptions \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://你的伺服器地址/webhooks/calendly",
    "events": [
      "invitee.created",
      "invitee.canceled"
    ],
    "organization": "https://api.calendly.com/organizations/你的組織ID",
    "scope": "organization"
  }'

            

              
              npm install express

            

              
              // server.js
import express from 'express';

const app = express();
app.use(express.json());

// EngageLab 授權：base64(dev_key:dev_secret)
const ENGAGELAB_AUTH = Buffer.from(
  `${process.env.ENGAGELAB_DEV_KEY}:${process.env.ENGAGELAB_DEV_SECRET}`
).toString('base64');

// 呼叫 EngageLab SMS API 發送簡訊
async function sendSMS({ to, templateId, params }) {
  const res = await fetch('https://smsapi.engagelab.com/v1/messages', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Basic ${ENGAGELAB_AUTH}`,
    },
    body: JSON.stringify({
      to: [to],
      template: {
        id: templateId,
        params,
      },
    }),
  });

  const data = await res.json();

  // HTTP 200 不代表發送成功，需檢查 code 欄位
  if (data.code && data.code !== 0) {
    console.error(`SMS 發送失敗: code=${data.code}, message=${data.message}`);
  } else {
    console.log(`SMS 發送成功: plan_id=${data.plan_id}, message_id=${data.message_id}`);
  }
}

// 將 ISO 時間字串轉換為本地時間（Asia/Taipei）
function formatTime(isoString) {
  return new Date(isoString).toLocaleString('zh-TW', {
    timeZone: 'Asia/Taipei',
    year: 'numeric',
    month: '2-digit',
    day: '2-digit',
    hour: '2-digit',
    minute: '2-digit',
  });
}

// 註冊會議前提醒排程任務（24h 和 1h 各一條）
function scheduleReminders({ phone, name, startTime }) {
  const meetingTime = new Date(startTime).getTime();
  const now = Date.now();

  const reminders = [
    { advance: '24 小時', triggerAt: meetingTime - 24 * 60 * 60 * 1000 },
    { advance: '1 小時',  triggerAt: meetingTime -      60 * 60 * 1000 },
  ];

  for (const { advance, triggerAt } of reminders) {
    const delay = triggerAt - now;
    if (delay <= 0) continue; // 觸發時間已過，跳過

    setTimeout(async () => {
      await sendSMS({
        to: phone,
        templateId: process.env.TEMPLATE_ID_REMINDER,
        params: { name, time: formatTime(startTime), advance },
      });
    }, delay);
  }
}

// Webhook 接收端點
app.post('/webhooks/calendly', async (req, res) => {
  const { event, payload } = req.body;

  const phone     = payload.text_reminder_number;     // 使用者預約時填寫的手機號碼
  const name      = payload.invitee?.name ?? '使用者';
  const startTime = payload.scheduled_event?.start_time;

  // 手機號碼未填時跳過簡訊發送
  if (!phone) {
    console.log('該預約未填寫手機號碼，跳過簡訊通知');
    return res.sendStatus(200);
  }

  if (event === 'invitee.created') {
    // 發送預約確認簡訊
    await sendSMS({
      to: phone,
      templateId: process.env.TEMPLATE_ID_CONFIRM,
      params: { name, time: formatTime(startTime) },
    });

    // 註冊會議前提醒任務
    scheduleReminders({ phone, name, startTime });

  } else if (event === 'invitee.canceled') {
    // 發送取消通知簡訊
    await sendSMS({
      to: phone,
      templateId: process.env.TEMPLATE_ID_CANCEL,
      params: { name },
    });
  }

  // 必須在 2 秒內回傳 200，否則 Calendly 會認為推送失敗並重試
  res.sendStatus(200);
});

app.listen(3000, () => console.log('Server running on port 3000'));

            

              
              ENGAGELAB_DEV_KEY=你的dev_key
ENGAGELAB_DEV_SECRET=你的dev_secret

TEMPLATE_ID_CONFIRM=預約確認範本ID
TEMPLATE_ID_CANCEL=取消通知範本ID
TEMPLATE_ID_REMINDER=會議提醒範本ID

            

              
              // 在 scheduleReminders 函數中追加
const followUpAt = meetingTime + 30 * 60 * 1000; // 會議結束後 30 分鐘
const followUpDelay = followUpAt - now;

if (followUpDelay > 0) {
  setTimeout(async () => {
    await sendSMS({
      to: phone,
      templateId: process.env.TEMPLATE_ID_FOLLOWUP,
      params: { name },
    });
  }, followUpDelay);
}

            

              
              if (event === 'invitee.created') {
  // 通知預約者
  await sendSMS({
    to: phone,
    templateId: process.env.TEMPLATE_ID_CONFIRM,
    params: { name, time: formatTime(startTime) },
  });

  // 通知主持人
  await sendSMS({
    to: process.env.HOST_PHONE,
    templateId: process.env.TEMPLATE_ID_HOST_NOTIFY,
    params: { name, time: formatTime(startTime) },
  });
}