Configurar um webhook

Aponte o Timemark para seu endpoint, escolha quais eventos e quais projetos o acionam, e teste a entrega.

When you’d do this

Você quer que seu próprio sistema reaja quando algo acontece no Teamspace, por exemplo para registrar o envio de uma foto ou disparar um processo posterior. Um webhook faz o Timemark enviar uma solicitação POST para seu endpoint toda vez que um evento escolhido ocorre.

What you need

Função: Dono da Equipe
Plataforma: Web
Plano: Business
Afeta: Só é acionado para eventos que ocorrem depois que o webhook é criado

Configurar o webhook

Vá em Teamspace → Configurações → Integrações → Webhook.
Insira sua URL do endpoint. Ela deve ser acessível publicamente e responder a uma solicitação POST.
Confirme o gatilho. O webhook dispara em Nova foto quando uma nova foto é enviada.
Escolha o escopo: Todas as fotos, ou uma pasta específica.
Salve.

Testar a entrega

No webhook que você acabou de salvar, use a função teste ou ping para enviar um payload de exemplo.
Verifique os logs do seu endpoint para confirmar que o payload chegou.
Confirme que seu endpoint retornou uma resposta 2xx.

Campos que você pode configurar

Field	What it does	Notes
URL do endpoint	Para onde o Timemark envia a solicitação POST	Deve ser pública e retornar `2xx` dentro do tempo limite
Gatilho	A ação que dispara uma entrega	Nova foto (`photo.uploaded`) é atualmente o único gatilho. Veja Tipos de evento do webhook
Escopo	Limita o disparo a uma pasta, ou a todas as fotos da equipe	O escopo de pasta só dispara para fotos naquela pasta

Problemas comuns

Sem disparo retroativo. O webhook dispara somente para eventos após sua criação. Fotos existentes não o acionam.
O endpoint deve retornar 2xx a tempo. Um timeout ou erro é tratado como uma entrega falhada. O Timemark tenta novamente as entregas com falha, e para quando as tentativas se esgotam.
Incompatibilidade de escopo. Um webhook com escopo definido para uma pasta não dispara para fotos em outras pastas. Defina o escopo como Todas as fotos se precisar de todas as pastas.
Atrás de um firewall. Um endpoint atrás de uma VPN ou firewall não é acessível. Exponha uma URL pública.

Veja também

Última atualização: 28 de junho de 2026