SMS

Czym jest słowo kluczowe STOP i co musi się stać, gdy ktoś je wyśle?

Słowo kluczowe STOP to odpowiedź tekstowa z prośbą o zaprzestanie wysyłki wiadomości, którą musisz honorować, rejestrując i egzekwując rezygnację.

Odbiorca może poprosić o zaprzestanie wysyłki po otrzymaniu wiadomości z dowolnego Twojego numeru. Twoja aplikacja musi powiązać tę prośbę z wiadomościami, które zamierza wysłać.

Co robi Bird z rozpoznanym STOP?

Bird rejestruje rezygnację dla pary nadawca–odbiorca, a następnie wysyła skonfigurowane potwierdzenie.

Najpierw dopasowuje tekst przychodzący do obowiązujących reguł słów kluczowych. Rezygnacja musi zostać zapisana, zanim Bird ją potwierdzi, aby nieudany zapis nie wygenerował mylącego potwierdzenia.

Późniejsza wysyłka od tego nadawcy do tego odbiorcy zwraca E12077 SMSRecipientSuppressed. Bird odrzuca żądanie przed utworzeniem wiadomości wychodzącej lub próby doręczenia. Dla takiej odrzuconej wysyłki nie ma zdarzenia niepowodzenia doręczenia.

Domyślnie start kończy blokadę, a następnie potwierdza zmianę. help i info zwracają informacje o programie bez zmiany rezygnacji. Jeśli nie istnieje osobna reguła info, INFO może pełnić rolę słowa kluczowego pomocy.

Czy rezygnacja obejmuje każdy numer, którego używam?

Blokada słowa kluczowego obejmuje jednego nadawcę i jednego odbiorcę, a nie każdego nadawcę w Twoim obszarze roboczym.

Na przykład rezygnacja z Twojego numeru marketingowego nie blokuje automatycznie osobnego numeru powiadomień o doręczeniu. Twoja aplikacja musi uwzględnić zakres faktycznej prośby danej osoby przed użyciem innego nadawcy.

Aby zrezygnować ze wszystkich nadawców, użyj preferencji na poziomie obszaru roboczego. Ten wpis jest niezależny od blokady SMS. Nie emituje sms_suppression.created. Handler zdarzeń nasłuchujący tylko tego zdarzenia nie zarejestruje zmian preferencji.

Przewodnik po rezygnacji wyjaśnia preferencje na poziomie obszaru roboczego. Blokada słowa kluczowego odrzuca z E12077. Preferencja na poziomie obszaru roboczego może odrzucić z E25000 PreferenceRevoked.

Jak sprawdzić, czy Bird obsługuje dane słowo kluczowe?

Wylistuj reguły obowiązujące dla danego kraju lub numeru nadawczego, zanim polegasz na automatycznej obsłudze.

bird sms keyword-rules list --country NL

Pusty wynik dla kraju oznacza, że nie zwrócono żadnych reguł dla tego kraju. Dokumentacja poleceń opisuje dostępne filtry, w tym --from-country.

Przez API użyj GET /v1/sms/keyword-rules. Filtruj po number, aby sprawdzić reguły konkretnego numeru. Wyniki są posortowane od najbardziej szczegółowych, z obowiązującymi słowami kluczowymi w effective_keywords.

Wbudowany katalog Bird obejmuje tylko niektóre kraje. Bez obowiązującej reguły wiadomość trafia do Twojego handlera przychodzących jako zwykły tekst. Bird nie rejestruje w takim przypadku automatycznej rezygnacji ani potwierdzenia. Twój handler musi rozpoznać żądanie i zatrzymać kolejne wysyłki.

Dlaczego potwierdzenie rezygnacji nadal może zostać wysłane?

Bird wyłącza wbudowane odpowiedzi zgodności z blokady, którą muszą potwierdzić.

Bez tego wyjątku zarejestrowanie STOP zablokowałoby własne potwierdzenie. Wyjątek obejmuje odpowiedzi opt-out, opt-in, help i info. Pozostałe kontrole wysyłki nadal obowiązują.

Odpowiedź na słowo kluczowe custom nie ma takiego wyjątku. W przeciwnym razie niestandardowa odpowiedź mogłaby dostarczyć wybrany przez Ciebie tekst osobie, która zrezygnowała.

Operacja confirm oznacza odpowiedź double opt-in. Nie wysyła odpowiedzi. Twój handler musi na nią odpowiedzieć. Niestandardowa reguła bez tekstu odpowiedzi również nic nie wysyła.

Co powinna zrobić moja aplikacja po rezygnacji?

Zapobiegaj przyszłym wysyłkom sprzecznym z prośbą danej osoby. Zapisz zakres rezygnacji, aby stosować go poprawnie.

Traktuj E12077 jako zablokowaną wysyłkę do zbadania w stanie zgody, a nie przejściowy błąd doręczenia do ponowienia. Utrzymuj handlery dla starych numerów nadawczych aktywne, dopóki odbiorcy mogą jeszcze odpowiadać na ich wiadomości.

Honoruj rezygnacje otrzymane poza wbudowanym katalogiem lub przez inne obsługiwane metody kontaktu. Zasady komunikacji CTIA wymagają od nadawców obsługi i honorowania żądań rezygnacji.

W przypadku programów korzystających z kilku numerów sprawdzaj zarówno blokady dla konkretnego nadawcy, jak i preferencje na poziomie obszaru roboczego. Zapobiega to obejściu prośby danej osoby przez zmianę nadawcy.

W skrócie

  1. Wbudowana blokada obejmuje jednego nadawcę.

    Rozpoznane STOP blokuje parę nadawca–odbiorca. Inni nadawcy wymagają szerszej decyzji o rezygnacji w Twojej aplikacji.

  2. Sprawdź pokrycie słów kluczowych przed wysyłką.

    Bez obowiązującej reguły Bird dostarcza wiadomość przychodzącą bez automatycznego zarejestrowania rezygnacji.

  3. Zablokowane żądanie nie ma próby doręczenia.

    E12077 odrzuca wysyłkę na etapie przyjęcia, więc ponowienie jej nie przywraca zgody.

  4. Potwierdzenia mają wąski wyjątek.

    Wbudowane odpowiedzi zgodności mogą przejść kontrolę blokady. Niestandardowe odpowiedzi na słowa kluczowe nie otrzymują tego wyjątku.

Zastosuj w praktyce.

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy

Buduj na tej samej sieci.

Testowy klucz API otrzymasz od razu. Dostęp produkcyjny odblokujesz po dodaniu metody płatności i zweryfikowaniu nadawcy.

Twój kolejny pomysł.
Gotowy do połączenia.