Connect your backend to HeyRik

const api = async (path, init = {}) => {
  const r = await fetch("https://server.heyrik.com/api/v1" + path, {
    ...init,
    headers: {
      Authorization: `Bearer ${process.env.HEYRIK_API_KEY}`,
      "Content-Type": "application/json",
      ...init.headers,
    },
  });
  const body = await r.json();
  if (!r.ok) throw new Error(`${r.status} ${body.error}: ${body.hint ?? ""}`);
  return body.data;
};

app.post("/heyrik/results", express.json(), async (req, res) => {
  const ev = req.body;
  res.sendStatus(200);                       // ack first — HeyRik times out at 12 s

  if (ev.event === "contact_completed") {
    await queue.add("heyrik-result", {
      key: `${ev.contact_id}:${ev.call_id}`,   // idempotency
      phone: ev.phone,
      outcome: ev.outcome,
      fields: ev.call?.extracted_variables ?? {},
      recording: ev.call?.recording_url ?? null,
    });
  } else if (ev.event === "campaign_completed") {
    await notifyOps(`Campaign ${ev.campaign_name} done: ${JSON.stringify(ev.counts)}`);
  }
});

# progress + counts
curl https://server.heyrik.com/api/v1/campaigns/cmp_4a19 -H "Authorization: Bearer $HEYRIK_API_KEY"

# every finished lead with outcome, category, extracted fields
curl "https://server.heyrik.com/api/v1/campaigns/cmp_4a19/contacts?status=completed&limit=500" \
  -H "Authorization: Bearer $HEYRIK_API_KEY"

# one lead with its recording + transcript
curl https://server.heyrik.com/api/v1/campaigns/cmp_4a19/contacts/cct_9b1e -H "Authorization: Bearer $HEYRIK_API_KEY"

# or the whole run as a CSV
curl https://server.heyrik.com/api/v1/campaigns/cmp_4a19/export -H "Authorization: Bearer $HEYRIK_API_KEY" -o results.csv