feat: add Twilio SMS/call integration with settings, templates, and conversation history

2026-05-02 20:18:58 -04:00
parent b73b8c97c6
commit 5689269690
17 changed files with 770 additions and 196 deletions
--- a/apps/Backend/src/routes/twilio.ts
+++ b/apps/Backend/src/routes/twilio.ts
@@ -0,0 +1,183 @@
+import express, { Request, Response } from "express";
+import twilio from "twilio";
+import { storage } from "../storage";
+
+const router = express.Router();
+
+function getTwilioClient(accountSid: string, authToken: string) {
+  return twilio(accountSid, authToken);
+}
+
+// GET /api/twilio/settings
+router.get("/settings", async (req: Request, res: Response): Promise<any> => {
+  try {
+    const userId = req.user?.id;
+    if (!userId) return res.status(401).json({ message: "Unauthorized" });
+
+    const settings = await storage.getTwilioSettings(userId);
+    if (!settings) return res.status(200).json(null);
+
+    return res.status(200).json({
+      id: settings.id,
+      accountSid: settings.accountSid,
+      authToken: settings.authToken,
+      phoneNumber: settings.phoneNumber,
+      greetingMessage: settings.greetingMessage,
+    });
+  } catch (err) {
+    return res.status(500).json({ error: "Failed to fetch Twilio settings", details: String(err) });
+  }
+});
+
+// PUT /api/twilio/settings
+router.put("/settings", async (req: Request, res: Response): Promise<any> => {
+  try {
+    const userId = req.user?.id;
+    if (!userId) return res.status(401).json({ message: "Unauthorized" });
+
+    const { accountSid, authToken, phoneNumber, greetingMessage } = req.body;
+    if (!accountSid?.trim() || !authToken?.trim() || !phoneNumber?.trim()) {
+      return res.status(400).json({ message: "accountSid, authToken, and phoneNumber are required" });
+    }
+
+    const settings = await storage.upsertTwilioSettings(userId, {
+      accountSid: accountSid.trim(),
+      authToken: authToken.trim(),
+      phoneNumber: phoneNumber.trim(),
+      greetingMessage: greetingMessage?.trim() || null,
+    });
+
+    return res.status(200).json({
+      id: settings.id,
+      accountSid: settings.accountSid,
+      authToken: settings.authToken,
+      phoneNumber: settings.phoneNumber,
+      greetingMessage: settings.greetingMessage,
+    });
+  } catch (err) {
+    return res.status(500).json({ error: "Failed to save Twilio settings", details: String(err) });
+  }
+});
+
+// POST /api/twilio/send-sms
+router.post("/send-sms", async (req: Request, res: Response): Promise<any> => {
+  try {
+    const userId = req.user?.id;
+    if (!userId) return res.status(401).json({ message: "Unauthorized" });
+
+    const { to, message, patientId } = req.body;
+    if (!to || !message) return res.status(400).json({ message: "to and message are required" });
+
+    const settings = await storage.getTwilioSettings(userId);
+    if (!settings) {
+      return res.status(400).json({ message: "Twilio is not configured. Please add your Twilio credentials in Settings." });
+    }
+
+    const client = getTwilioClient(settings.accountSid, settings.authToken);
+    const twilioMsg = await client.messages.create({
+      body: message,
+      from: settings.phoneNumber,
+      to,
+    });
+
+    if (patientId) {
+      await storage.createCommunication({
+        patientId: Number(patientId),
+        userId,
+        channel: "sms",
+        direction: "outbound",
+        status: "sent",
+        body: message,
+        twilioSid: twilioMsg.sid,
+      });
+    }
+
+    return res.status(200).json({ sid: twilioMsg.sid, status: twilioMsg.status });
+  } catch (err: any) {
+    return res.status(500).json({ error: err.message || "Failed to send SMS" });
+  }
+});
+
+// GET /api/twilio/templates
+router.get("/templates", async (req: Request, res: Response): Promise<any> => {
+  try {
+    const userId = req.user?.id;
+    if (!userId) return res.status(401).json({ message: "Unauthorized" });
+    const templates = await storage.getTemplates(userId);
+    return res.status(200).json(templates);
+  } catch (err) {
+    return res.status(500).json({ error: "Failed to fetch templates", details: String(err) });
+  }
+});
+
+// PUT /api/twilio/templates/:key
+router.put("/templates/:key", async (req: Request, res: Response): Promise<any> => {
+  try {
+    const userId = req.user?.id;
+    if (!userId) return res.status(401).json({ message: "Unauthorized" });
+    const { key } = req.params;
+    const { body } = req.body;
+    if (!key || !body?.trim()) return res.status(400).json({ message: "key and body are required" });
+    await storage.saveTemplate(userId, key, body.trim());
+    return res.status(200).json({ key, body: body.trim() });
+  } catch (err) {
+    return res.status(500).json({ error: "Failed to save template", details: String(err) });
+  }
+});
+
+// GET /api/twilio/recent-communications
+router.get("/recent-communications", async (req: Request, res: Response): Promise<any> => {
+  try {
+    const userId = req.user?.id;
+    if (!userId) return res.status(401).json({ message: "Unauthorized" });
+
+    const limit = Math.min(50, parseInt(req.query.limit as string) || 20);
+    const communications = await storage.getRecentCommunicationsByUser(userId, limit);
+    return res.status(200).json(communications);
+  } catch (err) {
+    return res.status(500).json({ error: "Failed to fetch recent communications", details: String(err) });
+  }
+});
+
+// POST /api/twilio/make-call
+router.post("/make-call", async (req: Request, res: Response): Promise<any> => {
+  try {
+    const userId = req.user?.id;
+    if (!userId) return res.status(401).json({ message: "Unauthorized" });
+
+    const { to, message, patientId } = req.body;
+    if (!to) return res.status(400).json({ message: "to is required" });
+
+    const settings = await storage.getTwilioSettings(userId);
+    if (!settings) {
+      return res.status(400).json({ message: "Twilio is not configured. Please add your Twilio credentials in Settings." });
+    }
+
+    const twimlMessage = message || "Hello, this is a call from your dental office.";
+    const twiml = `<Response><Say>${twimlMessage}</Say></Response>`;
+
+    const client = getTwilioClient(settings.accountSid, settings.authToken);
+    const call = await client.calls.create({
+      twiml,
+      from: settings.phoneNumber,
+      to,
+    });
+
+    if (patientId) {
+      await storage.createCommunication({
+        patientId: Number(patientId),
+        userId,
+        channel: "voice",
+        direction: "outbound",
+        status: "queued",
+        twilioSid: call.sid,
+      });
+    }
+
+    return res.status(200).json({ sid: call.sid, status: call.status });
+  } catch (err: any) {
+    return res.status(500).json({ error: err.message || "Failed to make call" });
+  }
+});
+
+export default router;