Uma URL sua para a qual o sona.to envia uma requisição quando algo acontece, para que suas ferramentas reajam na hora em vez de verificar se houve mudança.

Como sei que uma requisição veio mesmo do sona.to?

Cada requisição traz uma assinatura HMAC SHA-256 sobre o carimbo de tempo e o corpo da mensagem. Recalcule com sua chave de assinatura e compare.

O que acontece se meu endpoint estiver fora do ar?

A entrega é repetida após 60 segundos, 5 minutos e 30 minutos. Um endpoint que continua falhando é desativado, e você pode reativá-lo.

Funciona com Zapier, Make e n8n?

Sim. Cada um deles fornece uma URL de webhook para colar, e o evento chega em JSON.

Preciso da API para usar webhooks?

Não. Você pode adicionar um pela página API do seu painel. Gerenciá-los pela API também é possível, se preferir.

Início / Recursos / Webhooks

Webhooks

Envie eventos para suas ferramentas no momento em que acontecem

Q: Quais eventos posso assinar?

Publicação publicada ou com falha, auditoria do site concluída ou com falha, análise de visibilidade em IA concluída ou com falha e um assistente que começa ou deixa de citar a sua marca. Você escolhe quais cada webhook recebe. Os eventos de visibilidade em IA exigem um plano que inclua Visibilidade em IA.

Receba uma requisição HTTP assinada quando uma publicação sai ou falha, ou quando termina uma auditoria do site ou uma análise de visibilidade em IA.

Comece grátis hoje

Endpoints de webhook ao lado de um evento de post assinado

Consultar uma API para saber se algo aconteceu é lento e desperdiça requisições. Os webhooks invertem a lógica: você dá uma URL ao sona.to, e o sona.to envia uma requisição HTTP assinada no momento em que uma publicação sai ou falha, ou termina uma auditoria do site ou uma análise de visibilidade em IA. Aponte para o Zapier, Make, n8n ou seu próprio servidor e o resto da sua stack reage sozinho.

Eventos no momento em que acontecem

Oito eventos cobrem os resultados que merecem uma reação: publicação publicada ou com falha, auditoria do site concluída ou com falha, análise de visibilidade em IA concluída ou com falha e um assistente que começa ou deixa de citar a sua marca. Cada um traz os mesmos campos que a API retorna, então um webhook e um GET dizem a mesma coisa.

Escolhendo quais eventos um webhook recebe

Assinado, para você poder confiar

Cada requisição traz uma assinatura HMAC SHA-256 sobre um carimbo de tempo e o corpo da mensagem, com uma chave secreta exibida uma única vez na criação do webhook. Verifique-a e você sabe que a requisição veio do sona.to e não foi reenviada.

Verificando uma requisição de webhook assinada

Novas tentativas e registro de entregas

Uma entrega com falha é repetida após 60 segundos, depois 5 minutos, depois 30 minutos. Cada tentativa fica registrada com seu código de status e sua duração, então um endpoint com problema é fácil de diagnosticar.