Conceitos
Roteiros
O recurso central do LiveTP, compartilhado entre web, apps, API, MCP e webhooks.
Um roteiro é o texto que você lê no teleprompter. Ele pertence a uma única conta e só pode ser acessado com credenciais dessa conta. Web, apps nativos, API e MCP usam o mesmo repositório, as mesmas validações e o mesmo histórico de revisões.
Objeto roteiro
{
"id": "67a92051-1245-4126-b9b4-2c532084ae16",
"title": "Lançamento do produto",
"content": "Olá! Hoje vou mostrar três novidades...",
"status": "ready",
"revision": 4,
"createdAt": "2026-10-30T15:00:00.000Z",
"updatedAt": "2026-10-30T15:42:10.512Z",
"deletedAt": null
}Identificador único. Pode ser gerado pelo cliente na criação.
Título com 1 a 160 caracteres.
Texto do roteiro, com até 100 mil caracteres. Quebras de linha são sempre \n.
Etapa de produção. Veja Status.
Número que aumenta a cada gravação. Use-o como expectedRevision para editar. Veja Revisões e conflitos.
Data de criação em ISO 8601 (UTC).
Data da última gravação.
Quando preenchido, o roteiro está na lixeira.
Status
| Valor | Na interface | Uso sugerido |
|---|---|---|
draft | Rascunho | Texto em elaboração. |
ready | Pronto | Pronto para gravar. Ótimo gatilho de automações. |
review | Em revisão | Aguardando aprovação ou ajustes. |
completed | Concluído | Já gravado ou publicado. |
O valor legado done é aceito nas gravações e salvo como completed.
Lixeira
Excluir um roteiro pela API ou pelo MCP não apaga o conteúdo: o roteiro vai para a lixeira (deletedAt preenchido) e pode ser restaurado.
- Roteiros na lixeira continuam acessíveis em Ler roteiro e em Listar roteiros com
deleted=true. - Só é possível editar roteiros ativos. Restaure antes de alterar o texto.
- Mover para a lixeira e restaurar também incrementam a revisão.
Onde os roteiros aparecem
Alterações feitas por qualquer integração aparecem na biblioteca web, que consulta mudanças a cada cinco segundos enquanto está visível, e nos apps atualizados, que fazem o mesmo em primeiro plano. Veja Sincronização.