Elija el procedimiento de baja
Dé de baja una marca de mensajería cuando la empresa ya no necesite ese registro. Esto deja de utilizar el registro existente; no registra uno nuevo que lo sustituya, no libera los números de teléfono alquilados ni corrige los datos de identidad de la empresa. Para realizar una corrección, utilice Actualizar una marca de mensajería.
La llamada pública DELETE para marcas y la acción Eliminar marca del portal tienen alcances diferentes. La llamada pública elimina una marca del registro. El portal coordina la desvinculación de números y la desactivación de campañas antes de intentar eliminar la marca.
| Procedimiento | Qué hace |
|---|---|
| Portal: Eliminar marca | Muestra las campañas asociadas y los números asignados, exige el identificador de la marca como confirmación y luego intenta realizar la limpieza correspondiente antes de eliminar la marca. Los pasos anteriores pueden quedar completados aunque falle uno posterior. |
| API: DELETE /tcr/v2/brand/{brandId} | Solicita únicamente la eliminación de esta marca perteneciente a la cuenta. No desvincula automáticamente los números ni desactiva las campañas de la marca. Una campaña activa puede impedir la eliminación. |
Revise el impacto en el portal
Abra la página de registro de mensajería, busque la marca correcta y seleccione Eliminar marca. Revise las cantidades de campañas asociadas y de números asignados. Escriba el identificador exacto de la marca para habilitar la acción final. El formulario para clientes solo está disponible cuando la cuenta tiene permiso para gestionar registros.
El portal procesa las campañas activas de forma secuencial: intenta desvincular cada número asignado actualmente, desactiva la campaña y, después, elimina la marca. Omite una nueva eliminación remota de las campañas que ya están marcadas como caducadas o eliminadas. Una vez que esos pasos externos se completan correctamente, actualiza los registros locales de campañas y números en una transacción de base de datos.
Esta secuencia no constituye una única transacción atómica que abarque el registro, el operador y los registros locales. Un fallo posterior no puede restaurar un número o una campaña que ya se haya modificado externamente. Conserve los detalles devueltos de los números desvinculados y de las campañas desactivadas cuando estén disponibles; concilie esos identificadores en lugar de crear otra marca.
Prepare una eliminación directa mediante la API
Utilice una cuenta de API habilitada a través de HTTPS desde una dirección IP de origen permitida. La marca debe pertenecer a esa cuenta. Consulte y conserve su identificador y su estado actual; después, compruebe sus campañas y las asignaciones de números. Desvincule los números afectados y proceda a desactivar las campañas antes de eliminar la marca. No trate esta llamada DELETE como una operación en cascada.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Elimine la marca revisada
Ejecute lo siguiente únicamente para la baja prevista, después de comprobar el identificador de la marca y completar la limpieza anterior. La solicitud no lleva cuerpo JSON.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request DELETE \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"El resultado satisfactorio documentado es HTTP 204, sin cuerpo de respuesta. No exija un objeto JSON de éxito ni el antiguo envoltorio status/response de v3. Un resultado rechazado que no sea 2xx no marca la marca como eliminada mediante el mecanismo actual de sincronización de la API.
Utilice una sola clave de idempotencia para la solicitud prevista. Al repetirla, mantenga sin cambios los bytes del método, la ruta, la consulta y el cuerpo. La clave no convierte toda la limpieza del portal en una operación atómica ni demuestra que se haya desvinculado un número en el operador. Una solicitud duplicada mientras la original sigue en curso puede devolver 409 con Retry-After; las solicitudes completadas pueden volver a devolver su respuesta guardada, incluido un error.
Verifique la baja y concilie los resultados parciales
Compruebe las listas de marcas y campañas del portal y los números afectados después de la operación. La sincronización tras una operación satisfactoria de la API pública marca esa marca individual como eliminada localmente; no elimina los demás recursos de campañas ni borra las asignaciones de números comprados. El estado en el registro, la asignación en el operador y la información mostrada localmente requieren comprobaciones independientes.
El adaptador actual del portal para el operador acepta una respuesta HTTP de éxito sin validar por separado cada valor de estado de negocio en su cuerpo. Por este motivo, verifique las asignaciones reales de los números afectados a las campañas después de una limpieza del portal, incluso si el portal indicó que se completó correctamente. Si una asignación o un estado presenta inconsistencias, conserve los identificadores afectados y contacte con el servicio de asistencia antes de enviar mensajes mediante la configuración dada de baja o de volver a crearla.
Para HTTP 400, lea el error detallado del registro, especialmente si se trata de una restricción por una campaña activa. Para 401, 403 o 404, compruebe las credenciales, la IP de origen permitida y la pertenencia de la marca a la cuenta. Para 429, respete Retry-After. Un tiempo de espera agotado, un 500 o un 502 pueden producirse después de que un cambio externo se haya completado; examine el registro existente antes de repetir la solicitud.
Compruebe los cargos restantes de la cuenta
El servicio DELETE actual no genera un débito inmediato por el registro de la marca. Eliminar una marca no libera los números de teléfono alquilados, no emite un reembolso ni determina el saldo final de la cuenta. Revise en el portal los compromisos vigentes de las campañas y los cargos por alquiler de números y por uso. Esta operación no constituye un presupuesto para esos servicios independientes.