Webhooks

{
  "event": "call_started",
  "workflow_run_id": 12345,
  "workflow_id": 88,
  "run_name": "WR-API-7823"
}

{
  "event": "call_ended",
  "call": {
    "call_id": "12345",
    "agent_id": 88,
    "call_status": "ended",
    "call_type": "phone_call",
    "direction": "outbound",
    "from_number": "+18005550199",
    "to_number": "+14155550100",
    "start_timestamp": 1775577600000,
    "end_timestamp": 1775577757000,
    "duration_ms": 157000,
    "transcript": "Agent: Hi Jane, calling about your premium plan...\nUser: Yes, please renew it.",
    "transcript_object": [
      { "role": "agent", "content": "Hi Jane, calling about your premium plan..." },
      { "role": "user", "content": "Yes, please renew it." }
    ],
    "recording_url": "https://files.peachdeskai.com/recordings/12345.wav?X-Amz-Signature=...",
    "transcript_url": "https://files.peachdeskai.com/transcripts/12345.txt?X-Amz-Signature=...",
    "public_log_url": "https://api.peachdeskai.com/api/v1/public/download/workflow/abc123/transcript",
    "disconnection_reason": "agent_hangup",
    "dynamic_variables": {
      "customer_name": "Jane",
      "plan": "premium"
    },
    "metadata": {
      "crm_id": "cus_8842"
    },
    "call_analysis": {
      "call_summary": "Confirmed the customer wants to renew their premium plan.",
      "user_sentiment": "Positive",
      "call_successful": true,
      "in_voicemail": false,
      "custom_analysis_data": {
        "renewal_confirmed": true
      }
    },
    "call_cost": {
      "combined_cost": 0.1423,
      "total_duration_seconds": 157,
      "product_costs": [
        { "product": "stt", "cost": 0.021 },
        { "product": "llm", "cost": 0.064 },
        { "product": "tts", "cost": 0.057 }
      ],
      "peachdesk_token_usage": {
        "prompt_tokens": 1840,
        "completion_tokens": 320
      }
    }
  }
}

{
  "event": "call_analyzed",
  "call": {
    "call_id": "12345",
    "agent_id": 88,
    "call_status": "ended",
    "call_type": "phone_call",
    "direction": "outbound",
    "from_number": "+18005550199",
    "to_number": "+14155550100",
    "start_timestamp": 1775577600000,
    "end_timestamp": 1775577757000,
    "duration_ms": 157000,
    "transcript": "Agent: Hi Jane...\nUser: Yes, please renew it.",
    "transcript_object": [
      { "role": "agent", "content": "Hi Jane..." },
      { "role": "user", "content": "Yes, please renew it." }
    ],
    "recording_url": "https://files.peachdeskai.com/recordings/12345.wav?X-Amz-Signature=...",
    "transcript_url": "https://files.peachdeskai.com/transcripts/12345.txt?X-Amz-Signature=...",
    "public_log_url": "https://api.peachdeskai.com/api/v1/public/download/workflow/abc123/transcript",
    "disconnection_reason": "agent_hangup",
    "dynamic_variables": {
      "customer_name": "Jane",
      "plan": "premium"
    },
    "metadata": {
      "crm_id": "cus_8842"
    },
    "call_analysis": {
      "call_summary": "Confirmed the customer wants to renew their premium plan.",
      "user_sentiment": "Positive",
      "call_successful": true,
      "in_voicemail": false,
      "custom_analysis_data": {
        "renewal_confirmed": true
      }
    }
  }
}

import hashlib
import hmac
from fastapi import FastAPI, Request, HTTPException

app = FastAPI()
WEBHOOK_SECRET = "your_webhook_secret"

@app.post("/webhook/peachdesk")
async def handle(request: Request):
    raw = await request.body()  # raw bytes — do NOT re-serialize
    expected = hmac.new(WEBHOOK_SECRET.encode(), raw, hashlib.sha256).hexdigest()
    received = request.headers.get("X-Peachdesk-Signature", "")
    if not hmac.compare_digest(expected, received):
        raise HTTPException(status_code=401, detail="Bad signature")

    payload = await request.json()
    event = request.headers.get("X-Peachdesk-Event")
    if event == "call_ended":
        call = payload["call"]
        # process call["call_analysis"], call["call_cost"], ...
    return {"status": "ok"}

import crypto from "crypto";
import express from "express";

const app = express();
const WEBHOOK_SECRET = "your_webhook_secret";

// Capture the raw body so the signature matches byte-for-byte.
app.use(express.json({ verify: (req, _res, buf) => { req.rawBody = buf; } }));

app.post("/webhook/peachdesk", (req, res) => {
  const expected = crypto
    .createHmac("sha256", WEBHOOK_SECRET)
    .update(req.rawBody)
    .digest("hex");
  const received = req.header("X-Peachdesk-Signature") || "";
  const ok =
    expected.length === received.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(received));
  if (!ok) return res.status(401).send("Bad signature");

  const event = req.header("X-Peachdesk-Event");
  const payload = req.body;
  // handle call_started / call_ended / call_analyzed
  res.json({ status: "ok" });
});