LearnLogs

Logs (Call, Webhooks, APIs)

SynthFlow provides a unified logging system that gives you complete visibility into all your voice agent operations. Access detailed logs for calls, API requests, and webhook interactions in one centralized location.

Overview

The logging system consists of three main log types:

  • Call Logs: Complete call history with transcripts and metadata
  • API Logs: Audit trail of all API requests triggered by your agents
  • Webhook Logs: Track webhook interactions and delivery status

Accessing Logs

Navigate to the Logs section in your SynthFlow dashboard to access all logging features.

Call Logs

Call logs provide comprehensive information about every call made through your agents.

Viewing Call Logs

The call logs table displays:

  • Date and Time: When the call occurred
  • Agent: Which agent handled the call
  • Duration: Call length
  • Status: Call outcome (completed, failed, etc.)
  • End Reason: Why the call ended
  • Custom Evaluations: Any custom metrics you’ve defined

Filtering Call Logs

Use the filter options to narrow down your call history:

  • Date Range: Filter by specific time periods
  • Agent: Select specific agents
  • Status: Filter by call outcome
  • Duration: Filter by call length

Call Details

Click on any call to view detailed information:

  • Full Transcript: Complete conversation text
  • Audio Recording: Listen to the actual call
  • Custom Variables: Data collected during the call
  • Actions Triggered: Any custom actions that were executed
  • Performance Metrics: Response times and quality scores

Exporting Call Data

Export call logs to CSV for analysis:

  1. Apply your desired filters
  2. Click the Export button
  3. Download the file

API Logs

API logs track all outbound API requests made by your agents during calls.

Viewing API Logs

The API logs table shows:

  • Date and Time: When the request was made
  • Method: HTTP method (GET, POST, PUT, etc.)
  • Resource: API endpoint called
  • Agent: Which agent triggered the request
  • Status: Response status code
  • Duration: Request processing time
  • Call ID: Associated call identifier

Filtering API Logs

Filter API logs by:

  • Time Range: Specific date periods
  • Method: HTTP methods (multi-select)
  • Agent: Specific agents
  • Status: Response status codes
  • Call ID: Specific call identifier

API Request Details

Click on any API log entry to view:

  • Request Details: URL, headers, query parameters, body
  • Response Details: Status, headers, response body, timing
  • Metadata: Trace ID, agent information, call context
  • Attempts: Retry information if applicable

Webhook Logs

Webhook logs track all webhook interactions and their delivery status.

Viewing Webhook Logs

The webhook logs table displays:

  • Date and Time: When the webhook was triggered
  • Webhook URL: Destination endpoint
  • Status: Delivery status (delivered, failed, retrying)
  • Agent: Which agent triggered the webhook
  • Call ID: Associated call identifier
  • Response Time: How long the webhook took to respond

Filtering Webhook Logs

Filter webhook logs by:

  • Time Range: Specific date periods
  • Status: Delivery status
  • Agent: Specific agents
  • Call ID: Specific call identifier
  • Webhook URL: Specific endpoints

Webhook Details

Click on any webhook log to view:

  • Request Details: Headers, payload, delivery attempts
  • Response Details: Status codes, response body, timing
  • Retry Information: Number of attempts and failure reasons
  • Delivery Timeline: When attempts were made

Search and Navigation

Search Functionality

Use the search box to find specific logs:

  • Call ID: Search by call identifier
  • Action ID: Search by custom action identifier
  • Agent Name: Search by agent name
  • Keywords: Search within transcripts and logs

API Access

Access logs programmatically using the SynthFlow API:

See the API Docs → API Reference