¿Qué es un webhook?

Una URL tuya a la que sona.to envía una solicitud cuando ocurre algo, para que tus herramientas reaccionen de inmediato en lugar de comprobar si hay cambios.

¿Cómo sé que una solicitud viene realmente de sona.to?

Cada solicitud lleva una firma HMAC SHA-256 sobre la marca de tiempo y el cuerpo. Recalcúlala con tu clave de firma y compara.

¿Qué pasa si mi endpoint no está disponible?

El envío se reintenta a los 60 segundos, 5 minutos y 30 minutos. Un endpoint que sigue fallando se desactiva, y puedes volver a activarlo.

¿Funciona con Zapier, Make y n8n?

Sí. Cada uno te da una URL de webhook para pegar, y el evento llega en formato JSON.

¿Necesito la API para usar webhooks?

No. Puedes añadir uno desde la página API de tu panel. Gestionarlos mediante la API también es posible si lo prefieres.

Inicio / Características / Webhooks

Webhooks

Envía eventos a tus herramientas en el momento en que ocurren

Q: ¿A qué eventos puedo suscribirme?

Publicación publicada, publicación fallida, auditoría del sitio completada y auditoría del sitio fallida. Tú eliges cuáles recibe cada webhook.

Recibe una solicitud HTTP firmada cuando una publicación se publica, falla o termina una auditoría del sitio.

Empieza gratis hoy

Consultar una API para saber si algo ha ocurrido es lento y costoso. Los webhooks invierten la lógica: le das una URL a sona.to y sona.to envía una solicitud HTTP firmada en el momento en que una publicación se publica, falla o termina una auditoría. Apúntala a Zapier, Make, n8n o a tu propio servidor y el resto de tu stack reacciona solo.

Eventos en el momento

Cuatro eventos cubren los resultados que merecen una reacción: publicación publicada, publicación fallida, auditoría del sitio completada y auditoría del sitio fallida. Cada uno lleva los mismos campos que devuelve la API, así que un webhook y un GET dicen lo mismo.

Firmado, para que puedas confiar

Cada solicitud lleva una firma HMAC SHA-256 sobre una marca de tiempo y el cuerpo, con una clave secreta que se muestra una sola vez al crear el webhook. Verifícala y sabrás que la solicitud viene de sona.to y que no ha sido reenviada.

Reintentos y registro de envíos

Un envío fallido se reintenta a los 60 segundos, luego a los 5 minutos y luego a los 30 minutos. Cada intento queda registrado con su código de estado y su duración, así que un endpoint averiado es fácil de diagnosticar.

Cómo funciona

Añade una URL

Pega la dirección que te da tu herramienta. Debe usar https.

Elige tus eventos

Selecciona cuáles de los cuatro eventos debe recibir ese endpoint.

Guarda la clave secreta

La clave de firma se muestra una sola vez. Guárdala para verificar las solicitudes entrantes.

Reacciona automáticamente

Tu flujo de trabajo se ejecuta en el momento en que algo ocurre, sin consultas.

Para quién es

Usuarios de Zapier, Make y n8n que activan un flujo de trabajo cuando sale una publicación.

Equipos que envían confirmaciones o fallos de publicación a un canal de chat.