Responder a um comando da Elo na tela aberta

Quando a Elo trabalha no Estúdio, ela envia pelo stream da conversa um evento screen_command ({id, name, projectId, args}), com name em read, edit, look, resolve_source, follow_job, export, listen ou save_preset; no editor de páginas, read, edit, look (imagem da prévia em cada largura pedida) e inspect (o DOM de cada rota da prévia, em data.documents). O editor aberto executa o comando e devolve o resultado aqui, uma única vez, dentro do tempo do comando; depois disso a resposta é ignorada e a Elo é avisada de que o editor não respondeu.

create_project chega também fora do Estúdio, com projectId vazio e o pedido do projeto em args (kind, name, media, sizes, aspect, durationMs). Quem responde é a aba da conversa: ela cria o projeto e, se o usuário escolheu abrir telas sozinho, abre o editor dele. data traz {projectId, kind, opened}, com opened true só quando o editor foi aberto. Uma aba que não pode criar responde ok false com code: no_editor, e outra aba pode responder no lugar dela.

CampoTipoRegra
okbooleantrue quando o comando foi aplicado
dataobjectresultado do comando (resumo do projeto, ids criados, estado dos trabalhos)
errorobject{code, message} quando ok é false; code em snake_case, message com até 600 caracteres
imagesstring[]no máximo 1 imagem JPEG ou PNG em data URL, até 1,5 MB

Comandos que mudam algo (edit, save_preset, create_project) só podem ser aplicados depois de POST /chat/threads/{id}/screen/{commandId}/claim e do evento screen_go com o mesmo claimant; assim, um comando que expirou nunca é aplicado mais tarde.

Só o dono da conversa responde; campos desconhecidos e corpos acima de 2 MB são recusados.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

conversa

string
required

id do comando recebido no evento screen_command

Body Params

resultado do editor (campos na tabela acima)

Headers
string

Workspace da requisição. Sem ele vale o workspace padrão da pessoa; um workspace do qual ela não participa responde 403 workspace_not_member.

string

Departamento que limita os dados. Quem não participa do departamento recebe 403; donos e administradores escolhem qualquer um.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json