API Integration Tutorial

Learn how to connect production conversation data into Bluejay observability workflows

This tutorial walks you through connecting production conversation data to Bluejay’s observability pipeline. By the end, you’ll have a working integration that sends calls for evaluation and receives scored results.

Prerequisites

• A Bluejay account and API key
• Access to production transcripts, audio, or metadata
• A place in your stack where completed calls or conversations can be forwarded to Bluejay

What You’ll Learn

• How to send conversation data to the evaluate endpoint
• How to receive results via webhook or polling
• How to structure transcripts, audio, and metadata for best results

Integration Flow

Most teams connect their runtime or post-call pipeline to the Bluejay evaluate endpoint, attach any useful metadata, and then review the resulting metrics, traces, and alerts inside Monitor.

Recommended Steps

1. Capture production data

   Extract the transcript, audio recording URL, participant roles, and any tool call metadata from your provider or backend.

2. Normalize the payload

   Structure the data so the transcript, metadata, and identifiers are consistent with the evaluate endpoint schema.

3. Send to Bluejay

   POST the conversation to the /v1/evaluate endpoint with your API key and agent ID.

4. Receive and review results

   Results arrive via your configured events webhook or can be retrieved by polling the call log.

Next Steps

Evaluate Endpoint

Full API reference for the evaluate endpoint.

Tool Calls

Include tool call data and metadata in evaluations.

Webhooks

Receive real-time notifications for evaluation events.