Wysp WebSockets 1.2.33

WebSocket API for use by mobile clients

Servers

  • wss://wysp-monolith.production.wysp.ai/wssproduction

    Production Monolith Server

  • wss://wysp-monolith.dev.wysp.ai/wssdevelopment

    Development Monolith Server

Operations

  • SEND /session

    Channel for user state communication

    Operation IDident

    Available only on servers:

    Accepts the following message:

    ident

    Identify the device

    Message IDident
    object

    Examples

  • SEND /session

    Channel for user state communication

    Operation IDdevice.status

    Available only on servers:

    Accepts the following message:

    device.status

    Report the current status of the device

    Message IDdevice.status
    object

    Examples

  • SEND /session

    Channel for user state communication

    Operation IDfixes.append

    Available only on servers:

    Accepts the following message:

    fixes.append

    Append fixes

    Message IDfixes.append
    object

    Examples

  • SEND /session

    Channel for user state communication

    Operation IDstate.context.set

    Available only on servers:

    Accepts the following message:

    state.context.set

    Set user context

    Message IDstate.context.set
    object

    Examples

  • RECEIVE /session

    Channel for user state communication

    Operation IDstate.bootstrap

    Available only on servers:

    Accepts the following message:

    state.bootstrap

    On socket connection, server sends the entire state object. The client should hold this in memory, merging in deltas over time as they arrive in state.delta messages

    Message IDstate.bootstrap
    object

    Examples

  • RECEIVE /session

    Channel for user state communication

    Operation IDstate.delta

    Available only on servers:

    Accepts the following message:

    state.delta

    Changes to the state object since the last `state.bootstrap`

    Message IDstate.delta
    object

    Examples

  • RECEIVE /session

    Channel for user state communication

    Operation IDinterjection

    Available only on servers:

    Accepts the following message:

    interjection

    Interjection to be played to the user ASAP

    Message IDinterjection
    object

    Examples

  • RECEIVE /session

    Channel for user state communication

    Operation IDsignal

    Available only on servers:

    Accepts the following message:

    signal

    Control signal

    Message IDsignal
    object

    Examples

  • RECEIVE /session

    Channel for user state communication

    Operation IDdebug

    Available only on servers:

    Accepts the following message:

    debug

    Debug data

    Message IDdebug
    object

    Examples

  • RECEIVE /audio-line

    Channel for audio data transmission

    Operation IDaudioLineReceive

    Available only on servers:

    Accepts one of the following messages:

    • #0audio.begin

      Start an audio stream

      Message IDaudio.begin
      object

      Examples

    • #1audio.end

      End an audio stream

      Message IDaudio.end
      object

      Examples

    • #2audio.data

      Audio data

      Message IDaudio.data
      object

      Examples

  • SEND /audio-line

    Channel for audio data transmission

    Operation IDaudioLineSend

    Available only on servers:

    Accepts one of the following messages:

    • #0audio.begin

      Start an audio stream

      Message IDaudio.begin
      object

      Examples

    • #1audio.end

      End an audio stream

      Message IDaudio.end
      object

      Examples

    • #2audio.data

      Audio data

      Message IDaudio.data
      object

      Examples

Schemas

  • object

    Control signal

  • object

    Interjection to be made to the user, including all metadata needed to communicate it to them correctly

  • object

    Description of the user's navigation plan

  • object

    Metadata about the identity of the device

  • object

    Metadata about the current state of the server from the user's perspective

  • object

    Metadata about the current state of a client device

  • array<object>

    List of available HUD items for a user

  • UnitSystem
    string
      Allowed values:
    • "IMPERIAL"
    • "METRIC"
  • object

    User

  • StatementPriority
    string

    Priority of statement, determining when it will be heard.

    IMMEDIATE: Interrupt any on-going statement and speak immediately

    ASAP: Wait for any on-going statements to finish, and speak directly after

    OPTIMAL: Allow Wysp to select an optimal time within the next 3 minutes, combining the statement with other planned statements to create the best flow.

    Default value:"OPTIMAL"
      Allowed values:
    • "IMMEDIATE"
    • "ASAP"
    • "OPTIMAL"
  • object
  • object
  • object
  • object

    Positional fix from GPS

  • object

    Metadata about the state of an user, including their device health, reachability, scheduled statements, and latest location.

  • Locale
    string

    ISO 639-1 language code and ISO 3166-1 country code joined by a "_"

    Default value:"en-US"
  • object

    Statement to be made to the user, including all metadata needed to communicate it to them correctly

  • array<object>

    List of upcoming statements for a user

  • UserContextBrief
    string

    Unstructured text that is likely to contain useful information for the user. In general, this is a place to dump content that couldn't be adequately mapped to other fields. Behind the scenes, we mine this text for relevant delivery details, as well as use it for general LLM context. This is a good place for transcripts of previous conversations the customer has had with delivery users.

  • object

    Definition of an action that the user can perform using their voice. These actions typically correlate to primary buttons that are active in the screen UI.

  • array<object>
  • object [Objective Fields]
  • object

    Geographic coordinates

  • allOf

    A transfer objective models the pickup/dropoff of physical goods, or intangibles such as information and services.

  • object

    Metadata about an interactive ingress that an user must perform

  • object [Destination Arrival]

    Detailed arrival metadata for destinations

  • object [Destination]
  • allOf

    A presence objective models the task of arriving to a specific place

  • array<anyOf>

    List of currently active objectives for the user.

  • TravelMode
    string

    Travel mode influences routing, statement timing, verbosity, and other characteristics.

      Allowed values:
    • "VEHICLE"
    • "VEHICLE:CAGE"
    • "VEHICLE:MOTORBIKE"
    • "VEHICLE:MOPED"
    • "BICYCLE"
    • "BICYCLE:PEDAL"
    • "BICYCLE:ELECTRIC"
    • "FOOT"
  • object

    Description of the user's situation, including their current objectives and actions.

  • object

    Updates to the user's context.

  • object

    GeoJSON describing the user's current position and planned routes.

  • object
  • object

    Audio clip

  • object

    Item to be displayed on the HUD within a specific geographic location

  • object
  • object
  • object
  • object
  • object
  • array<object>

    List of fixes to submit

  • object
  • object
  • object
  • object
  • object
  • object
  • object
  • object
  • object