Un webhook es una llamada HTTP que Camtom envía automáticamente a tu servidor cuando ocurre un evento relevante: un pedimento fue prevalidado, una clasificación se completó, una MVE fue firmada, o un documento fue procesado. En lugar de hacer polling constante a la API para verificar cambios, los webhooks te notifican en tiempo real, reduciendo la latencia y el consumo de recursos.
Tu endpoint debe ser una URL pública accesible por HTTPS que acepte solicitudes POST. El endpoint debe responder con un código HTTP 200 dentro de 5 segundos para confirmar la recepción. Si no responde o devuelve un error, Camtom reintentará el envío hasta 5 veces con backoff exponencial (1, 5, 30, 120 y 600 segundos).
Desde tu panel de Camtom, navega a Configuración → Webhooks → Nuevo webhook. Ingresa la URL de tu endpoint, selecciona los eventos que quieres recibir y genera un signing secret. Camtom firmará cada solicitud con este secret usando HMAC-SHA256 para que puedas verificar la autenticidad del mensaje.
Siempre verifica la firma HMAC-SHA256 de cada webhook recibido. El header X-Camtom-Signature contiene la firma calculada sobre el body de la solicitud. Si la firma no coincide, rechaza la solicitud — podría ser un intento de suplantación.
Cada webhook contiene un JSON con el tipo de evento, la fecha, el ID del recurso afectado y los datos relevantes. Procesa los eventos de forma asíncrona: recibe el webhook, responde 200 inmediatamente, y luego procesa la lógica de negocio en segundo plano. Esto evita timeouts y garantiza que Camtom marque el envío como exitoso.
Usa el botón Enviar evento de prueba en la configuración del webhook para verificar que tu endpoint lo recibe correctamente. El log de webhooks en Camtom muestra los últimos 100 envíos con su código de respuesta, tiempo de respuesta y cuerpo de la solicitud. Si un webhook falla repetidamente, Camtom lo desactivará automáticamente y te notificará por correo.
Equipo Camtom
Equipo Editorial
Mas de 100 agencias ya usan Camtom para optimizar sus procesos.