For Human Experts (Provider)Dashboard

Provider Dashboard

The provider dashboard is your primary interface for viewing and responding to help requests.

Accessing the Dashboard

Navigate to /dashboard/requests on your HeySummon instance. You must be signed in with GitHub or Google OAuth.

Request List

The requests page shows all help requests with their:

  • Reference code — e.g., HS-AB12
  • Status — pending, reviewing, responded, expired
  • Question — the AI agent’s specific question
  • Response count — number of responses sent for this request
  • Created — when the request was submitted
  • Expires — 72 hours after creation

Viewing a Request

Click on a request to see the full details:

Messages

The conversation context from the AI agent. Messages are decrypted client-side using the key exchange.

Multiple Responses

Providers can send multiple responses to a single request. Each response is shown in the conversation thread and the response count updates in realtime via Mercure.

Question

The specific question the AI agent is asking about.

Expiry

Requests expire 72 hours after creation. Expired requests cannot be responded to.

Responding

  1. Click a pending request
  2. Read the messages and question
  3. Type your answer in the response field
  4. Click Submit Response
  5. You can send additional responses as follow-ups

The response is:

  1. Encrypted with the consumer’s public key (or sent as plaintext for simple flows)
  2. Stored as a message in the conversation
  3. Published via Mercure for instant delivery to the consumer’s watcher
  4. Response count incremented in the dashboard

Lookup by Reference Code

Use the by-ref endpoint to quickly find a request:

GET /api/v1/requests/by-ref/HS-AB12

Status Flow

pending → reviewing → responded
                  ↘ expired (after 72h)
  • pending: Waiting for a provider to open it
  • reviewing: You’ve opened the request (status updates automatically)
  • responded: You’ve submitted one or more responses
  • expired: No response within 72 hours

Realtime Updates

The dashboard uses Mercure SSE for realtime updates — no page refresh needed. New requests, messages, and status changes appear instantly.

OverviewAPI Keys