Esta guía es técnica y está pensada para desarrolladores de apps del Marketplace. Para obtener acceso al panel de desarrolladores y a la documentación de webhooks de la API de Chateea, escribe a soporte de Chateea en [email protected] o por WhatsApp al +1 829-580-7071.
Por qué te conviene
- Confiabilidad: los picos temporales de tráfico o las caídas breves de tu servidor ya no hacen que pierdas eventos.
- Previsibilidad: los intervalos y el número de intentos son fijos, así que puedes calcular la latencia máxima.
- Protección de tu servidor: los reintentos se reparten en el tiempo con una variación aleatoria (jitter), así no llegan todos a la vez.
- Control: tu respuesta HTTP decide si Chateea sigue reintentando o no.
Cómo se reintenta según la respuesta
El comportamiento depende del tipo de fallo que devuelva tu endpoint:Calendario para respuestas 429
El ciclo termina cuando se agotan los 6 reintentos o cuando tu endpoint devuelve una respuesta distinta de 429, lo que ocurra primero.
Qué es el jitter
A cada intervalo de 10 minutos se le suma o resta una pequeña cantidad aleatoria de segundos. Si muchos eventos se frenaron al mismo tiempo, sus reintentos no llegan todos en el mismo instante, lo que evita que tu servidor vuelva a saturarse en cadena.Qué códigos devolver
Qué cambia para tu app
No tienes que configurar nada. Si tu app ya recibe webhooks del Marketplace:- El comportamiento para las respuestas 429 sigue igual.
- Los demás fallos temporales ahora también se reintentan con espera exponencial.
- Esos reintentos pueden continuar hasta 3 días, lo que te da más margen para recuperarte si tu endpoint está inestable o caído.
Diseña tu endpoint para reintentos
- Hazlo idempotente. Un mismo evento puede llegar más de una vez. Usa el encabezado
deliveryId, que es el mismo en todos los intentos de un evento, para descartar duplicados. - Calcula la carga extra. Cada evento puede generar hasta 6 llamadas adicionales si respondes 429.
- Vigila el tamaño. Los webhooks del Marketplace tienen un máximo de 256 KB. Si un evento es más grande, llega truncado con el indicador
payloadTooLarge. - Registra cada intento en tus propios logs para poder auditar las entregas.
Preguntas frecuentes
¿Chateea elimina los duplicados entre reintentos?
¿Chateea elimina los duplicados entre reintentos?
Cada intento de un mismo evento lleva el mismo encabezado
deliveryId, así que puedes identificar y descartar los duplicados de forma segura en tu servidor.¿Puedo cambiar el intervalo o el número de intentos?
¿Puedo cambiar el intervalo o el número de intentos?
No. El calendario es global para todas las apps.
¿Puedo desactivar los reintentos?
¿Puedo desactivar los reintentos?
No. Los reintentos vienen integrados y no se pueden desactivar por app. Diseña tu endpoint para que tolere eventos repetidos.
¿Cómo lo pruebo en un entorno de pruebas?
¿Cómo lo pruebo en un entorno de pruebas?
Haz que tu endpoint de pruebas devuelva un 429 y comprueba que recibes el mismo evento 6 veces a lo largo de unos 70 minutos.
¿Afecta al disparador Webhook entrante de los flujos de trabajo?
¿Afecta al disparador Webhook entrante de los flujos de trabajo?
No. Los reintentos solo aplican a los webhooks que Chateea envía desde las apps del Marketplace a tu servidor externo.
¿Dónde veo el historial de entregas?
¿Dónde veo el historial de entregas?
Por ahora, usa los logs de tu propio servidor para revisar cada intento.
Artículos relacionados
Integraciones privadas
Conecta tus sistemas con Chateea mediante tokens con permisos controlados.
SDK de Python y PHP para la API
Librerías oficiales que simplifican OAuth y los webhooks.
Crea una integración de pagos personalizada
Guía técnica para conectar una pasarela propia como app del Marketplace.
Crear acciones personalizadas del Marketplace
Agrega acciones propias de tu app a los flujos de trabajo.