Atualização semanal do produto: geolocalização em webhooks, suporte a variáveis personalizadas e mais

Tem muita coisa acontecendo no Mailgun, então decidimos começar a publicar uma lista semanal de atualizações, com os novos recursos, correções de bugs e melhorias que fizemos. Algumas dessas serão melhorias de backend que você não verá (mas esperamos que sinta), e outras serão coisas com as quais você interage, como a API ou o painel de controle. Se tiver algo urgente em que gostaria que trabalhássemos, conte para a gente nos comentários. Agora, vamos às atualizações:

• Suporte a caracteres especiais para autenticação básica de webhook via URL
• Melhor detecção de devoluções falsas
• Nova descrição do código de motivo para mensagens com falha
• Geolocalização e parâmetros de User-agent agora em webhooks
• Variáveis personalizadas em nível de destinatário disponíveis no envio em lote

Um dos nossos recursos mais populares são os webhooks para rastreamento de desempenho de e-mail (aberturas, cliques, devoluções, cancelamentos de inscrição e muito mais). Por motivos de segurança, é uma boa ideia proteger seu endpoint de webhook com autenticação básica usando nome de usuário e senha. Nesta semana, lançamos o suporte a caracteres especiais na autenticação básica de webhooks.

Digamos que você queira proteger o seu endpoint de webhook com o seguinte nome de usuário e senha

Nome de usuário- michael@mystartup.com

Senha- impossible-to-guess-password

Basta escapar os caracteres especiais em seu endpoint de webhook. Neste caso, você usaria https://michael%40mystartup.com:impossible-to-guess-password@mystartup.com/webhook” como seu endpoint de webhook

Agora, seu endpoint de webhook está protegido com autenticação básica, mesmo quando seu nome de usuário ou senha contiver caracteres especiais como @

Você pode ler mais sobre a configuração de webhooks em nosso documentação

Uma das coisas que o Mailgun faz para proteger a reputação de envio da nossa clientela é evitar tentativas repetidas de enviar e-mail para um endereço que recebeu uma “devolução definitiva”. Uma devolução definitiva acontece quando você tenta entregar uma mensagem de e-mail a um endereço de e-mail inválido (ex.: paul@yahooo.com, onde o Yahoo! é escrito com três letras ‘o’, OU paul786752@yahoo.com, onde o usuário paul786752 simplesmente não existe).

Se tentar entregar repetidamente para esses endereços de e-mail inválidos, você pode entrar na lista de bloqueio dos ESPs destinatários, que podem confundir você com um spammer (spammers geralmente tentam entregar mensagens para nomes de usuários gerados aleatoriamente nos principais ESPs, na esperança de que realmente cheguem a algumas contas reais).

Na prática, porém, entender quando ocorre uma “devolução definitiva” é bastante difícil. Não há um conjunto uniforme de convenções sobre o que constitui uma devolução definitiva entre os ESPs. Como já entregamos bilhões de e-mails, o Mailgun criou um algoritmo para detectar essas devoluções e suprimir futuras tentativas de entrega para proteger a sua reputação.

Porém, como em qualquer algoritmo, falsos positivos acontecem, o que significa que um endereço de e-mail legítimo é suprimido devido a uma resposta obscura de um ESP. Nesta semana, fizemos algumas melhorias importantes em nosso algoritmo de detecção de devoluções que nos ajuda a detectar 2% a mais de devoluções falsas do que antes. Isso significa que menos destinatários serão adicionados por engano à tabela de devoluções, evitando bloqueios em envios futuros. No fim das contas, mais dos seus e-mails serão entregues.

Você pode ler mais sobre como lidamos com as devoluções em nosso documentação.

Também introduzimos uma melhoria no rastreamento de mensagens com falha que permite aos clientes rastrear todos os motivos pelos quais uma mensagem não foi entregue, indo muito além de apenas devoluções. Agora existem três condições de falha sobre as quais o Mailgun gera relatórios:

“Hardfail” indica uma devolução definitiva ou que o destinatário já apresentou devoluções anteriores, cancelou a inscrição ou relatou spam.

“Maxfails” indica uma devolução temporária e que o número máximo de tentativas foi atingido.

“Old” indica que o Mailgun tentou entregar a mensagem sem sucesso por mais de 8 h.

Aqui está um lista completa de webhooks de mensagens com falha.

Para simplificar a detecção de geolocalização e user-agent, começamos a enviar parâmetros adicionais em nossos webhooks. Com os novos parâmetros de geolocalização nos webhooks de abertura, clique e cancelamento de inscrição, o Mailgun fornece o seguinte:

IP– Endereço IP que originou o evento.

Country– Código de duas letras código do país (conforme especificado pela ISO3166) de onde o evento se originou ou “unknown” se não puder ser determinado.

Region– Código de duas letras ou dois dígitos código da região ou “unknown” se não puder ser determinado.

City- Nome da cidade de onde o evento se originou ou “unknown” se não puder ser determinado.

Resumindo, você continua recebendo o endereço IP, mas também obtém as informações mais comuns que podem ser derivadas dele, sem a necessidade de análises ou decodificações adicionais da sua parte.

Para a detecção de agente de usuário, você obtém:

User-agent– Agente de usuário (em formato de string) do cliente que acionou o evento.

Device-type– Tipo de dispositivo em que o link foi clicado. Pode ser “desktop”, “mobile”, “tablet”, “other” ou “unknown”.

Client-type– Tipo de software no qual o link foi aberto, ex.: “browser”, “mobile browser”, “email client”.

Client-name– Nome do software cliente, ex.: “Thunderbird”, “Chrome”, “Firefox”.

Client-OS- Família de SO que executa o software cliente, ex.: “Linux”, “Windows”, “OS X”.

Você pode ler todos os detalhes aqui.

Envio em lote permite enviar e-mail para até 1.000 destinatários em uma única chamada de API. Isso torna o envio para listas grandes, como de 1 milhão ou 10 milhões na base de usuários, por exemplo, muito mais rápido. Sempre foi possível definir variáveis personalizadas para o envio em lote, mas as variáveis ficavam no nível do lote, o que significa que você podia definir uma categoria personalizada para todo o grupo (digamos, um ID de campanha), mas não um valor único para cada integrante (digamos, um número de conta com hash). Agora você pode.

Esse recurso é extremamente útil se você foca bastante em análises, pois permite definir IDs únicos para cada destinatário em seu envio. Você pode usá-los para corresponder o destinatário a um cliente específico em seu banco de dados, mesmo quando o endereço de e-mail não for um ID suficientemente único (como quando você quer rastrear a atividade no nível da conta, mas cada conta tem vários e-mails associados a ela).

Escrevemos sobre isso em nosso blog nesta semana e fornecemos um código de exemplo para que você possa testar facilmente. Dê uma olhada.

Por esta semana é só! Conte para nós o que achou e qualquer outra coisa que gostaria de ver.

Bons envios,

Os Mailgunners

Autor: The Sinch Mailgun team The Sinch Mailgun team shares news, best practices, and strategies to take your products and apps to the next level using email. Subscribe to our newsletter to get all the articles in your inbox!