Notificação de evento por e-mail

Download

Modo Foco

Tamanho da Fonte

Última atualização: 2025-10-15 19:42:06

A Tencent Cloud notificará o endereço de retorno sobre entrega bem-sucedida, falha na entrega, devolução de e-mail, abertura de e-mail, clique no link, cancelamento de assinatura e outros eventos. O formato do protocolo de push de eventos é o seguinte:
Solicitação de exemplo
{
  "event": "delivered",
  "email": "example@example.com",
  "bulkId": "qcloud-ses-4F001945B2D9BXXXXXX",
  "timestamp": 1587953211,
  "reason": "the reason when email failed to delivered",
  "bounceType": ""
}
Campo
Tipo
Descrição
event
string
Tipo de evento. Para obter detalhes, consulte Tipos de eventos.
email
string
Endereço de e-mail do destinatário
link
string
URL, no e-mail, em que o destinatário clica. Este campo só terá efeito quando o valor de event for click.
bulkId
string
MessageId retornado pela API SendEmail
timestamp
int
Carimbo de data e hora quando o evento é gerado
reason
string
Motivo pelo qual o e-mail não foi entregue
bounceType
string
Tipo de rejeição quando o e-mail é rejeitado pelo provedor de serviços de e-mail (ESP) do destinatário. Valores válidos: soft, hard. Este campo só terá efeito quando o valor de event for bounce.
useragent
string
O agente do usuário fornece informações sobre o dispositivo, sistema operacional e navegador usados para acessar o e-mail. É eficaz apenas quando o evento="open" ou evento="click"
username
String
O AppID correspondente à conta Tencent Cloud.
from
String
O endereço de envio (sem o alias do remetente).
fromDomain
String
O nome de domínio a partir do qual o e-mail é enviado.
templateId
Int
ID do modelo.
subject
String
Se o assunto do e-mail contiver caracteres não ASCII (como o chinês), estes serão escapados utilizando a codificação MIME.
messageId
String
O ​Message-ID​ é um campo no cabeçalho do protocolo SMTP, onde os utilizadores podem passar o seu próprio identificador único personalizado para um e-mail ao enviá-lo através de SMTP ou API. É crucial que este identificador seja capaz de identificar exclusivamente uma mensagem de correio eletrónico e esteja em conformidade com a norma RFC5322.
eventid
Int
1:delivered
2:dropped
3:bounce
4:open
5:click
6:spamreport
7:unsubscribe
8:deferred
taskId
int
 taskId da tarefa de envio em batch
Tipos de eventos
Valor
Descrição
processed
Em entrega. Esse é um estado intermediário e não pode ser retornado.
deferred
A entrega do e-mail foi atrasada pelo ESP do destinatário e está sendo repetida.
delivered
A entrega foi bem-sucedida. O ESP do destinatário recebe o e-mail.
dropped
O e-mail não pode ser entregue e é descartado por alguns motivos.
open
O destinatário abre o e-mail.
click
O destinatário clica no URL no e-mail.
bounce
O ESP do destinatário rejeita o e-mail (normalmente porque o endereço de e-mail está incorreto).
spamreport
O destinatário denuncia o e-mail.
unsubscribe
O destinatário clica no botão de cancelamento de assinatura. O URL de cancelamento de assinatura deve conter a palavra-chave “unsubscribe (cancelar assinatura)”.

Ajuda e Suporte

Esta página foi útil?

Você também pode entrar em contato com a Equipe de vendas ou Enviar um tíquete em caso de ajuda.

comentários

tencent cloud

Simple Email Service

Notificação de evento por e-mail

Solicitação de exemplo

Tipos de eventos

Ajuda e Suporte

Campo	Tipo	Descrição
event	string	Tipo de evento. Para obter detalhes, consulte Tipos de eventos.
email	string	Endereço de e-mail do destinatário
link	string	URL, no e-mail, em que o destinatário clica. Este campo só terá efeito quando o valor de `event` for `click`.
bulkId	string	`MessageId` retornado pela API `SendEmail`
timestamp	int	Carimbo de data e hora quando o evento é gerado
reason	string	Motivo pelo qual o e-mail não foi entregue
bounceType	string	Tipo de rejeição quando o e-mail é rejeitado pelo provedor de serviços de e-mail (ESP) do destinatário. Valores válidos: soft, hard. Este campo só terá efeito quando o valor de `event` for `bounce`.
useragent	string	O agente do usuário fornece informações sobre o dispositivo, sistema operacional e navegador usados para acessar o e-mail. É eficaz apenas quando o evento="open" ou evento="click"
username	String	O AppID correspondente à conta Tencent Cloud.
from	String	O endereço de envio (sem o alias do remetente).
fromDomain	String	O nome de domínio a partir do qual o e-mail é enviado.
templateId	Int	ID do modelo.
subject	String	Se o assunto do e-mail contiver caracteres não ASCII (como o chinês), estes serão escapados utilizando a codificação MIME.
messageId	String	O Message-ID é um campo no cabeçalho do protocolo SMTP, onde os utilizadores podem passar o seu próprio identificador único personalizado para um e-mail ao enviá-lo através de SMTP ou API. É crucial que este identificador seja capaz de identificar exclusivamente uma mensagem de correio eletrónico e esteja em conformidade com a norma RFC5322.
eventid	Int	1:delivered 2:dropped 3:bounce 4:open 5:click 6:spamreport 7:unsubscribe 8:deferred
taskId	int	taskId da tarefa de envio em batch

Valor	Descrição
processed	Em entrega. Esse é um estado intermediário e não pode ser retornado.
deferred	A entrega do e-mail foi atrasada pelo ESP do destinatário e está sendo repetida.
delivered	A entrega foi bem-sucedida. O ESP do destinatário recebe o e-mail.
dropped	O e-mail não pode ser entregue e é descartado por alguns motivos.
open	O destinatário abre o e-mail.
click	O destinatário clica no URL no e-mail.
bounce	O ESP do destinatário rejeita o e-mail (normalmente porque o endereço de e-mail está incorreto).
spamreport	O destinatário denuncia o e-mail.
unsubscribe	O destinatário clica no botão de cancelamento de assinatura. O URL de cancelamento de assinatura deve conter a palavra-chave “unsubscribe (cancelar assinatura)”.