Integrations / Writer (direct)

Writer (direct)

TENG-2205: Direct Writer API calls (api.writer.com, POST /v1/chat) called from customer code. Writer has no admin or billing API — usage and spend are visible only in Writer's own console, so this connector is the only way to attribute Writer spend in Telara, and it only receives data if the customer's own code emits an OTel span or log record per chat call carrying the attributes below; an uninstrumented integration reports nothing, not zero. Writer's request/response schema is proprietary, not OpenAI-compatible: responses carry Writer-specific fields (graph_data, llm_data, translation_data, web_search_data) with no documented OpenAI compatibility layer, so a generic OpenAI SDK wrapper cannot be pointed at it. There is also no telara-observability SDK wrapper for Writer. Instrumentation must be manual: either hand-written OTel spans around the writer-sdk call site, or a customer-built wrapper that emits the gen_ai.* attributes below.

OTLP

Spend

What Telara does

Capability matrix

Indexes No Tracks spend Yes Discovers shadow AI No Runs actions No Real-time events No

Before you connect

Prerequisites

A process that uses Writer (direct) and can export OpenTelemetry.

Ability to run the Telara CLI where that process runs.

Vendor setup

Get the credential

Print the OTLP endpoint

Run `telara otlp`. It prints the endpoint and headers Telara expects. Do not paste a vendor API key on this connector.

Point Writer (direct) at it

Enable OpenTelemetry in Writer (direct) (or in your collector) and send traces to the endpoint that command prints.

In Telara

Connect in Telara

OTLP

This connector does not take a vendor key in Settings → Integrations. Run `telara otlp` (or point the vendor’s OpenTelemetry exporter at the endpoint that command prints) so usage arrives as telemetry.

Telara has not published the exact form fields for this method yet. Complete whatever the Connect dialog shows.

Spend

What gets measured

Resolution: Per request.

Attribution: Matched to people by email.

How far back vendor history goes is not published uniformly for this connector.

input_tokens
tokens
output_tokens
tokens
framework_runs
count

Sync

Freshness & sync

Spend connectors refresh on the vendor pull cadence declared in the catalog. Indexing lag is not published for this connector.

Data handling

Permissions & data handling

Telara has not published a permission list for this connector yet. Treat the vendor consent screen as the source of truth until this page lists scopes.

This catalog entry does not declare extra semantic-search exclusions.

After connect

Verify it worked

This connector does not declare a credential probe yet. A saved connection means Telara stored the credential, not that the vendor accepted it.

Honesty

Known limitations

Nothing appears in Telara until that process actually emits telemetry.

This is not an admin-key connector. Org-level spend, if Telara offers it for this vendor, is a separate page.