Send calls to your CRM

Subscribe to three events and you have everything a CRM wants: call.ended for the call itself, message.taken and call.urgent for the follow-ups, and call.transcript.ready when you want the words too.

1. 1

   Add an endpoint

   In Settings → Webhooks, press Add an endpoint, give it your HTTPS URL and tick the events above. Copy the endpoint’s signing secret into your server’s environment as PREPAID_WEBHOOK_SECRET.

2. 2

   Verify, answer, then work

   Read the raw body, verify the x-signature header, answer 200 straight away and do the slow work afterwards. We wait 10 seconds for an answer.

   server.js (Express)Copy

   1const express = require('express');2// verifyWebhook is the function on the Webhooks page.34const app = express();56app.post('/hooks/prepaid', express.raw({ type: 'application/json' }), (req, res) => {7  const raw = req.body.toString('utf8');8  if (!verifyWebhook(raw, req.get('x-signature'), process.env.PREPAID_WEBHOOK_SECRET)) {9    return res.status(401).end();10  }11  res.status(200).end(); // answer first1213  const event = JSON.parse(raw);14  queue.push(event); // your own job queue — see the next step15});1617app.listen(3000);

3. 3

   File each event once

   The same event can arrive more than once — a retry after a timeout, for instance. Its id never changes, so store the ids you have handled and skip repeats.

   worker.jsCopy

   1async function handle(event) {2  if (await seen(event.id)) return; // already filed3  const d = event.data;45  switch (event.type) {6    case 'call.ended':7      await crm.logCall({ phone: d.from, name: d.caller_name, seconds: d.duration_seconds, outcome: d.outcome });8      break;9    case 'message.taken':10    case 'call.urgent':11      await crm.createTask({ phone: d.caller_phone, name: d.caller_name, note: d.body, urgent: d.kind === 'urgent' });12      break;13    case 'call.transcript.ready': {14      const res = await fetch(`https://app.prepaid.ai/api/v1/calls/${d.call_id}`, {15        headers: { Authorization: `Bearer ${process.env.PREPAID_API_KEY}` },16      });17      const { call, transcript } = await res.json();18      await crm.attachNote({ phone: call.from, text: transcript.map((t) => `${t.speaker}: ${t.text}`).join('\n') });19      break;20    }21  }22  await markSeen(event.id);23}