New Websocket
GET {{baseUrl}}/1/websockets/new
Returns a websocket URL to connect to. The URL may expire if no connection is initiated within 60 seconds.
Websocket Events:
Each event sent through the websocket is a JSON object with a type indicating what happened.
type
- What type of event this packet represents. The list of
types include the following:
message
- A new message was sent, includes message, user, and thread.heartbeat
- Periodically sent to keep the connection open.alive
- Reply sent if the client sends {type
:heartbeat
}.error
- Sent in response to any unrecognized command, includes debug.
message
- A Quip message in the format described in
Get Recent Messages.
user
- An object containing the ID and name of the user who sent
the message.
thread
- An object containing the ID and title (if any) of the
thread the message was sent on.
debug
- A string with additional debug information.
Example Websocket Events:
{
"type": "heartbeat"
}
{
"type": "alive"
}
{
"type": "error",
"debug": "Unsupported command."
}
RESPONSES
status: OK
{"url":"wss://listen0.quip.com:443/platform/listen/0?t=1","user_id":"KaDAEAinU0V"}