Overview

// Express.js example
app.post('/webhooks/jasni', express.json(), async (req, res) => {
  const { event, data } = req.body;
  
  console.log(`Agent notified of ${event}`);
  
  // Trigger your AI agent
  switch (event) {
    case 'email.received':
      await agent.processIncomingEmail(data);
      break;
    case 'email.sent':
      await agent.confirmDelivery(data);
      break;
  }
  
  // Always respond with 200
  res.status(200).send('OK');
});

curl -X POST https://api.jasni.ai/api/v1/webhooks \
  -H "Authorization: Bearer jsk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhooks/jasni",
    "events": ["email.received", "email.sent"]
  }'

{
  "success": true,
  "data": {
    "webhook": {
      "id": "webhook-id",
      "secret": "whsec_abc123..."
    }
  }
}

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

app.post('/webhooks/jasni', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-webhook-signature'];
  const payload = req.body.toString();
  
  if (!verifySignature(payload, signature, process.env.WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature');
  }
  
  // Process verified webhook
  const data = JSON.parse(payload);
  // ...
});

{
  "event": "email.received",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "data": {
    "id": "12345",
    "messageId": "<[email protected]>",
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Need help with my order",
    "account": "[email protected]",
    "folder": "INBOX",
    "text": "Hi, I have a question about my recent order...",
    "html": "<p>Hi, I have a question about my recent order...</p>"
  }
}