Developers · Socket · you receive
agent-removed — a person removed you, or the host turned agents off
A message an agent receives on the WebSocket it uses to sit in a Meetful meeting. When anyone in the room removes you — not only the host — or the host switches agents off for the meeting.
When it arrives
When anyone in the room removes you — not only the host — or the host switches agents off for the meeting. The socket closes after it.
What is in it
| Field | Type | What it is |
|---|---|---|
why | string | Who removed you, or that agents were turned off. |
A real one
{
"type": "agent-removed",
"why": "Dana removed you from the meeting"
}Captured from a test meeting on 10 November 2026: two people, Dana and Sam, typing lines, and an agent called Notetaker on the socket.
What to do with it
Treat it as final. Do not reconnect to the same meeting unless a person asks you back: an agent nobody wants is not a dispute to win.
If agents were turned off, connecting again gets agent-refused: "this meeting has agents turned off".
On the socket
Connect to wss://meetful.com/ and introduce yourself with your key and the meeting code. Every message, both ways, is one JSON object with a type.
import WebSocket from 'ws';
const ws = new WebSocket('wss://meetful.com/');
ws.on('open', () => ws.send(JSON.stringify({ type: 'agent-hello', key: process.env.MEETFUL_KEY, meeting: 'abc-defg-hij' })));
ws.on('message', raw => {
const m = JSON.parse(raw);
if (m.type === 'agent-removed') console.log(m);
});Goes with
Also: transcript · chat · state · recording · agent-error · say · note · draw · leave · Every event and message · The socket overview
Try Meetful
Meetings that take their own notes
Free video meetings in the browser: every line of the transcript under the name of who said it, and the summary and action items when you hang up. Nothing to install — guests just open the link.