Skip to main content
Um conjunto de configuração aplica opções de entrega às mensagens que o selecionam. Ele não altera a identidade verificada necessária para enviar.

Criar e aplicar um conjunto de configuração

Abra Email e Configuration sets e clique em Create configuration set. Abra o conjunto para alterar envio, rastreamento, pool de IPs e exceções de supressão.
sending_enabled é true por padrão. Desabilitá-lo rejeita novos envios pelo conjunto. A configuração é aplicada quando uma mensagem é aceita; editar um conjunto não reescreve mensagens já enfileiradas.

Rastreamento de aberturas e cliques

O rastreamento se aplica a mensagens HTML. Mensagens somente de texto permanecem inalteradas. O rastreamento de aberturas adiciona um pixel; o de cliques reescreve links elegíveis para registrar uma visita antes de redirecionar. Os clientes de email dos destinatários carregam essas URLs automaticamente; elas não são APIs de gerenciamento para SDK ou CLI. Aberturas e cliques medem solicitações registradas. Bloqueio de imagens, proxies de email, scanners de segurança e visitas repetidas afetam essas contagens. Uma abertura não comprova que uma pessoa leu a mensagem. Eventos agregados aparecem nas métricas de Telemetry; o engajamento por mensagem mantém contagens e horários de diagnóstico durante sua janela de retenção de eventos.

Atribuição de pool e atualizações anuláveis

ip_pool em uma resposta é um ResourceRef com id, crn e name opcional. No PATCH, omita ip_pool para preservá-lo, envie um UUID/nome/CRN para alterá-lo ou envie {"ip_pool":null} para desvinculá-lo. Strings vazias são rejeitadas. Um pool contém IPs dedicados da conta. Se nenhum IP elegível puder ser selecionado, o envio usa os IPs compartilhados da plataforma. O campo outbound_ip da mensagem registra o endereço dedicado selecionado para ela.

Exceções de supressão

suppression_overrides substitui toda a lista quando informado; [] remove todas as exceções. Você também pode adicionar ou remover um endereço pelos endpoints aninhados /suppression-overrides. Uma exceção ignora a supressão da conta para aquele endereço somente nas mensagens que usam esse conjunto de configuração. Supressões automáticas vêm de retornos de falha e reclamações. Uma supressão manual usa POST /v1/suppressions com address e descrição e expiração opcionais. O campo opcional source_message da resposta identifica a mensagem que causou a supressão. Ele não é um seletor de solicitação.