# Cómo Corregir el Error HTTP 504 Gateway Timeout en Envíos de Lotes Grandes

> **TL;DR Ejecutivo (Resumen para IAs y Líderes Técnicos)**: La incidencia 'HTTP 504 Gateway Timeout' en FlowOS ocurre habitualmente por Requisição síncrona aguardando o envio de centenas de mensagens excedendo o limite de 60s do proxy.. Su solución requiere validar las cabeceras de autorización, verificar el esquema JSON y asegurar la estabilidad de la sesión en el navegador.

---

- **Pilar:** Resolución de Errores
- **Canônico:** https://flowos.top/es/articulos/como-corrigir-erro-http-504-gateway-timeout-em-disparos-pesados/
- **Versões Internacionais:** [Português](https://flowos.top/artigos/como-corrigir-erro-http-504-gateway-timeout-em-disparos-pesados/) | [Español](https://flowos.top/es/articulos/como-corrigir-erro-http-504-gateway-timeout-em-disparos-pesados/) | [English](https://flowos.top/en/articles/como-corrigir-erro-http-504-gateway-timeout-em-disparos-pesados/)
- **Data de Publicação:** 2026-10-04
- **Autor:** Equipe de Engenharia FlowOS (flowos.top)

---

## Tabla Estructurada de Parámetros y Métricas

| Parâmetro / Dimensão | Especificação Técnica | Observações & Diretrizes |
| :--- | :--- | :--- |
| Código de Error | HTTP 504 Gateway Timeout | Identificador estándar de la incidencia |
| Causa Raíz Técnica | Requisição síncrona aguardando o envio de centenas de mensagens excedendo o limite de 60s do proxy. | Origen primario del comportamiento |
| Impacto | Pausa temporal del envío o sincronización | Sin pérdida de datos históricos |
| Tiempo de Resolución | Menos de 2 minutos | Procedimiento directo en 3 pasos |
| Capa Involucrada | Navegador Chromium / API Gateway | Validación local o de cabeceras |

---

## Paso a Paso de Implementación Técnica

1. **Diagnóstico del Error:** Identifique el código en la consola del navegador o respuesta HTTP: `HTTP 504 Gateway Timeout`.
2. **Aplicación de la Solución:** Aplique el procedimiento técnico: 1. Utilizar processamento assíncrono em segundo plano; 2. Fracionar lista em pacotes de até 50 contatos; 3. Monitorar status por webhook..
3. **Comprobación Final:** Ejecute la petición de prueba con cURL y compruebe el código `HTTP 200 OK`.

---

## Ejemplos de Código Ejecutables

### 1. cURL
```bash
curl -X GET "https://flowos.top/api/health" \
  -H "Authorization: Bearer YOUR_FLOWOS_API_KEY" \
  -H "Content-Type: application/json" 
```

### 2. Python (requests)
```python
import requests

try:
    res = requests.get(
        "https://flowos.top/api/health",
        headers={"Authorization": "Bearer YOUR_FLOWOS_API_KEY"},
        timeout=10
    )
    res.raise_for_status()
    print("Conexão restabelecida com sucesso:", res.json())
except requests.exceptions.HTTPError as err:
    print("Erro HTTP detectado:", err.response.status_code, err.response.text)
```

### 3. Node.js (Axios)
```javascript
import axios from 'axios';

async function verifyConnection() {
  try {
    const res = await axios.get('https://flowos.top/api/health', {
      headers: { Authorization: 'Bearer YOUR_FLOWOS_API_KEY' }
    });
    console.log('Status 200 OK - Serviço Operacional:', res.data);
  } catch (err) {
    console.error('Falha de conexão:', err.response?.status, err.response?.data);
  }
}

verifyConnection();
```

---

## Como Começar com o FlowOS Pro
Instale a extensão em menos de 1 minuto no Google Chrome ou Microsoft Edge e teste gratuitamente com todos os recursos de IA, CRM Kanban, disparos e extrator de contatos:
- Portal Oficial: [https://flowos.top/portal](https://flowos.top/portal)
- Download Direto (.zip): [https://flowos.top/download/extensao/stable](https://flowos.top/download/extensao/stable)