Los webhooks permiten que Smartsupp envíe notificaciones en tiempo real a cualquier URL que elijas — en cuanto se abre una conversación, se crea un contacto o se entrega un mensaje, tu sistema recibe la información. Este artículo explica qué son los webhooks, cómo configurarlos en tu panel de control y cómo conectarlos a plataformas de automatización como Make y n8n.

Hemos dividido el artículo en varias secciones:

¿Para qué sirven los webhooks?

Un webhook es un mensaje HTTP automático que Smartsupp envía a una URL de tu elección cada vez que se produce un evento seleccionado. En lugar de consultar periódicamente si hay cambios, tus herramientas reciben los datos en cuanto ocurre algo.

Algunos casos de uso habituales son:

Plataformas de automatización — activa flujos de trabajo en Make, n8n o herramientas similares para añadir contactos a un CRM, publicar notificaciones en Slack o registrar leads en una hoja de cálculo
Sistemas internos — incorpora datos de conversaciones y contactos a paneles de control, almacenes de datos o sistemas de tickets en tiempo real
Notificaciones — avisa a tu equipo cuando se valoren conversaciones o cuando falle la entrega de mensajes

Consejo: Los webhooks están disponibles en el Plan Plus y superiores — Plus incluye 1 webhook, Expert incluye 3 y Ultimate ofrece un límite personalizado. Comparar planes →

Crear un webhook

Configurar un webhook solo requiere unos pocos pasos en tu panel de control de Smartsupp:

1. Abre Ajustes y ve a la sección Webhooks .
2. Haz clic para añadir un nuevo webhook e introduce tu URL del endpoint — la dirección a la que Smartsupp enviará los datos de los eventos.
3. Selecciona los Eventos que quieras recibir (consulta la lista completa en la siguiente sección).
4. Guarda el webhook. A partir de ese momento, los eventos seleccionados se entregarán mediante solicitudes HTTP POST con cargas útiles JSON.

Nota: Los webhooks configurados anteriormente siguen funcionando con normalidad. Estamos trabajando para que todos los webhooks existentes sean visibles y se puedan gestionar desde la nueva sección del panel de control.

⚠️ ¿Has creado webhooks anteriormente? Los webhooks antiguos aún no aparecen en esta sección — siguen funcionando como antes. Estamos unificando el sistema antiguo y el nuevo para que puedas gestionarlo todo desde un único lugar.

Eventos disponibles

Smartsupp puede notificar a tu endpoint eventos de tres categorías. Selecciona solo los eventos que realmente necesita tu flujo de trabajo — así reduces la carga de tu endpoint y evitas tráfico innecesario.

Contactos

contact.created
contact.updated
contact.acquired
contact.banned
contact.unbanned

Conversaciones

conversation.opened
conversation.closed
conversation.closed_by_contact
conversation.rated
conversation.agent_assigned
conversation.agent_unassigned
conversation.agent_joined
conversation.agent_left
conversation.agent_replied
conversation.bot_replied
conversation.contact_replied
conversation.message_delivered
conversation.message_delivery_failed

Visitantes

visitor.connected
visitor.disconnected
visitor.updated
visitor.typing
visitor.triggered
visitor.replied

Recursos relacionados: Documentación para desarrolladores de Smartsupp — esquemas completos de las cargas útiles JSON para cada tipo de evento.

Probar tu webhook

Antes de ponerlo en producción, utiliza la característica de prueba integrada para comprobar que tu endpoint es accesible y que tu escenario de Make o n8n está configurado correctamente.

En los ajustes de tu webhook en el panel de control, haz clic en Enviar prueba. Smartsupp enviará una carga útil de ejemplo a la URL de tu endpoint. Comprueba en tu servicio receptor que los datos han llegado en el formato esperado.

Consejo: En Make, tu escenario debe estar activo y a la escucha antes de enviar la prueba. En n8n, cambia el nodo Webhook a su URL de producción y asegúrate de que el flujo de trabajo esté activo.

Entrega, reintentos y seguridad

Smartsupp está diseñado para entregar los eventos de webhook de forma fiable, incluso cuando tu endpoint no está disponible temporalmente.

Formato — todos los eventos se envían mediante solicitudes HTTP POST con un cuerpo JSON que describe el evento y sus datos
Respuesta — tu endpoint debería responder con un código de estado HTTP 2xx lo más rápido posible; las respuestas lentas pueden retrasar los reintentos
Reintentos — si la entrega falla, Smartsupp vuelve a intentarlo con intervalos cada vez mayores durante un máximo de 3 días
Desactivación automática — los endpoints que fallan de forma persistente se desactivan automáticamente; puedes volver a activarlos en el panel de control en cualquier momento
Seguridad — cada solicitud de webhook está firmada para que puedas verificar que realmente procede de Smartsupp; consulta docs.smartsupp.com para conocer los detalles de la verificación de la firma

Nota: Si tu endpoint se desactiva debido a fallos repetidos, vuelve a activarlo en Ajustes → Webhooks tras solucionar el problema subyacente. Smartsupp reanudará el envío de eventos de inmediato.

Conectar Smartsupp a Make o n8n

Conectar Smartsupp a una plataforma de automatización requiere cuatro pasos. El proceso es el mismo para Make y n8n — solo cambia el nodo activador.

1. En Make, añade un activador Webhooks → Webhook personalizado y copia la URL generada. En n8n, añade un nodo activador Webhook y copia su URL de producción.
2. En Smartsupp, ve a Ajustes → Webhooks, crea un nuevo webhook y pega la URL copiada.
3. Selecciona los eventos que necesites y guarda el webhook.
4. Haz clic en Enviar prueba para que Make o n8n capture la estructura de los datos — después, crea el resto de tu escenario o flujo de trabajo a partir de ella.

Consejo: En Make, activa tu escenario antes de enviar la prueba — de lo contrario, no se capturarán los datos del webhook. En n8n, utiliza la URL de producción (no la URL de prueba) al configurar el webhook de Smartsupp.

¿Cuál es el siguiente paso?

API REST de Smartsupp — explora la API completa para leer y escribir datos de Smartsupp mediante programación.
Automatizaciones — configura automatizaciones basadas en reglas que se activen directamente en Smartsupp sin una herramienta externa.
Visión general de las integraciones — consulta todas las integraciones nativas disponibles con CRM, plataformas de e-commerce y mucho más.

💡 ¿Necesitas más ayuda? Contacta con nuestro Equipo de soporte — ¡estaremos encantados de ayudarte!

Webhooks: conecta Smartsupp a Make, n8n y tus propias herramientas