Reúne los cuatro datos de contexto antes de tocar la operación
Cuando un envío de WhatsApp, una sincronización de Google Calendar, un cobro de Yappy Comercial V2 o una creación de hoja en Google Sheets no termina en el primer intento, evita pulsar botones repetidamente. Anota primero el negocio activo, la referencia de la operación (por ejemplo, ORD-..., BKG-... o el ID de entrega), la hora en la zona del negocio y el estado exacto que muestra el panel.
Si necesitas escalar el caso a soporte técnico, comparte únicamente esas referencias y el mensaje de error visible: nunca envíes en un chat ni en un correo las claves de API, el secreto de cifrado ni capturas con datos privados de clientes.
Cómo distinguir y actuar ante pending, failed y uncertain
En EMP la cola durable (outbox) y los conectores externos separan los trabajos que aún no han salido de aquellos que fueron rechazados o cuyo resultado quedó indeterminado tras un corte de red.
| Estado registrado | Qué significa técnicamente | ¿Hubo efecto en el proveedor externo? | Siguiente paso seguro para tu equipo |
|---|---|---|---|
| pending (Pendiente) | El trabajo está guardado en base de datos esperando turno, configuración o ventana válida. | Todavía no se despachó al proveedor. | Verificar que el worker esté activo (ops:status / healthcheck) y que las credenciales del canal estén configuradas. |
| failed (Fallido) | El proveedor rechazó explícitamente la petición o se agotaron los reintentos acotados. | No se aplicó el cambio externo. | Leer el motivo registrado (por ejemplo, plantilla pausada, token vencido o validación fallida), corregir la causa y volver a programar. |
| uncertain (Incierto) | El worker o servidor envió la petición externa, pero la conexión se interrumpió antes de recibir respuesta. | Pudo haberse ejecutado en el proveedor; el sistema bloquea reintentos automáticos. | Comprobar primero en el destino (portal Yappy, Google Drive, Meta o receptor webhook) si el efecto ocurrió antes de decidir. |
Revisión humana y expedientes administrativos sin alterar dinero
Mientras investigas una operación con estado incierto, toma el control humano de la conversación para informar al cliente con precisión. Recuerda que marcar un caso como verificado en Revisión humana o cerrar un expediente administrativo en Gobierno deja constancia auditable de tu comprobación con la versión vigente (revision), pero nunca fuerza un estado paid ni ejecuta cargos o devoluciones.
Antes de continuar
- Anota negocio, referencia, hora y estado exacto antes de reintentar cualquier operación.
- Nunca repitas a ciegas un cobro o mensaje en estado uncertain sin verificar primero el proveedor.
- Comprueba que tanto la API como el worker estén en línea cuando los trabajos permanezcan en pending.
La demo conserva datos en memoria. Las conexiones de proveedores requieren configuración, autorización y verificación en tu entorno persistente.