Upnify Suite
← Regresar al producto

CRM · Integraciones

Cómo configurar y probar webhooks salientes

Envía a otro sistema los datos de sucesos seleccionados en CRM y valida la solicitud antes de depender de la automatización.

Ilustración editorial del recorrido de un webhook desde un suceso de CRM hasta la respuesta del sistema externo.

Publicado el 27 de octubre de 2026

Un webhook saliente permite avisar a otro sistema cuando ocurre un suceso en CRM. En lugar de exportar registros manualmente, CRM envía una solicitud web a la dirección que indiques; el sistema receptor puede procesarla para continuar un flujo, como crear una tarea en una plataforma interna cuando se registra una venta.

Qué debes tener: una URL pública del receptor, el suceso que quieres comunicar y, si aplica, los datos de autenticación que ese sistema exige. No uses una URL privada de tu computadora.
Diagrama conceptual del recorrido de un webhook desde un suceso de CRM hasta la respuesta del sistema externo.
CRM envía una solicitud cuando ocurre el suceso configurado; el sistema externo recibe y responde.

Configura el webhook

  1. Abre CRM > Ajustes > Integraciones > Webhooks y selecciona la opción para agregar uno. Debes contar con permisos para administrar esta configuración.
  2. Asigna un nombre que identifique el destino y el propósito, por ejemplo Notificar venta al sistema interno.
  3. Elige el Suceso que activará el envío. Revisa también los filtros de entidad, campo y valor si quieres limitar qué registros lo disparan. Un filtro más restrictivo significa que otros registros no enviarán datos.
  4. Escribe la URL receptora y selecciona el método HTTP acordado con quien administra el sistema externo: GET, POST, PUT o DELETE.
  5. Configura los encabezados y el tipo de autenticación solicitado: ninguna, Bearer o API key. Si eliges API key, define si el receptor la espera en un encabezado o en la dirección de consulta. Usa solo una credencial creada para esta conexión y compártela por un canal seguro.
  6. Elige cómo preparar el cuerpo de la solicitud: payload predeterminado, mapeo sencillo de campos o JSON avanzado. Usa el modo que el receptor documente; no inventes nombres de campos. Si usas el mapeo sencillo, elige el tipo de contenido que ese sistema acepta.
  7. Activa el reenvío automático solo si tiene sentido para la integración y guarda.
Formulario de CRM para configurar un webhook saliente con evento, URL de destino, método y autenticación.
Revisa el evento y el destino antes de guardar. La captura muestra la configuración aún sin enviar solicitudes.

Prueba antes de activar el flujo

  1. En la lista, abre el menú de acciones del webhook y selecciona Prueba de ejecución.
  2. La prueba manda al destino una muestra del suceso para que puedas comprobar la URL, el método, la autenticación, el formato del payload y la respuesta. No crea un suceso real en CRM ni confirma por sí sola que el receptor haya guardado los datos.
  3. Compara el payload enviado con lo que espera la documentación del sistema externo. Revisa la respuesta que muestra CRM y corrige URL, encabezados o mapeo si el receptor rechaza la solicitud.
  4. Cuando la prueba sea correcta, revisa la ejecución más reciente y el historial disponible. Luego activa el webhook y observa el primer evento real controlado.
Para evitar duplicados: si activaste reenvíos automáticos, el sistema externo debe poder reconocer y manejar una notificación repetida. Pide a quien administra ese sistema que procese los eventos de forma idempotente; así, recibir dos veces la misma notificación no duplica una venta o una tarea.

Ejemplo

El equipo de operaciones quiere enviar al sistema interno las ventas nuevas. Configura el suceso de alta de venta, una URL de recepción aprobada, el método POST y la autenticación que exige el endpoint. En la prueba comprueba que el receptor acepta el formato de muestra; después valida una venta de prueba y confirma con el equipo externo que se creó una sola vez.

Si la prueba falla

  • No hay respuesta: verifica que la URL sea accesible desde internet, use HTTPS cuando el receptor lo requiera y no dependa de la red local.
  • El sistema rechaza la solicitud: revisa método, encabezados, credencial y tipo de contenido con la documentación del receptor.
  • Llegan campos inesperados: compara el payload mostrado por CRM con el mapeo o el JSON configurado.
  • El webhook de prueba funciona pero no llegan eventos: confirma que esté activo, que el suceso sea el esperado y que los filtros permitan el registro que estás usando.

Para construir una conexión personalizada desde tu aplicación, revisa la documentación oficial de la API de CRM. El webhook es útil para notificaciones de sucesos; la API sirve para consultar o enviar datos según las rutas y permisos documentados.