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. |