Cuando se recibe un webhook

​

Crear con IA

​

Configuración

​

Cómo configurarlo

1. Abre tu Automatización y añade un disparador nuevo.
2. Selecciona Cuando se recibe un webhook.
3. El disparador genera inmediatamente una URL de webhook única. Copia esta URL; la necesitarás para el sistema externo.
4. (Opcional, pero recomendado) Haz clic en Generar token para habilitar la autorización mediante Token Bearer. Se generará un token que deberá incluirse en la cabecera Authorization de las solicitudes entrantes.
5. Guarda y activa la Automatización.
6. Configura tu sistema externo para que envíe una solicitud POST a la URL del webhook. Incluye el token en la cabecera si habilitaste la autorización.
7. Envía una solicitud de prueba (consulta los ejemplos siguientes). Comprueba el historial de ejecuciones de la Automatización para verificar que los datos se recibieron correctamente.
8. Añade los pasos de acción. Haz clic en + en cualquier Campo de acción para hacer referencia a valores del cuerpo JSON del webhook.

​

Datos disponibles para los pasos siguientes

{
  "order_id": "12345",
  "customer": "Alice",
  "amount": 99.95
}

​

Personalizar la respuesta

{"challenge":"{{body.challenge}}"}

​

Probar el webhook

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -d '{"test": true, "message": "Hola desde curl"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{"order_id": "12345", "status": "paid"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{
    "event": "invoice.paid",
    "data": {
      "invoice_id": "INV-001",
      "amount": 250.00,
      "currency": "USD",
      "customer_email": "alice@example.com"
    }
  }'

​

Límites de frecuencia

​

Prácticas recomendadas de seguridad

• Usa siempre la autorización mediante Token Bearer para los webhooks de producción. Cualquiera que descubra una URL de webhook pública puede activarla.
• Mantén privada la URL del webhook. Trátala como una contraseña. No la incluyas en repositorios públicos ni la compartas en canales abiertos.
• Regenera el token si sospechas que ha quedado expuesto. Puedes generar uno nuevo en cualquier momento desde el panel del disparador.
• Valida los datos en el flujo de trabajo. No des por hecho que los datos entrantes tienen el formato correcto. Usa filtros o pasos de script para comprobar que los Campos obligatorios estén presentes antes de procesarlos.
• Supervisa el historial de ejecuciones. Revisa periódicamente los registros de ejecución de la Automatización para detectar solicitudes inesperadas o no autorizadas.

​

Cuándo usarlo

• Recibir eventos de pago de Stripe o PayPal. Configura un webhook de Stripe para enviar eventos invoice.paid a tu Automatización de Teable y crear o actualizar automáticamente Registros de pedidos.
• Aceptar envíos de formularios de tu sitio web. Dirige el formulario de contacto o registro de tu sitio web a la URL del webhook para crear Registros directamente en Teable.
• Ingerir datos de dispositivos IoT. Los sensores o dispositivos capaces de enviar solicitudes HTTP pueden transmitir datos a Teable para su supervisión y generar alertas.
• Conectar pipelines de CI/CD. Activa flujos de trabajo cuando una compilación se complete correctamente o falle: crea Registros, envía notificaciones o actualiza el estado del proyecto.
• Recibir eventos de cualquier herramienta SaaS. Muchas herramientas (GitHub, Jira, Shopify, Twilio, etc.) admiten notificaciones mediante webhook. Dirígelas a tu webhook de Teable para automatizar flujos de trabajo entre herramientas.

​

Consejos

• El webhook solo acepta solicitudes POST. GET, PUT y otros métodos no activarán la Automatización.
• Envía siempre una cabecera Content-Type: application/json. Si el cuerpo no es un JSON válido, es posible que el disparador no analice correctamente los datos.
• Si necesitas enviar datos desde un sistema que no admite cabeceras personalizadas (para la autenticación Bearer), considera usar el modo público, pero añade una clave secreta al cuerpo JSON para que el flujo de trabajo la valide mediante un filtro o script.
• Para depurar, puedes usar servicios como webhook.site para inspeccionar lo que envía realmente tu sistema externo antes de dirigirlo a Teable.

​

Contenido relacionado

• Acción Solicitud HTTP — la operación de salida equivalente: llama a API externas desde tu flujo de trabajo
• Ejecutar script — para el procesamiento avanzado de cargas útiles de webhooks
• Acción Bucle (lote) — procesa matrices de las cargas útiles de webhooks