Webhooks
Introdução
Receba uma notificação assinada sempre que um roteiro mudar na sua conta.
Webhooks avisam a sua aplicação, em tempo real, quando algo acontece com os roteiros da conta, seja a mudança feita na web, no app, pela API ou por um agente MCP. Em vez de consultar a API periodicamente, você recebe um POST HTTPS assinado no endereço que cadastrar.
Exemplos de automação:
- Roteiro vira Pronto → criar uma tarefa de gravação no seu gerenciador de projetos.
- Agente cria um roteiro pelo MCP → iniciar um fluxo de revisão ou aprovação.
- Roteiro é editado → atualizar o documento correspondente em outro sistema.
- Roteiro vai para a lixeira → cancelar a tarefa associada.
Como funciona
- Uma alteração é salva no LiveTP.
- Na mesma transação, o LiveTP registra o evento e uma entrega para cada destino ativo interessado.
- Um processo dedicado envia o
POSTassinado, com até sete tentativas em 24 horas. - Seu endpoint verifica a assinatura, registra o evento e responde
2xx.
Uma falha no seu endpoint nunca impede o salvamento do roteiro nem a sincronização dos apps.
Configure um destino
Cadastre o endereço
Na web, abra Integrações → Webhooks e preencha o formulário Novo webhook. Informe um nome, a URL HTTPS do destino e os eventos desejados. Para script.status_changed, você pode filtrar um status de destino, como Pronto.
Guarde o segredo
O segredo de assinatura (whsec_…) aparece uma única vez. Guarde-o no seu receptor, por exemplo em uma variável de ambiente.
Envie o teste
Clique em Enviar teste. O LiveTP envia um evento webhook.test com um challenge aleatório. Depois de verificar a assinatura, seu endpoint deve responder 200 com o mesmo valor:
{ "challenge": "valor recebido em data.challenge" }Ative
Depois da confirmação do teste, clique em Ativar. A partir daí, novas alterações geram entregas. Eventos anteriores à ativação não são enviados.
Sessão recente
Cadastrar um destino, trocar a URL e rotacionar o segredo exigem uma sessão iniciada há menos de 15 minutos. Se a sessão for antiga, saia e entre novamente. Chaves de API e conexões MCP não gerenciam webhooks.
Requisitos do destino
Para evitar abusos, o LiveTP só entrega em endereços públicos:
- HTTPS na porta 443, com certificado válido.
- Sem usuário e senha na URL, sem query string e sem fragmento (
#). - Nome de domínio público: IPs literais,
localhost,.local,.internale os domínios do LiveTP são recusados. - Todos os endereços resolvidos pelo DNS precisam ser públicos. A conexão é fixada no IP verificado.
- Redirecionamentos não são seguidos.
Para testar uma instância local, exponha-a com um túnel HTTPS público.
Autenticação adicional
Se o seu receptor exige um token próprio (como uma credencial Header Auth no n8n), preencha Token Bearer do destino ao cadastrar. O LiveTP envia Authorization: Bearer SEU_TOKEN em cada entrega. Use um token exclusivo do receptor, nunca uma chave de API ou MCP do LiveTP.
Ambientes
Staging e produção têm destinos, segredos e eventos independentes. O campo environment de cada evento indica a origem (staging ou production). Deduplique eventos por ambiente e ID.