Elige webhooks cuando el proveedor pueda avisarte de los cambios relevantes y el negocio necesite actualizaciones rápidas. El polling permite consultar cambios periódicamente cuando no hay eventos adecuados o basta un procesamiento programado. También puedes combinar notificaciones con conciliaciones periódicas.
Cómo funciona cada opción
Un webhook envía un aviso a tu receptor después de un evento. El polling consulta una API en intervalos definidos. Ambos requieren validar información, proteger el acceso y resolver fallos.
Una cancelación puede necesitar llegar pronto para detener la preparación de un pedido. Un informe diario quizá admita una actualización programada. Acuerda primero el retraso tolerable y después elige un mecanismo que el proveedor soporte.
Cuándo encajan los webhooks
Resultan útiles si existen los eventos necesarios y puedes operar el receptor de forma fiable. Confirma cobertura, autenticación, reintentos, significado de los mensajes y consulta del registro actualizado. La notificación no siempre contiene todos los campos que necesita el proceso.
No presupongas una entrega única y ordenada. La documentación de Stripe, por ejemplo, explica entregas duplicadas y no garantiza el orden de los eventos. Revisa las garantías específicas de tu proveedor.
Cuándo encaja el polling
Puede servir para API que permiten consultar modificaciones, procesos por lotes o servicios sin un webhook adecuado. El intervalo debe respetar tanto la demora aceptable como los límites de solicitudes. Consultar más frecuentemente genera llamadas incluso cuando no hay cambios.
Utiliza el cursor, la paginación o el marcador de cambios que admita la API. Avanza el punto de control después de procesar correctamente los resultados. Considera que pueden producirse actualizaciones mientras lees varias páginas: filtrar por fecha no constituye por sí solo una estrategia completa.
Por qué combinar notificaciones y conciliación
Las notificaciones pueden iniciar el trabajo con rapidez, mientras una comparación programada detecta registros ausentes o inconsistentes. Compara identificadores y estados del negocio, no solo la cantidad de mensajes recibidos. Si una notificación puede estar desactualizada, consulta el estado vigente siguiendo el modelo del proveedor.
La combinación también añade tareas operativas. Evalúala según el impacto de perder un cambio. Asigna responsables a las excepciones y evita que repetir una operación genere un registro duplicado.
Cinco preguntas antes de implementar
- ¿Qué cambios concretos deben llegar al destino?
- ¿Qué retraso admite cada proceso?
- ¿Qué garantiza el proveedor sobre entrega e historial?
- ¿Cómo detectarás interrupciones, duplicados y ausencias?
- ¿Quién conciliará las excepciones y comprobará la recuperación?
Documenta las respuestas con la lista de requisitos de integración API. Consulta nuestro servicio de integración API y comparte los sistemas implicados en contacto.