Um destinatário pode pedir para parar após receber uma mensagem de qualquer um dos seus números. Sua aplicação precisa conectar essa solicitação às mensagens que enviará em seguida.
O que o Bird faz com um STOP reconhecido?
O Bird registra um opt-out para o par remetente-assinante. Em seguida, envia a confirmação configurada.
Primeiro, ele compara o texto recebido com as regras de palavras-chave aplicáveis. O opt-out deve ser registrado antes que o Bird o confirme, para que uma falha na gravação não produza uma confirmação enganosa.
Um envio posterior daquele remetente para aquele assinante retorna E12077 SMSRecipientSuppressed. Bird recusa a solicitação antes de criar uma mensagem de saída ou tentativa de entrega. Não há evento de falha de entrega para esse envio recusado.
Por padrão, start encerra a supressão. Em seguida, confirma a mudança. help e info retornam informações do programa sem alterar o opt-out. Quando não existe uma regra info separada, INFO pode ser uma palavra-chave de ajuda.
O opt-out cobre todos os números que eu uso?
A supressão por palavra-chave cobre um remetente e um assinante, não todos os remetentes no seu espaço de trabalho.
Por exemplo, um opt-out do seu número de marketing não suprime automaticamente um número separado de notificação de entrega. Sua aplicação deve aplicar o escopo da solicitação real da pessoa antes de usar outro remetente.
Para um opt-out de todos os remetentes, use uma preferência no nível do espaço de trabalho. Esse registro é separado de uma supressão do SMS. Ele não emite sms_suppression.created. Um handler de eventos que monitora apenas esse evento não detectará mudanças de preferência.
O guia de opt-out explica preferências no nível do espaço de trabalho. Uma supressão por palavra-chave rejeita com E12077. Uma preferência no nível do espaço de trabalho pode rejeitar com E25000 PreferenceRevoked.
Como verifico se o Bird trata a palavra-chave?
Você lista as regras que se aplicam ao país ou número de envio antes de depender do tratamento automático.
bird sms keyword-rules list --country NLUm resultado de país vazio significa que nenhuma regra foi retornada para aquele país. A referência de comandos documenta seus filtros, incluindo --from-country.
Pela API, use GET /v1/sms/keyword-rules. Filtre por number para inspecionar as regras de um número específico. Os resultados chegam do mais específico para o menos específico, com as palavras-chave aplicáveis em effective_keywords.
O catálogo integrado do Bird cobre apenas alguns países. Sem uma regra aplicável, a mensagem chega ao seu handler de entrada como texto comum. O Bird não registra opt-out automático nem confirmação nesse caso. Seu handler deve reconhecer a solicitação e interromper envios subsequentes.
Por que uma confirmação de opt-out ainda pode ser enviada?
O Bird isenta respostas de conformidade integradas da supressão que elas precisam confirmar.
Sem essa isenção, registrar um STOP bloquearia sua própria confirmação. A isenção cobre respostas de opt-out, opt-in, ajuda e informações. Outras verificações de envio continuam valendo.
Uma resposta de palavra-chave custom não tem essa isenção. Caso contrário, uma resposta personalizada poderia entregar o texto escolhido por você a alguém que fez opt-out.
A operação confirm marca uma resposta de double opt-in. Ela não envia resposta. Seu handler deve respondê-la. Uma regra personalizada sem texto de resposta também não envia nada.
O que minha aplicação deve fazer após um opt-out?
Evite envios futuros que conflitem com a solicitação da pessoa. Registre o escopo do opt-out para aplicá-lo corretamente.
Trate E12077 como um envio bloqueado a investigar no seu estado de consentimento, não como uma falha de entrega temporária para tentar novamente. Mantenha os handlers de números de remetente antigos ativos enquanto destinatários ainda puderem responder às mensagens deles.
Honre opt-outs recebidos fora do catálogo integrado ou por outros métodos de contato suportados. Os princípios de mensageria da CTIA esperam que remetentes suportem e honrem solicitações de opt-out.
Para programas que usam vários números, verifique tanto as supressões específicas do remetente quanto as preferências no nível do espaço de trabalho. Isso evita que uma troca de remetente contorne a solicitação da pessoa.
Em resumo
A supressão integrada cobre um remetente.
Um STOP reconhecido bloqueia aquele par remetente-assinante. Outros remetentes precisam de uma decisão de opt-out mais ampla na sua aplicação.
Verifique a cobertura de palavras-chave antes de enviar.
Sem uma regra aplicável, o Bird entrega o texto recebido sem registrar automaticamente o opt-out.
Uma solicitação bloqueada não gera tentativa de entrega.
E12077 rejeita o envio na admissão, então tentar novamente não restaura a permissão.
Confirmações têm uma isenção restrita.
Respostas de conformidade integradas podem passar pela verificação de supressão. Respostas de palavras-chave personalizadas não recebem essa isenção.