Sign inGet Started
Começar
Guias
Referência de API
SDKs
CLI
Base de conhecimento
Changelog

Categorias

Todo e-mail que você envia tem uma categoria indicando por que está sendo enviado, definida com o campo category em POST /v1/email/messages. Ele aceita um de dois valores, marketing ou transactional, e tem um único efeito: decide quais registros de supressão e preferências de cancelamento de inscrição podem bloquear a mensagem.
Um cancelamento de inscrição em newsletter diz algo sobre e-mails de marketing e nada sobre redefinições de senha. A categoria é como diferenciamos essas duas intenções.

As duas categorias

  • marketing: e-mails que o destinatário escolheu receber e pode escolher parar de receber. Campanhas, newsletters, anúncios de produto, ofertas promocionais. Qualquer coisa em que "I don't want this anymore" seja uma resposta que você precisa respeitar.
  • transactional: e-mails que a própria ação do destinatário exige. Redefinições de senha, verificação de e-mail, códigos de uso único, recibos de pedido, alertas de segurança e de conta. Esses precisam chegar independentemente das preferências de marketing do destinatário.
Pergunte o que acontece se a mensagem nunca chegar. Se um fluxo que o destinatário iniciou quebra, é transacional. Se você iniciou a conversa, é marketing.
Essas duas são o conjunto completo: nenhuma API cria ou configura uma categoria, e o campo é validado contra esses valores. Para segmentação mais granular, use tags junto com a categoria.

Como a categoria determina a política de supressão

O contrato se resume a uma linha: marketing é bloqueado por qualquer motivo de supressão e por qualquer opt-out, enquanto transactional passa por uma supressão de reclamação ou por um opt-out apenas de marketing. Hard bounces, supressões manuais e um opt-out registrado para todas as mensagens bloqueiam ambas.
A assimetria decorre do que cada motivo significa. Um hard bounce significa que o endereço não existe, então enviar é inútil qualquer que seja a categoria. Uma supressão manual é uma decisão da sua própria equipe, que nunca questionamos. Reclamações e cancelamentos de inscrição são preferências sobre e-mails indesejados: eles bloqueiam seus envios marketing, enquanto um destinatário que denunciou sua newsletter como spam ainda recebe a redefinição de senha. A exceção também é intencional: um opt-out pode ser registrado para todas as mensagens em vez de apenas marketing (a opção Mensagens a interromper na caixa de diálogo Registrar preferência, ou coverage: all em POST /v1/preferences), e isso é o destinatário pedindo silêncio, então bloqueia e-mails transacionais também.
Destinatários bloqueados são rejeitados onde você pode vê-los, uma linha por destinatário com o motivo anexado. Supressões tem a tabela motivo a motivo e explica como os endereços chegam à lista.

O padrão, e por que envios transacionais precisam optar por não usá-lo

Omita category e o envio será marketing. Isso falha na direção segura: e-mails enviados sem uma categoria explícita respeitam cancelamentos de inscrição e reclamações e incluem um link de cancelamento de inscrição, então uma campanha fica em conformidade sem trabalho extra.
Dois caminhos de envio obtêm a categoria de outro lugar. Um envio que usa um template armazenado e omite category usa a classificação do próprio template, então um template criado como transactional envia como transacional. Defina category no envio para classificar uma mensagem de forma diferente, e o valor do envio prevalece. E-mails enviados via SMTP obtêm a categoria da configuração SMTP da chave API, que é transactional para uma chave que você não configurou.
Portanto, e-mails operacionais precisam sair do padrão. Uma redefinição de senha enviada sem categoria é tratada como marketing: ela inclui um link de cancelamento de inscrição que não deveria ter, e um cancelamento de inscrição de newsletter a bloqueia mesmo que o destinatário tenha solicitado. Defina category: "transactional" em recibos, redefinições, códigos de verificação e alertas de conta:
Exemplo de código
{
  "from": "no-reply@yourdomain.com",
  "to": ["delivered@messagebird.dev"],
  "subject": "Reset your password",
  "html": "<p>Click the link below to reset your password...</p>",
  "category": "transactional"
}

Categorias como dimensão de analytics

A categoria permanece na mensagem e aparece onde quer que a mensagem apareça, então ela divide seus números de entrega, bounce e engajamento em tráfego de marketing e operacional sem que você precise taguear cada envio. A lista de mensagens filtra por categoria, o stats API divide métricas por ela, e o log de e-mail do dashboard oferece o mesmo filtro.

Próximos passos

Recursos relacionados

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

Assista ao guiaGetting started with emailExplore a funcionalidadeEmailSiga o percurso de aprendizagemBuild your first integrationGuia de implementaçãoSend your first email
Experimente na prática e obtenha um resumo de implementação