List Customer Emails
Leia os e-mails enviados de um cliente e o resultado da entrega.
Get Email Content
Leia um e-mail exatamente como ele foi enviado.
Visão geral
Dodo Payments envia e-mails transacionais aos seus clientes em seu nome: recibos, avisos de reembolso, avisos de assinatura, e-mails de cobrança e recuperação, concessões de direitos de acesso e links de login do Customer Portal. A aba Sent Emails no registro de um cliente mostra cada email enviado. Para cada email, você vê o que foi enviado, até onde ele chegou e por que não foi entregue quando houve uma falha. Você pode abrir o email recebido pelo cliente e enviá-lo novamente.
Os emails são mantidos por 180 dias. O status de entrega vem do provedor de email e normalmente é atualizado em segundos após cada evento de entrega.
Visualizar os e-mails de um cliente
1
Open the Customer
Acesse Sales → Customers no dashboard e selecione o cliente.
2
Open the Sent Emails Tab
A aba lista todos os emails enviados para esse cliente nos últimos 180 dias, começando pelo mais recente.
3
Read a Row
Cada linha mostra o assunto, com o remetente e o endereço do destinatário abaixo. As outras colunas mostram a Category, a Date & Time, o Delivery Status e as Actions disponíveis.
Delivery Status
Cada email tem um de cinco status. A API retorna o valor do status, e o dashboard mostra o respectivo rótulo:Motivos da falha
Quando um email não é entregue, a linha informa um motivo para que você saiba se precisa agir. Posicione o cursor sobre o status na linha para lê-lo. A API retorna o mesmo motivo emfailure_reason e um código estável em failure_code:
Cinco desses motivos exigem um endereço diferente ao reenviar, porque o mesmo endereço falharia novamente: a caixa de entrada não existe, o endereço foi rejeitado, o endereço foi bloqueado após falhas anteriores, a mensagem foi rejeitada por ser muito grande e o destinatário marcou o email como spam.
Lendo um email
Para ler um email, selecione Resend na linha correspondente ou Retry em uma linha com falha. O painel aberto mostra a cópia armazenada em Email Preview, exatamente como foi enviada. Os emails de recuperação e dunning escritos por você recebem o rótulo Written by you.
- Emails de login do Customer Portal. Eles contêm um link de login ativo, portanto o conteúdo nunca é exibido.
- Emails bloqueados. Eles nunca chegaram ao provedor, portanto não existe uma cópia.
- Emails que não puderam ser entregues ao provedor. Nenhuma cópia foi armazenada.
- Emails com mais de 180 dias. O provedor exclui o conteúdo após esse período.
Enviando um email novamente
Para enviar um email novamente, selecione Resend na linha correspondente ou Retry em uma linha com falha e confirme no painel. O botão mostra quantos reenvios o email ainda pode receber. Dodo Payments reconstrói o email a partir do evento original, não da cópia armazenada, portanto um recibo mostra o estado atual do pagamento. O email mantém a data do evento original.
Limites
Estes limites se aplicam a cada reenvio:- Cada email pode ser enviado novamente três vezes.
- Os reenvios de um email para o mesmo endereço aguardam entre as tentativas: cinco minutos após o envio mais recente antes do primeiro reenvio, dez minutos antes do segundo e quinze minutos antes do terceiro.
- Um reenvio para qualquer endereço aguarda até que tenham se passado cinco minutos desde que esse endereço recebeu um email seu pela última vez.
- Um envio que nunca chegou ao provedor não conta para os três reenvios. Ainda assim, ele acrescenta tempo à espera.
- O Resend está disponível somente no dashboard. A API é somente leitura.
Quando o Resend não está disponível
O dashboard não oferece um reenvio ou o recusa nos seguintes casos:Um email de login do Customer Portal sempre é enviado para o endereço que o solicitou, e cada reenvio cria um novo link de login.
Modo de teste
O modo de teste envia emails reais, portanto tem uma cota: 100 emails por empresa por semana. Os reenvios usam a mesma cota. Cada email do modo de teste é enviado ao destinatário real, com[TEST MODE] no início do assunto.
Para interromper os emails de clientes no modo de teste, desative Test Mode Emails em Settings → Communication → Email (consulte Test Mode Emails). Enquanto estiver desativado, nenhum email de cliente será enviado no modo de teste, nenhuma linha será adicionada à aba, nenhuma cota será consumida e o dashboard recusará um reenvio. Os emails do modo live não são afetados.
Quando a cota é consumida, nada mais é enviado no modo de teste naquela semana. O primeiro email recusado naquela semana é registrado como uma linha blocked, que exibe “Não enviado: a cota de emails do modo de teste desta semana foi consumida”. As recusas posteriores na mesma semana não adicionam linhas. A cota é redefinida no início de cada semana, na segunda-feira. O modo live não tem esse limite.
Os emails de login do Customer Portal nunca são enviados no modo de teste e não consomem a cota.
Lendo emails pela API
A lista e o conteúdo também estão disponíveis com sua chave de API, para que você possa exibir o estado da entrega nas suas próprias ferramentas de suporte. A lista retorna 10 emails por página por padrão. Definapage_size para retornar até 100 e page_number para percorrer as páginas, começando em 0.
client.customers.emails.list() e client.customers.emails.retrieveBody() (retrieve_body() em Python).
Cada item contém seu email_log_id, que você passa ao endpoint de conteúdo, e seu status. Ele também contém failure_code e failure_reason quando o envio falhou, além de has_preview para indicar se existe conteúdo armazenado. O endpoint de conteúdo retorna 422 quando um email não tem conteúdo para exibir. Cada item também contém um objeto policies que informa o que você pode fazer com a linha:
Leia
policies em vez de derivar a elegibilidade por conta própria. O servidor aplica as regras acima.
Customer Management
Gerencie clientes, histórico de compras e acesso de autoatendimento.
Communication Preferences
Escolha quais emails Dodo Payments envia em seu nome.