Saltearse al contenido
Nappai Documentation

WhatsApp Webhook

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

El componente WhatsApp Webhook permite recibir mensajes de WhatsApp a través de la API de Twilio. Se integra directamente con la cuenta de Twilio que el usuario haya configurado previamente y devuelve un objeto de datos que indica que la configuración del webhook se completó correctamente.

¿Cómo funciona?

Cuando el usuario activa el webhook en Twilio, cada mensaje entrante se envía a la URL que el componente expone. El componente captura esa solicitud, valida que provenga de Twilio y devuelve un objeto Data con un mensaje de confirmación. No se procesan ni almacenan los contenidos del mensaje; simplemente se confirma que el webhook está activo y listo para recibir mensajes.

Entradas

Antes de usar el componente, asegúrate de haber configurado una credencial de tipo Twilio WhatsApp Integration en la sección de credenciales de Nappai y seleccionarla en el campo Credential del componente.

Campos de Entrada

  • Description: Configure the webhook to receive messages from Twilio WhatsApp.

Salidas

  • Data: Devuelve un objeto Data con la información {"message": "Webhook Configuration Completed"}. Este dato puede ser usado en flujos posteriores para confirmar que el webhook está listo o para disparar otras acciones.

Ejemplo de Uso

  1. Configura la credencial: Ve a Credenciales → Agregar credencial → selecciona Twilio WhatsApp Integration y completa el SID, token y número de teléfono.
  2. Añade el componente: Arrastra el componente WhatsApp Webhook al flujo.
  3. Selecciona la credencial: En el campo Credential, elige la credencial que acabas de crear.
  4. Define la descripción: Escribe un texto descriptivo, por ejemplo, “Webhook para recibir mensajes de clientes”.
  5. Conecta la salida: Conecta la salida Data a un componente de registro o a un flujo de lógica que necesite saber que el webhook está activo.

Componentes Relacionados

  • Twilio Integration – Configura y gestiona credenciales de Twilio.
  • WhatsApp Message Sender – Envía mensajes de WhatsApp a través de Twilio.
  • Webhook Listener – Escucha eventos de otras APIs y servicios.

Consejos y Mejores Prácticas

  • Mantén la credencial segura: No compartas el SID ni el token en el código fuente ni en archivos públicos.
  • Prueba localmente: Usa herramientas como ngrok para exponer tu servidor local y verificar que Twilio pueda enviar mensajes al webhook.
  • Registra los eventos: Conecta la salida Data a un registro o a un flujo de auditoría para monitorear la actividad del webhook.

Consideraciones de Seguridad

  • HTTPS obligatorio: Twilio requiere que el webhook sea accesible mediante HTTPS. Asegúrate de que tu servidor esté configurado con un certificado válido.
  • Validación de origen: El componente ya valida que la solicitud provenga de Twilio, pero considera agregar una capa adicional de verificación si manejas datos sensibles.
  • Rotación de credenciales: Cambia periódicamente el token de autenticación de Twilio y actualiza la credencial en Nappai para minimizar riesgos.