URL de ponto de extremidade
O ponto de extremidade é uma URL que nosso servidor chamará para cada evento (pode resultar em muitas ocorrências!). Você pode configurá-la em suas preferências de conta.
Será retornado um código HTTP 200 Ok se tudo correr bem. Qualquer outro código HTTP fará com que nosso servidor tente fazer a solicitação novamente mais tarde (até 10 vezes, a cada 10 minutos). Se o pedido ainda falhar após 10 erros, pararemos de tentar.
Recomendamos fortemente o uso de uma URL segura (HTTPS) em combinação com uma autenticação básica para garantir que os dados não possam ser interceptados, e que somente nossos servidores possam enviar dados a você.
Ex.: https://nomedeusuario:senha@www.exemplo.com/mailjet_triggers.php
Os dados do evento são enviados no corpo da solicitação POST usando um objeto JSON. O conteúdo depende do evento.
Eventos
Todos os eventos contêm estas propriedades:event: o tipo de evento time: carimbo de tempo unix do evento (sem preocupações de fuso horário)
Evento open (abertura)
email : endereço de e-mail do destinatário que acionou o eventomj_campaign_id : ID de campanha interna do Mailjet para a REST API acessar a mensagemmj_contact_id : ID de contato interna do Mailjet para a REST API acessar o contatocustomcampaign : valor de X-Mailjet-Campaignip : endereço IP (pode ser IPv4 ou IPv6) que acionou o eventogeo : código do país do endereço IP (consulte http://www.maxmind.com/app/iso3166)agent : agente de usuário
Evento click (clique)
Contém todos os dados do evento open, mais:url : o link que foi clicado
Evento bounce (devolução)
email : endereço de e-mail do destinatário que acionou o eventomj_campaign_id : ID de campanha interna do Mailjet para a REST API acessar a mensagemmj_contact_id : ID de contato interna do Mailjet para a REST API acessar o contatocustomcampaign : valor de X-Mailjet-Campaignblocked : verdadeiro se esta devolução levar ao bloqueio do destinatáriohard_bounce : verdadeiro se o erro foi permanenteerror_related_to : consulte a tabela de erroserror : consulte a tabela de erros
Evento spam
email : endereço de e-mail do destinatário que acionou o eventomj_campaign_id : ID de campanha interna do Mailjet para a REST API acessar a mensagemmj_contact_id : ID de contato interna do Mailjet para a REST API acessar o contatocustomcampaign : valor de X-Mailjet-Campaignsource : indica qual programa de feedback loop relatou esta queixa
Evento blocked (bloqueado)
email : endereço de e-mail do destinatário que acionou o eventomj_campaign_id : ID de campanha interna do Mailjet para a REST API acessar a mensagemmj_contact_id : ID de contato interna do Mailjet para a REST API acessar o contatocustomcampaign : valor de X-Mailjet-Campaignerror_related_to : consulte a tabela de erroserror : consulte a tabela de erros
Evento unsub (assinatura cancelada)
email : endereço de e-mail do destinatário que acionou o eventomj_campaign_id : ID de campanha interna do Mailjet para a REST API acessar a mensagemmj_contact_id : ID de contato interna do Mailjet para a REST API acessar o contatomj_list_id : ID de lista interna do Mailjet para a REST API acessar o gerenciamento de listascustomcampaign : valor de X-Mailjet-Campaignip : endereço IP (pode ser IPv4 ou IPv6) que acionou o eventogeo : código do país do endereço IP (consulte http://www.maxmind.com/app/iso3166)agent : agente de usuário
Evento typofix (correção de erro de ortografia)
original_address : destinatário original da mensagemnew_address : destinatário após a modificação
Possíveis valores de erros
ERROR_RELATED_TO |
ERROR |
O QUE REALMENTE ACONTECEU? |
|---|---|---|
recipient |
user unknown |
O endereço de e-mail não existe. Verifique se há erros de digitação! |
mailbox inactive |
A conta está inativa há muito tempo. O endereço pode não mais existir. | |
quota exceeded |
Mesmo que possa ser um erro temporário, na maioria das vezes, quando as contas estão acima da cota, significa que estão inativas. | |
domain |
invalid domain |
Há um erro de digitação na parte do nome do domínio do endereço. Ou o endereço é tão antigo que o domínio venceu! |
no mail host |
Ninguém responde quando batemos à porta. | |
relay/access denied |
O servidor de e-mail de destino não responde. | |
greylisted |
É sempre temporário, e você nunca deverá ver este erro numa devolução! | |
spam |
sender blocked |
Isso é ruim! Entre em contato conosco para investigar esse problema. |
content blocked |
Algo em seu e-mail acionou um antispam, e seu e-mail foi rejeitado. Entre em contato conosco para que possamos estudar o conteúdo do e-mail e relatar qualquer falso positivo. | |
policy issue |
Fazemos nosso melhor para evitar este problema limitando envios e seguindo as práticas recomendadas. Recebemos alertas quando isso acontece, mas contate-nos para obter mais informações e soluções. | |
system |
system issue |
Ocorreu um erro nos nossos servidores. Não deveria acontecer, e nunca deverá ser permanente! |
protocol issue |
||
connection issue |
||
mailjet |
preblocked |
Você tentou enviar um e-mail para um endereço que o devolveu recentemente (ou repetidamente). Não tentamos enviá-lo para não prejudicar sua reputação. (Em breve: consulte opções para contornar o bloqueio de e-mails). |
duplicate in campaign |
Você usou o X-Mailjet-DeduplicateCampaign e enviou mais de um e-mail para um único destinatário. Apenas o primeiro foi enviado. Os outros foram bloqueados. |