Saltearse al contenido
Nappai Documentation

Discord Webhook

Este componente te permite conectar tus flujos de automatización en Nappai con Discord. Su función principal es preparar la configuración necesaria para enviar mensajes a un servidor de Discord.

En lugar de enviar el mensaje directamente al instante, este nodo actúa como un “preparador”. Tú configuras aquí los detalles del webhook (como la URL de conexión y el diseño) y luego puedes usar esta configuración en otros nodos para enviar el mensaje real. Esto es muy útil si quieres reutilizar la misma conexión para múltiples alertas o mensajes en tu automatización.

¿Cómo funciona?

Este componente funciona como un intermediario entre tu flujo de automatización y la plataforma de mensajería Discord.

  1. Conexión: Utiliza una “URL de Webhook” única que escribes en la configuración. Esta URL es como una dirección postal secreta que le indica a Nappai exactamente a qué canal de Discord debe entregar el mensaje.
  2. Personalización: Aquí defines cómo se verá el mensaje (el nombre del remitente, si tiene una imagen de perfil y qué texto llevarán los mensajes).
  3. Entrega: El componente devuelve una “paquete” listo para usar. Otros componentes en tu flujo tomarán este paquete y, cuando la automatización se ejecute, enviarán los mensajes a través de Discord usando los datos que configuraste aquí.

No necesitas programar ni conocer comandos complejos; solo necesitas tener la URL de tu Webhook de Discord lista.

Entradas

Para configurar este componente, debes completar los siguientes campos. Solo el campo de URL es obligatorio para que el sistema funcione correctamente.

  • Webhook URL: La dirección web única que proporcionas desde Discord. Es la llave que permite a Nappai acceder a tu canal. Sin esto, no se puede enviar ningún mensaje.
  • Content: El mensaje de texto que deseas enviar. Puedes escribir texto normal o usar formato (como negritas o listas) que Discord soporte.
  • Username: El nombre que aparecerá como el remitente del mensaje (por ejemplo, “Asistente Nappai”). Si lo dejas vacío, usará el nombre por defecto de tu webhook.
  • Avatar URL: La dirección web de una imagen pequeña (icono) que aparecerá junto al mensaje. Esto ayuda a personalizar cómo se ve la notificación.
  • Embeds: Una opción avanzada para estructurar el mensaje con cuadros de información bonitos (títulos, imágenes incrustadas, botones, etc.).

Salidas

El componente produce una salida principal que debes conectar a otros nodos:

  • Discord Webhook: Este es el resultado del componente. No es un mensaje enviado, sino la configuración lista para usar. Debes conectar este “puerto” de salida a la entrada de otro componente que tenga la función de “Enviar Mensaje” o “Publicar”.

Conectividad

Este componente suele conectarse saliente hacia:

  • Nodos de Acción (Enviar/Eject): Después de configurar la URL y el estilo en este nodo, lo conectas a nodos como “Send Message”, “Post to Channel”, o cualquier otro componente que tenga la función de ejecutar la acción en Discord.

Entradas típicas: No suele tener entradas de flujo complejas, ya que su trabajo es solo guardar la configuración. Sin embargo, su salida de “Webhook Configurado” debe recibir la conexión de otros nodos si estás encadenando acciones.

Ejemplo de Uso

Imagina que tienes un sistema de automatización para ventas en Nappai.

  1. Escenario: Quieres que, cuando un cliente realice una compra, se envíe una alerta al equipo de ventas en Discord.
  2. Configuración:
    • Arrastras el componente Discord Webhook a tu flujo.
    • En el campo Webhook URL, pegas la dirección que copiaste desde tu servidor de Discord.
    • En Username, escribes “Bot de Ventas”.
    • Importante: No envías el mensaje aquí. Dejas que este componente te devuelva su salida.
  3. Conexión:
    • Conectas la salida de este componente a un nodo de acción llamado “Send Discord Message”.
    • En ese nodo de acción, defines el mensaje específico (por ejemplo: “¡Nueva venta realizada por Juan!”).
  4. Resultado: Cuando la venta ocurre, el nodo de acción usa la configuración que creaste aquí para publicar el mensaje en el canal de Discord.

Consejos y Mejores Prácticas

  • Guarda tu URL: La “Webhook URL” es una contraseña oculta. Si alguien la obtiene, puede escribir en tu canal. Nunca la compartas públicamente.
  • Reutiliza: Si quieres enviar alertas a 3 canales diferentes, crea este componente 3 veces con 3 URLs diferentes. Es más fácil de mantener que intentar hacerlo todo en un solo lugar.
  • Valida la URL: Asegúrate de copiar la URL completa de Discord, que suele empezar con https://discord.com/api/webhooks/....

Consideraciones de Seguridad

  • Protege tu Webhook: La URL del webhook actúa como una credencial de acceso. Trátala como si fuera tu contraseña.
  • No publiques enlaces: Al usar esta herramienta, asegúrate de no estar mostrando en tus mensajes de Discord información confidencial (como contraseñas o datos bancarios), ya que cualquier persona con el enlace del webhook podría leer los mensajes que se envían.