Build on your RingReady data

import requests

BASE = "https://www.ring-ready.com"
API_KEY = "rr_live_xxxxxxxx"          # from Profile → API keys
headers = {"Authorization": f"Bearer {API_KEY}"}

r = requests.get(f"{BASE}/api/v1/whoami", headers=headers)
print(r.json())
# {'user_id': 142, 'email': 'you@example.com', 'auth_method': 'api_key',
#  'api_key_prefix': 'rr_live_8f3a', 'scopes': ['read', 'write']}

Authorization: Bearer rr_live_xxxxxxxx

r = requests.get(f"{BASE}/api/v1/conversations",
                 headers=headers,
                 params={"channel": "web_chat", "limit": 20})

data = r.json()
for c in data["conversations"]:
    print(c["started_at"], "·", c["label"], "·", c["summary"])

# next page:
if data["next_before_id"]:
    more = requests.get(f"{BASE}/api/v1/conversations", headers=headers,
                        params={"before_id": data["next_before_id"]}).json()

{
  "conversations": [
    {
      "id": 184, "channel": "web_chat", "agent_id": 7,
      "from": null, "to": null,
      "caller_name": "Sam", "label": "Demo Request",
      "summary": "Visitor asked for a demo and pricing.",
      "started_at": "2026-06-09T14:03:00Z",
      "ended_at": "2026-06-09T14:07:11Z",
      "duration_seconds": 251, "end_reason": "visitor_ended",
      "is_archived": false, "is_viewed": false,
      "web_chat": {"device_type": "desktop", "origin_url": "https://acme.com/pricing"}
    }
  ],
  "next_before_id": 184,
  "limit": 20
}

convo = requests.get(f"{BASE}/api/v1/conversations/184", headers=headers).json()
for turn in convo["transcript"]:
    print(f"{turn['role']}: {turn['content']}")

agents = requests.get(f"{BASE}/api/v1/agents", headers=headers).json()["agents"]
# [{"id": 7, "phone_number": "+15551234567", "agent_name": "Ava",
#   "business_name": "Acme Plumbing", "subscription_type": "growth",
#   "created_at": "2026-01-12T09:30:00Z"}]

{
  "id": 7, "phone_number": "+15551234567", "subscription_type": "growth",
  "plan": {"subscription_type": "growth", "effective_tier": "growth"},
  "agent_name": "Ava", "voice": "friendly",
  "greeting_message": "Thanks for calling Acme — how can I help?",
  "goal_source": "prompt",
  "agent_goal": "Qualify leads and book consultations.",
  "agent_goal_list": null,
  "supported_languages": ["en", "es"],
  "business_name": "Acme Plumbing", "business_website": "https://acme.com",
  "business_services": "Emergency plumbing, water heaters, drain cleaning.",
  "business_address": "12 Main St, Denver, CO",
  "business_service_areas": "Denver metro",
  "business_hours": {"mon": [{"open": "08:00", "close": "17:00"}]},
  "timezone": "America/Denver",
  "faq": {"Do you offer emergency service?": "Yes, 24/7.",
          "Do you give free estimates?": "Yes, on every job."},
  "appointment_booking": {"sms_enabled": true, "sms_url": "https://book.acme.com", "sms_purpose": "booking"},
  "notifications": {"email": null, "calls_disabled": false, "sms_enabled": true,
                    "sms_number_masked": "***4567", "sms_number_verified": true},
  "recording_enabled": true,
  "capi": {"meta":   {"enabled": false, "pixel": null, "has_access_token": false, "events": []},
           "google": {"enabled": true, "pixel": {"measurement_id": "G-XXXX"},
                      "has_api_secret": true, "events": [{"event_name": "conv", "always": true}]},
           "tiktok": {"enabled": false, "pixel": null, "has_access_token": false, "events": []}},
  "features": {"web_chat_enabled": true, "live_context_enabled": false,
               "webhook_enabled": false, "webhook_url": null},
  "entitlements": {
    "call_recording": {"configured": true, "plan_includes": true, "active": true, "required_tier": "growth"},
    "capi_google":    {"configured": true, "plan_includes": false, "active": false, "required_tier": "scale"},
    "webhooks":       {"configured": false, "plan_includes": true, "active": false, "required_tier": "professional"}
  },
  "is_suspended": false, "created_at": "2026-01-12T09:30:00Z"
}

r = requests.patch(f"{BASE}/api/v1/agents/7",
                   headers=headers,
                   json={
                       "agent_goal": "Qualify the caller, then book a consultation.",
                       "greeting_message": "Thanks for calling Acme Plumbing — how can I help?",
                       "faq": {
                           "Do you offer free estimates?": "Yes — free, no-obligation estimates on every job.",
                           "What are your hours?": "We answer 24/7, including weekends and holidays.",
                           "Do you handle emergencies?": "Yes — we dispatch same-day for emergencies.",
                       },
                   })

print(r.json())
# {'id': 7, 'updated': ['agent_goal', 'greeting_message', 'faq']}

import requests, json
from anthropic import Anthropic

BASE = "https://www.ring-ready.com"
RR = {"Authorization": "Bearer rr_live_xxxxxxxx"}
claude = Anthropic()
AGENT_ID = 7

# 1. Pull the last 50 conversations for this agent
convos = requests.get(f"{BASE}/api/v1/conversations", headers=RR,
                      params={"agent_id": AGENT_ID, "limit": 50}).json()["conversations"]

# 2. Fetch each transcript
transcripts = []
for c in convos:
    full = requests.get(f"{BASE}/api/v1/conversations/{c['id']}", headers=RR).json()
    transcripts.append(full["transcript"])

# 3. Ask Claude for recurring questions the agent answered poorly,
#    with a drafted FAQ answer for each
prompt = (
    f"Here are {len(transcripts)} receptionist transcripts. "
    "Find the 5 most common questions callers asked that the agent did NOT answer well. "
    'Return JSON: [{"question": ..., "answer": ...}].\n\n'
    + json.dumps(transcripts)[:50000]
)
reply = claude.messages.create(
    model="claude-sonnet-4-6", max_tokens=1500,
    messages=[{"role": "user", "content": prompt}],
)
additions = json.loads(reply.content[0].text)

# 4. Merge into the agent's FAQ and write it back
agent = requests.get(f"{BASE}/api/v1/agents/{AGENT_ID}", headers=RR).json()
faq = agent.get("faq") or {}
for item in additions:
    faq[item["question"]] = item["answer"]

requests.patch(f"{BASE}/api/v1/agents/{AGENT_ID}", headers=RR, json={"faq": faq})
print(f"Added {len(additions)} answers to the FAQ.")