Interpreta el resultado de la operación que llamaste
El estado HTTP y el cuerpo de respuesta describen la operación solicitada. No todos significan que una persona recibió un mensaje.
La referencia de cada operación sigue siendo la autoridad: mensajes, liberación, transferencia y Custom Connections.
Un ID de correlación no es una URL de estado. El contrato publicado no define un endpoint de consulta periódica para
trackingId ni requestId. Consérvalo para correlación y soporte; no construyas un endpoint nuevo a partir de él.Interpreta el formato de error publicado por el endpoint
Las integraciones REST y Custom Connections tienen contratos de error separados.Integraciones REST
Muchas respuestas usanProblem: title y status son obligatorios; code, detail, errors, traceId, instance y extra son opcionales. Cuando haya un code, úsalo para elegir un manejador de error documentado en lugar de comparar el title legible para personas. Conserva traceId para soporte cuando se incluya.
Algunas respuestas de validación publicadas declaran HTTPValidationError, cuyo detail es un array de elementos con loc, msg y type. El manejador compartido de errores de la API revisado para esta documentación devuelve esos detalles en Problem.errors[]. Las definiciones de respuesta publicadas se conservan; aún está pendiente confirmar el comportamiento contra la API desplegada. Consulta la nota de compatibilidad de validación.
Acepta errores JSON con application/json o application/problem+json. Revisa code cuando aparezca y después un array errors o detail para los errores de campos. Un detail de tipo cadena es una explicación, no un array. El estado 422 por sí solo no identifica un formato universal de cuerpo. Prevé un caso alternativo para errores sin code y usa la referencia del endpoint junto con los códigos de error para decidir qué hacer.
Custom Connections
Su cuerpo de error exigetype, title y status, y puede incluir detail. Aquí type es el identificador de error para el código que procesa la respuesta. No es el campo REST code. La referencia de errores de Custom Connections detalla estas respuestas.
Las respuestas de error no incluyen el requestId del envío; solo aparece en una respuesta 202 exitosa. Para pedir soporte por un error, conserva la URL de la página y la hora aproximada, como indica esa referencia.
Decide si reintentar según la operación y la causa
Consulta Límites de solicitudes para controlar el ritmo y Errores de Custom Connections para sus reglas de reintento específicas.
Algunos fallos pueden ocurrir después de una escritura
La referencia de conversaciones salientes de agentes documenta que untemplate.media.mediaId desconocido puede producir BRIDGE_AI_LEADSCOUT_0016 después de crear o recuperar la conversación. Por eso un reintento puede producir un resultado distinto.
Un estado de error no garantiza de forma universal que se hayan revertido todos los efectos. Sigue las instrucciones de efectos y recuperación de la operación específica. Si no están claras o se contradicen, identifica la incertidumbre y contacta a soporte de Bridge antes de repetir una acción con efectos externos.