Dezaktywacja kampanii wiadomości

Dezaktywuj istniejącą kampanię wiadomości

Użyj tej ścieżki, gdy wycofujesz z użytku kampanię należącą do konta. Zachowaj identyfikator kampanii do uzgodnień i celów historycznych. Aby poprawić treść lub zaktualizować tekst zgody, skorzystaj z funkcji Aktualizacja kampanii wiadomości zamiast tej operacji.

Uwierzytelnij się przy użyciu aktywnego konta API przez HTTPS z dozwolonego źródłowego adresu IP. Najpierw pobierz dane kampanii i sprawdź powiązaną markę oraz numery nadawcze. Dezaktywacja zmienia rejestrację; nie tworzy kampanii zastępczej ani nie przenosi numerów do innej kampanii.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/campaign/$CAMPAIGN_ID"

Najpierw usuń odpowiednie przypisania numerów

Publiczna operacja DELETE dla kampanii nie odłącza numerów telefonicznych od operatora obsługującego wiadomości ani nie usuwa ich lokalnego przypisania. Zastosuj procedurę usuwania przypisania numeru do kampanii dla każdego objętego zmianą numeru należącego do konta, a następnie sprawdź jego przypisanie. Usunięcie przypisania nie zwalnia numeru telefonicznego.

Szersza procedura „Usuń markę” w portalu porządkuje kampanie i numery marki przed jej usunięciem. Nie używaj tej akcji, jeśli zamierzasz zachować markę i jej pozostałe kampanie. Obecny standardowy edytor kampanii nie udostępnia osobnego przycisku usuwania kampanii odpowiadającego tej bezpośredniej ścieżce API.

Wyślij żądanie zamierzonej dezaktywacji

Po sprawdzeniu identyfikatora kampanii i konfiguracji wysyłania objętej zmianą wyślij DELETE bez treści 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/campaign/$CAMPAIGN_ID"

Udokumentowana odpowiedź oznaczająca powodzenie to HTTP 204 z pustą treścią. Sprawdź status HTTP, zamiast oczekiwać struktury JSON z status/response. Po zaakceptowaniu usunięcia bieżąca usługa oznacza zasób kampanii lokalnie jako usunięty i wygasły, a jej rekord w starszym systemie jako wygasły. Usunięcie nie obejmuje kaskadowo marki.

Użyj jednego klucza idempotencji dla tego zamierzonego żądania i zachowaj dokładną metodę, ścieżkę, parametry zapytania oraz bajty treści na potrzeby ponowienia. Duplikat żądania, którego przetwarzanie trwa, może zwrócić 409 z Retry-After; dla zakończonych żądań można ponownie zwrócić zapisany wynik. Błąd zapisany w pamięci podręcznej lub przerwane połączenie nie pozwalają stwierdzić, czy rejestr wykonał już operację. Zachowaj identyfikator kampanii oraz requestId, jeśli jest dostępny.

Sprawdź zarówno rejestrację, jak i przypisania

Po wysłaniu żądania sprawdź w portalu bieżący stan kampanii i numery objęte zmianą. API może zachować lokalne metadane przynależności do konta po wycofaniu kampanii, dzięki czemu nadal można sprawdzić identyfikator należący do konta; nie zakładaj, że ten sam identyfikator musi zawsze zwracać lokalnie 404. To rejestr decyduje o zwracanym statusie lub dostępności wycofanego rekordu.

Jeśli numer pozostaje przypisany, uzgodnij to istniejące przypisanie. Nie twórz kolejnej kampanii tylko po to, aby ponowić dezaktywację, ani nie zakładaj, że HTTP 204 dowodzi usunięcia powiązań po stronie operatora. Jeśli synchronizacja lokalna nie powiedzie się po zaakceptowaniu żądania przez rejestr, API może zwrócić 500, mimo że zewnętrzna dezaktywacja już nastąpiła.

Wycofanie z użytku jest niezależne od rozliczenia konta

Bieżąca usługa DELETE nie zleca natychmiastowego obciążenia opłatą za rejestrację kampanii. Nie oznacza to obietnicy zwrotu środków, anulowania istniejącego zobowiązania ani zwolnienia wynajmowanych numerów. Sprawdź w portalu warunki dotyczące kampanii na koncie oraz nieopłacone faktury. Wynajem numerów i korzystanie z wiadomości są rozliczane niezależnie od rejestracji kampanii.

Jeśli po uzgodnieniu kampanii i przypisań wycofywana jest cała rejestracja firmy, przejdź do procedury wycofania marki z użytku.