Los webhooks permiten a Smartsupp enviar notificaciones en tiempo real a cualquier URL que elija — en el momento en que se abre una conversación, se crea un contacto o se entrega un mensaje, su sistema lo sabe. Este artículo explica qué son los webhooks, cómo configurarlos en el panel 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 su elección cada vez que ocurre un evento seleccionado. En lugar de consultar los cambios, sus herramientas reciben los datos en el momento en que ocurre algo.
Los casos de uso típicos incluyen:
Plataformas de automatización — activar flujos de trabajo en Make, n8n o herramientas similares para agregar contactos a un CRM, publicar notificaciones en Slack o registrar leads en una hoja de cálculo
Sistemas internos — enviar datos de conversaciones y contactos a paneles, almacenes de datos o sistemas de tickets en tiempo real
Notificaciones — alertar a su equipo cuando las conversaciones reciben valoraciones o cuando falla 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 requiere solo unos pocos pasos en su panel de Smartsupp:
1. Abra Configuración y navegue a la sección Webhooks.
2. Haga clic para agregar un nuevo webhook e introduzca su URL de endpoint — la dirección a la que Smartsupp enviará los datos del evento.
3. Seleccione los eventos que desea recibir (consulte la lista completa en la siguiente sección).
4. Guarde el webhook. A partir de ese momento, los eventos seleccionados se entregan como solicitudes HTTP POST con cargas JSON.
Nota: Los webhooks configurados anteriormente siguen funcionando con normalidad. Se está trabajando para que todos los webhooks existentes sean visibles y gestionables desde la nueva sección del panel.
Eventos disponibles
Smartsupp puede notificar a su endpoint sobre eventos en tres categorías. Seleccione solo los eventos que su flujo de trabajo realmente necesita — esto mantiene su endpoint ágil y evita tráfico innecesario.
Contactos
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Conversaciones
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Visitantes
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Recursos relacionados: Documentación para desarrolladores de Smartsupp — esquemas completos de payload JSON para cada tipo de evento.
Probar el webhook
Antes de activarlo, use la función de prueba integrada para verificar que su endpoint es accesible y que su escenario de Make o n8n está correctamente configurado.
Desde la configuración de webhooks en el panel, haga clic en Enviar prueba. Smartsupp enviará una carga de muestra a su URL de endpoint. Compruebe su servicio receptor para confirmar que los datos llegaron en el formato esperado.
Consejo: En Make, su escenario debe estar activo y escuchando antes de enviar la prueba. En n8n, cambie el nodo Webhook a su URL de producción y asegúrese de que el flujo de trabajo esté activo.
Entrega, reintentos y seguridad
Smartsupp está diseñado para entregar eventos de webhook de forma fiable, incluso cuando su endpoint no está disponible temporalmente.
Formato — todos los eventos se envían como solicitudes HTTP POST con un cuerpo JSON que describe el evento y sus datos
Respuesta — su endpoint debe responder con un código de estado HTTP 2xx lo antes posible; las respuestas lentas pueden retrasar los reintentos
Reintentos — si la entrega falla, Smartsupp reintenta con retrasos crecientes durante hasta 3 días
Desactivación automática — los endpoints que fallan de forma persistente se desactivan automáticamente; puede reactivarlos en el panel en cualquier momento
Seguridad — cada solicitud de webhook está firmada para que pueda verificar que realmente proviene de Smartsupp; consulte docs.smartsupp.com para más detalles sobre la verificación de firmas
Nota: Si su endpoint está desactivado por fallos repetidos, reactívelo en Configuración → Webhooks después de 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 difiere el nodo desencadenador.
1. En Make, agregue un desencadenador Webhooks → Webhook personalizado y copie la URL generada. En n8n, agregue un nodo desencadenador Webhook y copie su URL de producción.
2. En Smartsupp, vaya a Configuración → Webhooks, cree un nuevo webhook y pegue la URL copiada.
3. Seleccione los eventos que necesita y guarde el webhook.
4. Haga clic en Enviar prueba para que Make o n8n capturen la estructura de datos — luego construya el resto de su escenario o flujo de trabajo sobre esa base.
Consejo: En Make, active su escenario antes de enviar la prueba — de lo contrario, los datos del webhook no se capturarán. En n8n, use la URL de producción (no la URL de prueba) al configurar el webhook de Smartsupp.
¿Qué sigue?
Smartsupp REST API — explore la API completa para leer y escribir datos de Smartsupp mediante programación.
Automatizaciones — configure automatizaciones basadas en reglas que se activan directamente dentro de Smartsupp sin una herramienta externa.
Descripción general de integraciones — vea todas las integraciones nativas disponibles con CRMs, plataformas de comercio electrónico y más.
💡 ¿Necesita más ayuda? Contacte con nuestro equipo de soporte — estaremos encantados de ayudarle.