Webhooks

Aponte o Synup para uma URL HTTPS e enviaremos um payload JSON assinado a cada evento em sua conta — uma avaliação chega, um perfil é publicado, uma sincronização falha. Um endpoint de webhook por agência.

Configurando seu endpoint

Adicione e gerencie seu endpoint de webhook em Configurações → Desenvolvedor → Webhooks. Seu endpoint deve aceitar requisições HTTPS POST e responder com status 2xx em até 10 segundos — qualquer outra coisa conta como uma entrega falhada e é repetida.

Cada agência recebe exatamente um endpoint de webhook. Somente os tipos de eventos já ativos — no momento os dois do Sydekick Agent, veja a página da API do Agent — são assinados automaticamente ao criá-lo; o restante do catálogo está no roadmap e passará a ser assinado assim que seu domínio for lançado. Gerencie sua seleção quando quiser na aba Eventos.

Assinatura e payloads

Verifique se cada requisição realmente vem do Synup e entenda o formato do envelope.

Tipos de eventos

Explore o catálogo completo de eventos em 13 domínios e veja o que já está ativo hoje.

Entrega e repetição

Cronograma de novas tentativas, pausa automática, solução de problemas e repetição de entregas anteriores.

Boas práticas

Orientações de idempotência, segurança e confiabilidade para uma integração em produção.