Suppresje WhatsApp
Suppresja to adres, do którego Twój obszar roboczy nie będzie wysyłać wiadomości, zapisany z określonym zakresem. Bird blokuje wysyłkę na adres objęty suppresją, zanim dotrze ona do WhatsApp.
Otwórz stronę Suppressions, aby zarządzać listą, lub użyj API poniżej. Wpisy zgłoszone przez odbiorców znajdują się na karcie Preferences tej samej strony i podlegają innym zasadom.

Blokowanie konta biznesowego
Na karcie Suppressions utwórz suppresję dla numeru telefonu i wybierz konto biznesowe, którego dotyczy. Bird blokuje wiadomości z tego konta, a Twoje pozostałe konta nadal mogą wysyłać wiadomości na ten numer. Kolumna Business account na liście wskazuje konto, do którego suppresja jest przypisana, lub wyświetla All accounts, jeśli obejmuje cały obszar roboczy.
POST /v1/whatsapp/suppressions zapisuje to samo z poziomu kodu. waba to konto, do którego chcesz przypisać zakres; pomiń je, aby zablokować adres w całym obszarze roboczym, w tym na kontach, które podłączysz później:
// Omit waba to block the address for the whole workspace, whichever account
// sends. With it, your other accounts keep reaching them, and the same
// address for two accounts is two records.
const suppression = await bird.whatsapp.suppressions.add({
address: "+15550001234",
waba: "102290129340398",
});
console.log(suppression.id, suppression.applies_to);# Omit waba to block the address for the whole workspace, whichever account
# sends. With it, your other accounts keep reaching them, and the same
# address for two accounts is two records.
suppression = client.whatsapp.suppressions.add(
address="+15550001234",
waba="102290129340398",
)
print(suppression.id, suppression.applies_to)suppression, err := client.Whatsapp.Suppressions.Add(context.Background(), bird.WhatsappSuppressionsAddParams{
Address: "+15550001234",
// Omit Waba to block the address for the whole workspace, whichever account
// sends. With it, your other accounts keep reaching them, and the same
// address for two accounts is two records.
Waba: &waba,
})
if err != nil {
log.Fatal(err)
}
fmt.Println(suppression.Id, suppression.AppliesTo)// Omit setWaba to block the address for the whole workspace, whichever account
// sends. With it, your other accounts keep reaching them, and the same address
// for two accounts is two records.
$suppression = $bird->whatsapp->suppressions->add(
(new WhatsAppSuppressionCreate())
->setAddress('+15550001234')
->setWaba('102290129340398'),
);
echo $suppression->getId(), ' ', $suppression->getAppliesTo();bird whatsapp suppressions add --address +5511977670804curl -X POST https://us1.platform.bird.com/v1/whatsapp/suppressions \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"address":"+15550001234","waba":"102290129340398"}'
Jeden zakres, jeden wpis
Suppresja ma jeden zakres, więc ten sam adres zablokowany dla dwóch kont to dwa wpisy, a nie jeden. Aby objąć cały obszar roboczy, wykonaj jedno wywołanie bez waba.
Dodanie adresu, który jest już objęty suppresją w danym zakresie, zwraca 200 z istniejącym wpisem zamiast tworzyć drugi. Nowy wpis zwraca 201.
Suppresja jest identyfikowana po zapisanym adresie. Odbiorca wskazany numerem telefonu i ten sam odbiorca wskazany identyfikatorem użytkownika w zakresie konta biznesowego to dwa różne klucze, więc objęcie suppresją jednego nie obejmuje drugiego. Zapisz oba, jeśli kontaktujesz się z tą samą osobą na oba sposoby.
Odczytywanie listy suppresji
GET /v1/whatsapp/suppressions zwraca obowiązujące suppresje, od najnowszych, jako stronę kursorową. address dopasowuje dokładnie jeden pełny adres: przekazana wartość jest normalizowana tak samo jak wpis, więc spacje i interpunkcja nie mają znaczenia, ale częściowy numer nie zwraca niczego. reason zawęża wyniki do kategorii, na przykład manual dla wpisów dodanych przez Ciebie:
Aby sprawdzić, co blokuje jedno konto biznesowe, przekaż jego waba. Strona zawiera suppresje tego konta oraz suppresje obejmujące cały obszar roboczy, które również je blokują, więc samodzielne filtrowanie pełnej listy po waba pominęłoby wpisy obejmujące cały obszar roboczy.
// address matches one complete address exactly; a partial number returns nothing.
const suppressions = await bird.whatsapp.suppressions.list({ address: "+15550001234" });
for (const suppression of suppressions.data ?? []) {
console.log(suppression.address, suppression.waba ?? "every account");
}# address matches one complete address exactly; a partial number returns nothing.
suppressions = client.whatsapp.suppressions.list(address="+15550001234")
for suppression in suppressions.data or []:
print(suppression.address, suppression.waba or "every account")for suppression, err := range client.Whatsapp.Suppressions.List(context.Background(), bird.WhatsappSuppressionsListParams{
Address: "+15550001234", // one complete address, matched exactly; a partial number returns nothing
}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(suppression.Address, suppression.Reason)
}// address matches one complete address exactly; a partial number returns nothing.
foreach ($bird->whatsapp->suppressions->list(['address' => '+15550001234']) as $suppression) {
echo $suppression->getAddress(), ' ', $suppression->getWaba() ?? 'every account', PHP_EOL;
}bird whatsapp suppressions listcurl "https://us1.platform.bird.com/v1/whatsapp/suppressions?address=%2B15550001234" \
-H "Authorization: Bearer $BIRD_API_KEY"Lista zawiera obowiązujące wpisy, a zakończone wpisy są pomijane. Brak adresu nie dowodzi, że nigdy nie był objęty suppresją w obszarze roboczym; wpis mógł zostać zakończony. Aby to potwierdzić, odczytaj wpis po ID.
Odczytywanie pojedynczego wpisu
GET /v1/whatsapp/suppressions/{suppression_id} zwraca zarówno wpis zakończony, jak i obowiązujący, podając kiedy został zakończony i co go zakończyło:
// Resolves a record that has already ended, which the list leaves out.
const suppression = await bird.whatsapp.suppressions.get("was_01krdgeqcxet5s7t44vh8rt9mg");
console.log(suppression.reason, suppression.ended_at ?? "still in force");# Resolves a record that has already ended, which the list leaves out.
suppression = client.whatsapp.suppressions.get("was_01krdgeqcxet5s7t44vh8rt9mg")
print(suppression.reason, suppression.ended_at or "still in force")suppression, err := client.Whatsapp.Suppressions.Get(context.Background(), "was_01krdgeqcxet5s7t44vh8rt9mg")
if err != nil {
log.Fatal(err)
}
fmt.Println(suppression.Reason, suppression.EndedAt)// Resolves a record that has already ended, which the list leaves out.
$suppression = $bird->whatsapp->suppressions->get('was_01krdgeqcxet5s7t44vh8rt9mg');
echo $suppression->getReason(), ' ', $suppression->getEndedAt()?->format(DATE_ATOM) ?? 'still in force';bird whatsapp suppressions get <suppression-id>curl https://us1.platform.bird.com/v1/whatsapp/suppressions/was_01krdgeqcxet5s7t44vh8rt9mg \
-H "Authorization: Bearer $BIRD_API_KEY"Kończenie suppresji
Akcja Delete w wierszu suppresji kończy suppresję, zamiast ją usuwać. Blokada przestaje obowiązywać. Wpis nadal można odczytać i pokazuje, kiedy został zakończony i kto go zakończył. DELETE /v1/whatsapp/suppressions/{suppression_id} działa tak samo i zwraca 204:
// Only a manual suppression can be ended; a recipient's own opt-out is
// theirs to reverse. The record is kept and still reads back by id.
await bird.whatsapp.suppressions.remove("was_01krdgeqcxet5s7t44vh8rt9mg");# Only a manual suppression can be ended; a recipient's own opt-out is
# theirs to reverse. The record is kept and still reads back by id.
client.whatsapp.suppressions.remove("was_01krdgeqcxet5s7t44vh8rt9mg")if err := client.Whatsapp.Suppressions.Remove(context.Background(), "was_01krdgeqcxet5s7t44vh8rt9mg"); err != nil {
log.Fatal(err)
}// Only a manual suppression can be ended; a recipient's own opt-out is theirs
// to reverse. The record is kept and still reads back by id.
$bird->whatsapp->suppressions->remove('was_01krdgeqcxet5s7t44vh8rt9mg');bird whatsapp suppressions remove <suppression-id> --yescurl -X DELETE https://us1.platform.bird.com/v1/whatsapp/suppressions/was_01krdgeqcxet5s7t44vh8rt9mg \
-H "Authorization: Bearer $BIRD_API_KEY"Suppresja dodana przez Ciebie ma powód manual i możesz ją zakończyć. Rezygnację zgłoszoną przez odbiorcę może cofnąć tylko on, a próba jej zakończenia zwraca 422. Ponowne wywołanie dla suppresji, która została już zakończona, kończy się powodzeniem i niczego nie zmienia, a ID, którego nie ma w obszarze roboczym, zwraca 404.
Do zakończenia suppresji potrzebne jest jej ID, więc najpierw wyszukaj je na liście.
Obserwowanie nowych suppresji
whatsapp_suppression.created jest wywoływane, gdy suppresja zostanie zapisana, dzięki czemu Twój system widzi nowe blokady bez odpytywania. Jego ładunek zawiera:
suppression_id, identyfikator wpisu.address, numer objęty suppresją w formacie E.164.waba, konto, do którego blokada jest ograniczona, lub null, gdy obejmuje cały obszar roboczy.reasoniworkspace_id.
Po zakończeniu suppresji nie jest emitowane żadne zdarzenie, więc zanim zaufasz przechowywanej kopii, ponownie odczytaj listę. Pełny ładunek opisano w sekcji Webhooki suppresji WhatsApp.
Następne kroki
- Preferencje: wpisy zgłoszone przez odbiorców i informacja, które z nich możesz cofnąć.
- Webhooki statusu wiadomości: ładunek
whatsapp.rejected, który generuje zablokowana wysyłka. - Wysyłanie wiadomości WhatsApp: API wysyłki i jej asynchroniczny model dostarczania.
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.