Que a reserva avise as suas ferramentas
Reescrever detalhes entre ferramentas falha em semanas de maior movimento. O que resolver antes de um webhook o substituir.
Para quem é este guia
Operadores de estúdio e programadores a ajudá-los, transferindo os detalhes de reserva, cliente e pagamento entre a Karavex e as ferramentas já em utilização.
Sistema editorial
A maioria das pilhas de estúdio são mantidas juntas por uma pessoa. Alguém copia a data da filmagem numa ferramenta de planeamento, o nome do cliente num pacote de contabilidade, o estado do pagamento numa folha de cálculo. Funciona silenciosamente até ao dia em que não funciona, e a verdade é que ninguém sabe dizer qual a cópia atual.
Copiar e colar é uma infraestrutura que ninguém mantém.
A redigitação é lenta, mas o maior custo é que é invisível. Não há registo de quais as transferências que ocorreram, não há sinal quando uma foi ignorada e não há forma de saber se a ferramenta de planeamento tem duas reservas em atraso. O trabalho que depende de alguém se lembrar de transferir informações é bom numa semana tranquila e falha numa semana agitada, que é exatamente quando uma transferência perdida custa mais.
Deixe o evento contar.
A versão durável é deixar que a mudança se anuncie. Um webhook envia um evento de reserva ou de pagamento para um URL que controla, para que o outro sistema reaja quando algo realmente acontece, em vez de perguntar de acordo com um horário. Duas regras práticas tornam-no fiável: dar a cada ligação a sua própria chave com o mínimo de acesso necessário, para que uma possa ser revogada sem quebrar o resto, e verificar a assinatura em cada pedido antes de agir, porque o endpoint está aberto a toda a Internet.
Uma ligação que não pode inspecionar não é uma integração. É um hábito que funciona.
Planeie o dia em que o outro lado cairá.
As integrações falham de formas pouco dramáticas: um endpoint devolve erros durante uma tarde, um certificado expira, uma implementação deixa o recetor offline. A questão é se alguém descobrirá. O histórico de entregas transforma isto em algo visível, e a rotação de uma chave ou de um segredo de endpoint permanece uma rotina e não uma emergência. Comece com um evento importante, assista-o durante uma semana e adicione o seguinte.
O que resolver antes que a primeira ligação entre no ar
- Qual o evento que o outro sistema realmente necessita e o que fará quando chegar.
- Uma chave com escopo apenas para esta ligação, pelo que revogá-la não quebra mais nada.
- Verificação da assinatura do destinatário e de alguém que lê o histórico de entregas.
Menos cópias, uma fonte.
O objetivo não é automatizar tudo. É que o registo de reserva continua a ser a versão que tudo o resto segue, de modo que a ferramenta de planeamento, as contas e o calendário são lidos a partir do mesmo trabalho, em vez de três cópias meio recordadas do mesmo.
Perguntas frequentes
Quando é que um webhook é melhor do que exportar uma folha de cálculo?
Quando o outro sistema precisa de agir sobre uma mudança em vez de a rever mais tarde. Uma exportação responde ao que aconteceu no mês passado. Um webhook permite que uma ferramenta reaja quando uma reserva é confirmada ou um pagamento é efetuado, o que é a diferença entre um relatório e um fluxo de trabalho.
Como posso saber se um pedido veio realmente da Karavex?
Verifique a assinatura antes de agir de acordo com a mesma. Um endpoint webhook é um URL público, pelo que qualquer coisa na Internet pode ser publicada nele. A verificação da assinatura é o que separa um evento real de um pedido que simplesmente se parece com um.
O que acontece quando o sistema recetor está inoperacional?
Verifique o histórico de entregas em vez de adivinhar. As falhas são visíveis aí, e é assim que um problema de integração se torna algo que se pode diagnosticar, em vez de um silêncio que ninguém repara até que um cliente pergunte.