WhatsApp-suppressies
Een suppressie is een adres waarnaar je werkruimte geen berichten stuurt, vastgelegd met een bereik. Bird blokkeert een verzending naar een onderdrukt adres voordat deze WhatsApp bereikt.
Open de Suppressions-pagina om met de lijst te werken, of gebruik de API hieronder. Records die door ontvangers zijn opgegeven staan op het tabblad Preferences van dezelfde pagina en volgen andere regels.

Een zakelijk account onderdrukken
Maak op het tabblad Suppressions een suppressie aan voor een telefoonnummer en kies het zakelijke account waarvoor deze geldt. Bird blokkeert berichten van dat account, en je andere accounts kunnen het nummer nog steeds berichten sturen. De kolom Business account in de lijst noemt het account waarvoor een suppressie geldt, of toont All accounts als de suppressie je hele werkruimte dekt.
POST /v1/whatsapp/suppressions legt hetzelfde vast vanuit code. waba is het account waarvoor je het wilt laten gelden; laat het weg om het adres te blokkeren voor je hele werkruimte, inclusief accounts die je later koppelt:
// 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"}'
Eén bereik, één record
Een suppressie heeft één bereik, dus hetzelfde adres geblokkeerd voor twee accounts levert twee records op in plaats van één. Om je hele werkruimte te dekken, doe je één aanroep zonder waba.
Een adres toevoegen dat al onderdrukt is voor dat bereik geeft 200 terug met het bestaande record, in plaats van een tweede aan te maken. Een nieuw record geeft 201 terug.
Een suppressie is gekoppeld aan het adres dat je vastlegt. Een ontvanger die je via een telefoonnummer bereikt en dezelfde ontvanger die je via een business-scoped user ID bereikt, zijn twee sleutels. Als je de ene onderdrukt, is de andere dus niet onderdrukt. Leg beide vast als je dezelfde persoon op beide manieren aanspreekt.
Je suppressielijst lezen
GET /v1/whatsapp/suppressions geeft de actieve suppressies terug als een cursorpagina, de nieuwste eerst. address matcht precies één volledig adres. De waarde die je meegeeft wordt op dezelfde manier genormaliseerd als het record, dus spaties en leestekens maken niet uit, maar een gedeeltelijk nummer levert niets op. reason beperkt de lijst tot een categorie, zoals manual voor de suppressies die je zelf hebt toegevoegd:
Wil je zien wat één zakelijk account blokkeert, geef dan de waba ervan mee. De pagina bevat de suppressies van dat account en de suppressies voor de hele werkruimte, die het account ook blokkeren. Als je zelf een volledige lijst filtert op waba, mis je de records voor de hele werkruimte.
// 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"De lijst bevat wat actief is; beëindigde records worden weggelaten. Een ontbrekend adres bewijst niet dat de werkruimte het nooit heeft onderdrukt; het record kan beëindigd zijn. Lees het op ID om het te bevestigen.
Eén record lezen
GET /v1/whatsapp/suppressions/{suppression_id} geeft zowel een beëindigd record als een actief record terug, met vermelding van wanneer het is beëindigd en waardoor:
// 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"Een suppressie beëindigen
De actie Delete op een rij in de lijst beëindigt de suppressie in plaats van deze te verwijderen. De blokkering stopt. Het record blijft leesbaar en toont wanneer het is beëindigd en door wie. DELETE /v1/whatsapp/suppressions/{suppression_id} doet hetzelfde en geeft 204 terug:
// 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"Een suppressie die je zelf hebt toegevoegd heeft reden manual en kan worden beëindigd. De eigen opt-out van een ontvanger kan alleen de ontvanger zelf terugdraaien, en de poging geeft 422 terug. Opnieuw aanroepen op een suppressie die al beëindigd is slaagt en verandert niets, en een ID dat niet in de werkruimte bestaat geeft 404 terug.
Om een suppressie te beëindigen heb je het ID ervan nodig, dus zoek het eerst op in de lijst.
Nieuwe suppressies volgen
whatsapp_suppression.created wordt geactiveerd wanneer een suppressie wordt vastgelegd, zodat je eigen systeem nieuwe blokkeringen ziet zonder te pollen. De payload bevat:
suppression_id, de identifier van het record.address, het onderdrukte nummer in E.164-formaat.waba, het account waartoe de blokkering beperkt is, of null wanneer het de hele werkruimte dekt.reasonenworkspace_id.
Er wordt geen event verstuurd wanneer een suppressie eindigt, dus lees de lijst opnieuw voordat je vertrouwt op een kopie die je bewaart. Zie Webhooks voor WhatsApp-suppressies voor de volledige payload.
Volgende stappen
- Preferences: de records die ontvangers opgeven, en welke je kunt terugdraaien.
- Webhooks voor berichtstatus: de
whatsapp.rejected-payload die een geblokkeerde verzending oplevert. - WhatsApp-berichten verzenden: de verzend-API en het asynchrone aflevermodel.
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.