← Centro de ayuda

Integraciones

Integraciones con tus sistemas

Credenciales, integraciones guardadas, peticiones HTTP y webhooks.

Con los nodos Petición HTTP y Webhook tus flujos pueden consultar o enviar datos a cualquier API pública: tu CRM, tu sistema de reservas, tu inventario o una hoja de cálculo con API.

1. Guarda la credencial

En Configuración → Credenciales guarda el token o la clave de tu API. Se almacena cifrada y es de solo escritura: nadie puede volver a verla, ni siquiera tú; solo se puede reemplazar. Crear credenciales requiere rol de admin.

2. Crea una integración (opcional, recomendado)

En Integraciones, una integración guarda la URL base de tu API, cabeceras comunes y la credencial. Así, en cada nodo solo escribes la ruta (por ejemplo /api/clientes). Usa «Probar» para comprobar que responde.

3. Úsala en el flujo

  • Petición HTTP: elige método (GET, POST, PUT, PATCH o DELETE), ruta o URL, parámetros, cabeceras y cuerpo JSON. Puedes usar variables en todos ellos. La respuesta se guarda en la variable que indiques.
  • Webhook: envía un POST para avisar a otro sistema, por ejemplo cuando se captura un prospecto.
  • Ajusta el tiempo límite (1 a 30 segundos), los reintentos (hasta 5) y qué códigos de respuesta cuentan como éxito. Si falla, el flujo sigue por la salida «Error».

Cuerpo JSON con variables

Dentro de comillas, "{{nombre}}" se inserta como texto; sin comillas, {{total}} se inserta como valor JSON (número, objeto…).

Reglas de seguridad

  • Solo se permiten URLs https:// públicas. Por seguridad se bloquean direcciones internas o privadas (localhost, redes 10.x, 192.168.x, etc.).
  • En POST y PATCH, Masterflow envía una cabecera Idempotency-Key estable para que, si hay un reintento, tu API pueda evitar duplicados.
  • Las credenciales nunca aparecen en los registros ni en las pantallas de ejecución.

¿Te quedó alguna duda? Escríbenos.