Sincronização

O LiveTP oferece três formas de acompanhar os roteiros de uma conta. Elas se complementam:

BibliotecaCopiar link da seção

Retorna a página atual da biblioteca, ordenada pela última alteração, com busca por título e texto e filtro por status. É ideal para telas e para agentes. Como a biblioteca pode mudar entre uma página e outra, ela não serve para espelhar dados com garantia de consistência.

Feed de alteraçõesCopiar link da seção

O feed é um registro ordenado de todas as gravações da conta. Cada item traz um cursor e o roteiro completo como ficou depois da mudança, inclusive quando ele foi para a lixeira.

cursor=0  →  histórico inicial completo
cursor=N  →  somente as mudanças posteriores a N

Para sincronizar:

1. Na primeira vez, chame com cursor=0 e siga nextCursor enquanto hasMore for true.
2. Aplique cada item em ordem. Se o mesmo roteiro aparecer mais de uma vez, a última ocorrência vence.
3. Guarde o último nextCursor e use-o na próxima sincronização.

O cursor é transacional: mesmo com gravações concorrentes, um cliente nunca pula uma alteração confirmada depois que avança o cursor.

WebhooksCopiar link da seção

Webhooks avisam quando algo muda, mas carregam apenas metadados (ID, status, revisão). Para obter o texto, busque o roteiro pela API. Uma combinação robusta:

1. Receba o webhook e registre o ID do evento.
2. Chame o feed a partir do seu último cursor, ou leia o roteiro citado no evento.
3. Aplique a mudança.

Atualização nos appsCopiar link da seção

A biblioteca web consulta alterações a cada cinco segundos enquanto está visível. Os apps nativos atualizados fazem o mesmo em primeiro plano e pausam durante gravações. Em caso de falha, o intervalo aumenta para trinta segundos. Por isso, um roteiro criado por API ou MCP costuma aparecer em poucos segundos sem recarregar a página.