Linq integration guide

Authorization: Bearer <linq_partner_token>

{
  "from": "+15551234567",
  "to": ["+15559876543"],
  "message": { "parts": [{ "type": "text", "value": "ping" }] }
}

Agent Status residential nodes call Linq v3 from consumer networks — not from our API server.

{
  "id": "...",
  "delivery_status": "delivered",
  "parts": [{ "type": "text", "value": "..." }]
}

Verdict aggregates send success, delivery state, and optional inbound reply across 2,500+ nodes.

{
  "messages": [{ "direction": "inbound", "parts": [...] }]
}

Pilot default: expect_inbound=true, gate_on_chat_health=false.

# Tier 1 — enable monitoring (replace SECRET; authorization = Linq Partner API bearer)
BODY='{"event":"monitoring.enabled","locator":"linq:sandbox-pilot-demo","enable_monitoring":true,"external_id":"sandbox-pilot-demo","display_name":"Sandbox Pilot Agent","authorization":"Bearer $LINQ_PARTNER_TOKEN","from":"+15551234567","to":["+15559876543"]}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$LINQ_WEBHOOK_SECRET" | awk '{print $2}')

curl -sS -w "\nHTTP %{http_code}\n" -X POST "https://api.rora.carmel.so/api/partner/linq/webhooks/monitoring" \
  -H "Content-Type: application/json" \
  -H "X-Linq-Signature: sha256=$SIG" \
  -d "$BODY" | jq .

Verify

• HTTP 202 Accepted
• Response includes agent_id and reliability block
• reliability.claim_url present when owner_email omitted

curl -sS -w "\nHTTP %{http_code}\n" \
  "https://api.rora.carmel.so/api/partner/linq/agents/linq:sandbox-pilot-demo/registration" \
  -H "X-Linq-Api-Token: $LINQ_STATUS_API_TOKEN" | jq .

Verify

• monitoring_state is registered or active
• probe_state may be pending_first_probe until first scheduled probe (~60 min)

curl -sS -w "\nHTTP %{http_code}\n" \
  "https://api.rora.carmel.so/api/partner/linq/agents/linq:sandbox-pilot-demo/status" \
  -H "X-Linq-Api-Token: $LINQ_STATUS_API_TOKEN" | jq .

Verify

• reliability.provider = agentstatus.dev
• reliability.verdict + reliability_label present
• reliability.report_url and reliability.badge_url populated

curl -sS -w "\nHTTP %{http_code}\n" \
  "https://api.rora.carmel.so/api/partner/linq/agents/linq:sandbox-pilot-demo/status/public" | jq .reliability

Verify

• HTTP 200 without X-Linq-Api-Token
• reliability block matches authenticated status poll

curl -sS -w "\nHTTP %{http_code}\n" \
  "https://api.rora.carmel.so/api/partner/linq/agents/linq:sandbox-pilot-demo/badge.svg" \
  -o /tmp/linq-badge.svg && head -c 200 /tmp/linq-badge.svg

Verify

• HTTP 200, Content-Type image/svg+xml
• SVG renders verdict label (e.g. Pending, UP)

# Same URL as reliability.report_url from step 3
open "https://agentstatus.dev/linq/status?locator=linq%3Asandbox-pilot-demo"

# Smoke: public report page loads (same URL as reliability.report_url)
curl -sS -o /dev/null -w "HTTP %{http_code}\n" \
  "https://agentstatus.dev/linq/status?locator=linq%3Asandbox-pilot-demo"

Verify

• HTTP 200
• Page shows agent name, locator, verdict / reliability label, and last checked time
• URL matches reliability.report_url from the status poll exactly

{# Use reliability.report_url from status poll — do not hardcode #}
<a href="{{ reliability.report_url }}" target="_blank" rel="noopener noreferrer">
  View full report
</a>

Verify

• “View full report” visible on the Linq agent / line surface
• href equals reliability.report_url (not hardcoded)
• Opens agentstatus.dev/linq/status?locator=… in a new tab

{# img from status poll (simplest) #}
<a href="{{ reliability.report_url }}" target="_blank" rel="noopener noreferrer">
  <img src="{{ reliability.badge_url }}" alt="Agent reliability status" height="28" />
</a>

Verify

• Badge renders on the Linq surface (img)
• Badge label matches current verdict
• Clicking badge opens the same report URL as step 6

# Copy token from reliability.claim_url — URL ends with ?token=…
TOKEN="{claim_token}"
curl -sS "https://api.rora.carmel.so/api/partner/linq/claim/$TOKEN" | jq .

Verify

• valid: true
• Response includes agent_id, signup_url, dashboard_url, redeem_url
• claim_url matches agentstatus.dev/linq/claim?token=…

open "https://agentstatus.dev/linq/claim?token={claim_token}"

Verify

• Page loads without login
• Shows agent name, locator, and current reliability label
• Continue / signup links present

{# Use reliability.claim_url from status poll #}
<a href="{{ reliability.claim_url }}" target="_blank" rel="noopener noreferrer">
  Manage alerts &amp; metrics
</a>

Verify

• “Manage alerts & metrics” links to reliability.claim_url
• Tier 1 toggle still does not require Agent Status signup