Visão geral do Email

Envie e-mails transacionais e de marketing por meio do POST /v1/email/messages. Use uma chave bk_{region}_... com o host regional correspondente: https://us1.platform.bird.com ou https://eu1.platform.bird.com. Nós assinamos a mensagem com DKIM, fazemos a entrega e reportamos o resultado de cada destinatário.

Para enviar algo antes de continuar lendo, o guia de início rápido leva você de uma chave API a uma mensagem entregue. Esta página cobre o modelo que o restante desta seção pressupõe e indica o guia de cada parte dele.

Como o envio funciona

Um envio é aceito em uma única chamada e entregue de forma assíncrona. POST /v1/email/messages valida o payload e o domínio de envio e retorna 202 Accepted com um ID de mensagem em_. Leia o resultado de cada destinatário por meio de eventos de webhook ou dos endpoints de mensagem. Enviando e-mail cobre o payload, os limites de campos e a resposta.

Duas consequências desse modelo definem o restante desta seção.

Uma mensagem, vários destinatários, um ciclo de vida cada. Uma mensagem para cinco endereços produz cinco resultados independentes, e o status no nível da mensagem que você consulta é um agregado deles. A supressão é avaliada da mesma forma: um endereço suprimido retorna rejected enquanto os outros quatro são entregues.

Toda mensagem declara por que você a está enviando. Uma categoria transactional ou marketing decide quais supressões se aplicam a ela. Alguém que cancelou a assinatura da sua newsletter ainda precisa receber a redefinição de senha, e a categoria é o que nos diz a diferença.

Um envio também pode chegar por outra rota ou sair depois. SMTP aceita submissões de qualquer coisa que fale o protocolo, e o envio agendado retém uma mensagem até um horário que você definir.

A seção Email do dashboard

Email é um dos canais na barra lateral do dashboard. Suas páginas, na ordem em que aparecem:

Os destinatários ficam fora da seção Email, em Contacts na barra lateral: All contacts armazena pessoas com propriedades personalizadas tipadas (veja Contatos), e Audiences os agrupa em listas reutilizáveis para as quais um broadcast envia (veja Audiências).

Onde cada guia se encaixa

Envio. Enviando e-mail é o primeiro a ler: ele define o payload do qual todo outro caminho de envio é uma variação. A partir dele, templates armazenam conteúdo que você reutiliza, anexos adicionam arquivos, envio em lote submete até 100 mensagens em uma solicitação, e broadcasts enviam um e-mail para uma audiência inteira.

Domínios e autenticação. Domínios de envio cobre o registro de um domínio e sua verificação. DKIM, SPF e DMARC explica o que cada registro comprova para o provedor de caixa de entrada receptor, e BIMI exibe seu logo ao lado das suas mensagens em aplicativos de e-mail compatíveis.

Reputação. Supressões é a lista de endereços para os quais paramos de enviar, preenchida automaticamente a partir de hard bounces e reclamações; cancelamentos de assinatura interrompem a entrega da mesma forma, mas por preferência declarada em vez de um registro de supressão. IPs dedicados e pools e Aquecimento de IP cobrem o envio a partir de endereços IP que somente a sua organização usa. Entregabilidade de e-mail conecta tudo isso.

Saber o que aconteceu. O log de e-mail mostra uma mensagem e sua linha do tempo por destinatário. Métricas de e-mail agrega seu tráfego. Eventos é o vocabulário de eventos e como webhooks os entregam ao seu próprio endpoint.

Recebimento. Recebendo e-mail cobre as duas formas de entrada: um endereço de encaminhamento que geramos sem necessidade de DNS, ou registros MX em um subdomínio seu. Agent mailboxes se baseia nisso com caixas de entrada que seu código lê e das quais também envia.

Testes. O sandbox de e-mail exercita sua integração de ponta a ponta sem entregar em lugar nenhum. Envie para bounce@messagebird.dev para gerar um hard bounce pelo pipeline real de eventos e webhooks. O teste não grava nada na sua lista de supressão.

Para migrar e-mail de produção de outro provedor, siga o guia de migração. Ele cobre mapeamento de solicitações, DNS, supressões, webhooks, testes em sandbox e transferência de tráfego.