Creating Actions

{
  "event": "action.executed",
  "action_id": "act_8f3k2j1m",
  "action_name": "Order Status Lookup",
  "conversation_id": "conv_abc123",
  "agent_id": "agent_xyz789",
  "timestamp": "2026-04-02T14:30:00Z",
  "parameters": {
    "order_id": "ORD-78542",
    "email": "[email protected]"
  },
  "metadata": {
    "source": "website_widget",
    "page_url": "https://acme.com/support",
    "user_agent": "Mozilla/5.0 ...",
    "ip_country": "US"
  }
}

{
  "status": "success",
  "message": "Order ORD-78542 shipped on March 28th via FedEx. Tracking number: 7891234567. Estimated delivery: April 4th.",
  "data": {
    "tracking_url": "https://fedex.com/track/7891234567",
    "carrier": "FedEx",
    "estimated_delivery": "2026-04-04"
  }
}

{
  "status": "error",
  "message": "We couldn't find an order with that number. Please double-check your order confirmation email and try again.",
  "error_code": "ORDER_NOT_FOUND"
}

const express = require("express");
const app = express();
 
app.use(express.json());
 
app.post("/webhooks/chatsby/order-status", async (req, res) => {
  // 1. Verify the request is from Chatsby
  const signature = req.headers["x-chatsby-signature"];
  if (!verifySignature(req.body, signature, process.env.CHATSBY_WEBHOOK_SECRET)) {
    return res.status(401).json({
      status: "error",
      message: "Unauthorized request.",
    });
  }
 
  // 2. Extract parameters
  const { order_id, email } = req.body.parameters;
 
  try {
    // 3. Look up the order in your database
    const order = await db.orders.findOne({
      orderId: order_id,
      customerEmail: email,
    });
 
    if (!order) {
      return res.json({
        status: "error",
        message: `We couldn't find order ${order_id} associated with ${email}. Please double-check your order number and the email you used at checkout.`,
      });
    }
 
    // 4. Format and return the response
    const statusMessages = {
      processing: `Order ${order_id} is being processed. It should ship within 1-2 business days.`,
      shipped: `Order ${order_id} shipped on ${order.shippedDate} via ${order.carrier}. Tracking number: ${order.trackingNumber}. Estimated delivery: ${order.estimatedDelivery}.`,
      delivered: `Order ${order_id} was delivered on ${order.deliveredDate}. It was left at: ${order.deliveryLocation}.`,
      cancelled: `Order ${order_id} was cancelled on ${order.cancelledDate}. If you were charged, the refund should appear within 5-10 business days.`,
    };
 
    return res.json({
      status: "success",
      message: statusMessages[order.status] || `Order ${order_id} status: ${order.status}.`,
      data: {
        order_status: order.status,
        tracking_url: order.trackingUrl || null,
        carrier: order.carrier || null,
      },
    });
  } catch (error) {
    console.error("Order lookup failed:", error);
    return res.status(500).json({
      status: "error",
      message: "Something went wrong while looking up your order. Please try again in a moment.",
    });
  }
});
 
app.listen(3000, () => console.log("Webhook server running on port 3000"));

app.post("/webhooks/chatsby/book", async (req, res) => {
  const { full_name, email, phone, preferred_date, service_type } = req.body.parameters;
 
  try {
    // Check availability
    const slot = await calendar.findAvailableSlot({
      date: preferred_date,
      serviceType: service_type,
      duration: service_type === "General Checkup" ? 30 : 60,
    });
 
    if (!slot) {
      // No availability — suggest alternatives
      const alternatives = await calendar.getNextAvailable({
        serviceType: service_type,
        limit: 3,
      });
 
      const altText = alternatives
        .map((s) => `${s.date} at ${s.time}`)
        .join(", ");
 
      return res.json({
        status: "error",
        message: `Unfortunately, there are no openings on ${preferred_date} for a ${service_type}. The next available times are: ${altText}. Would you like to book one of those instead?`,
      });
    }
 
    // Book the appointment
    const appointment = await calendar.book({
      slot,
      patient: { full_name, email, phone },
      serviceType: service_type,
    });
 
    return res.json({
      status: "success",
      message: `Your ${service_type} appointment is confirmed for ${appointment.date} at ${appointment.time}. A confirmation email has been sent to ${email}. Please arrive 10 minutes early. To reschedule or cancel, reply to the confirmation email.`,
      data: {
        appointment_id: appointment.id,
        date: appointment.date,
        time: appointment.time,
      },
    });
  } catch (error) {
    console.error("Booking failed:", error);
    return res.json({
      status: "error",
      message: "We ran into an issue while booking your appointment. Please call us at (555) 123-4567 to complete the booking.",
    });
  }
});