SMS

Como coletar opt-ins de SMS?

Colete opt-ins de SMS explicando o que você vai enviar, pedindo que a pessoa concorde e retendo a evidência dessa concordância.

Um número de telefone informado no checkout pode ter sido fornecido para atualizações de entrega. Adicionar esse número a uma campanha promocional exige permissão que cubra essas mensagens.

Que permissão o meu programa precisa?

Mensagens promocionais precisam de permissão para promoções. Uma solicitação de atualizações de serviço cobre essa finalidade informativa.

Os princípios de mensageria da CTIA definem as expectativas do setor para mensagens de texto comerciais nos EUA. O Anexo II exige permissão por escrito para promoções. Mensagens informativas precisam de permissão expressa. Uma resposta relevante a uma conversa iniciada pelo cliente não requer permissão adicional segundo essa orientação.

Incluir uma oferta pode transformar um lembrete em uma promoção. A CTIA dá este exemplo:

Adding a call-to-action (e.g., a coupon code to an informational text) may place the message in the promotional category.

Defina o conteúdo antes de coletar a permissão, para que o convite cubra as mensagens que você realmente envia. Aplique os requisitos legais do destino junto com as orientações do setor. Consentimento expresso por escrito explica a definição legal nos EUA.

O que o convite deve informar à pessoa?

Mostre quem vai enviar, o que vai enviar e como a pessoa pode parar de receber.

A seção 5.1.1 da CTIA pede o programa, a identidade e o número do remetente, taxas, instruções de opt-out, detalhes de suporte e termos aplicáveis. Mantenha essas divulgações visíveis ao lado da ação que registra a concordância. Um anúncio por palavra-chave também precisa de divulgações.

Para mensagens recorrentes, explique a frequência. Envie uma confirmação de inscrição com detalhes de opt-out e suporte. A seção 5.1.2.1 descreve essa confirmação.

Deixe a pessoa realizar a ação de concordância por conta própria. Não pré-selecione a concordância nem a esconda dentro de termos não relacionados, pois nenhuma das duas opções estabelece uma escolha informada sobre suas mensagens.

Que evidências devo reter?

Guarde o horário do consentimento, a identidade e o número da pessoa, e o convite com o qual ela concordou.

A seção 5.1.2 da CTIA também menciona o método de coleta, a campanha e o endereço IP quando aplicável. Salve o texto e a ação usada para concordar. Um timestamp sozinho não consegue demonstrar se a pessoa concordou com lembretes ou promoções.

Se o seu programa exige double opt-in, peça que a pessoa confirme pelo telefone antes de tratar a inscrição como concluída. Modelos de consentimento de SMS explica essa etapa adicional.

Como registro o consentimento em Bird?

Você registra a decisão por meio de POST /v1/preferences. Retenha as evidências de suporte no seu próprio sistema.

Defina channel como sms e handle como o número de telefone com o código do país, por exemplo +15550001234. Defina status como granted ou revoked.

  • consented_at registra quando a pessoa concordou. Uma concessão sobre um opt-out armazenado precisa de um timestamp posterior. Não pode estar no futuro.
  • source identifica o formulário, a campanha ou o lote de importação. Aceita de 1 a 255 caracteres, então use uma referência curta à sua evidência.
  • coverage aceita non_transactional ou all. O padrão, non_transactional, deixa recibos e códigos de verificação fora do escopo dessa preferência.
  • sender_scope limita a declaração a um remetente. Omita-o para cobertura em todo o canal dentro do espaço de trabalho.

Bird compara declarações para o mesmo canal, handle, escopo de remetente e tópico. Um tópico agrupa mensagens sob uma assinatura. O campo topic_id da resposta identifica esse grupo. Um valor null significa todos os tópicos.

Uma declaração mais antiga retorna applied: false, com a declaração sobrevivente em preference. Verifique esse resultado para que uma importação antiga não pareça ter restaurado a permissão.

O opt-out feito pela própria pessoa tem proteção mais forte do que uma asserção API. Você não pode sobrepô-lo nem excluí-lo por meio desta API, mesmo com um timestamp posterior. O endpoint de preferência documenta o comportamento de escrita.

Uma resposta START cria o registro inicial de consentimento?

Uma resposta START encerra a supressão do remetente. Ela não substitui a sua coleta inicial de consentimento.

A operação start de Bird encerra essa supressão. Em seguida, envia a confirmação configurada. Um START de alguém que nunca foi suprimido pode receber uma confirmação sem estabelecer com o que a pessoa originalmente concordou.

A operação confirm reconhece respostas de double opt-in. Ela não envia resposta. O seu handler deve completar esse fluxo. Palavras-chave STOP explica o comportamento separado de palavras-chave e supressão.

O que devo verificar antes de enviar?

Envie somente quando o convite, a evidência de consentimento e o fluxo implementado estiverem de acordo.

  1. Vincule a permissão ao conteúdo real da mensagem.
  2. Aplique o modelo de consentimento do destino.
  3. Retenha o convite e o horário do consentimento, e verifique o resultado da escrita de preferência de Bird.
  4. Complete a troca de confirmação se o seu programa exigir double opt-in.

Em resumo

  1. Vincule a permissão ao conteúdo.

    Permissão para lembretes não cobre automaticamente mensagens promocionais.

  2. Mantenha o convite junto com o registro de consentimento.

    Registre o que a pessoa viu e quando concordou, para que você possa comprovar o que a permissão dela cobre.

  3. O horário do consentimento determina qual declaração se aplica.

    Uma declaração de preferência mais antiga não pode substituir uma mais recente. Um timestamp posterior sozinho não pode sobrepor o opt-out feito pela própria pessoa.

  4. START encerra uma supressão.

    O tratamento de palavras-chave de Bird não substitui a sua coleta inicial de consentimento nem o seu handler de confirmação de double opt-in.

Coloque em prática.

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Obtenha um resumo de implementação

Construa na mesma rede.

Uma chave de API de teste é sua imediatamente. A produção é desbloqueada quando adicionar um método de pagamento e verificar um remetente.

Comece com um canal.
Adicione os outros quando estiver pronto.

Uma chave API de teste é sua imediatamente. A produção é desbloqueada quando você adiciona um método de pagamento e verifica um remetente.

Usa Claude Code, Cursor ou Codex? Copie um prompt de configuração e o seu agente instala o Bird CLI e as skills por si. Escolha o seu:

Cursor