> For the complete documentation index, see [llms.txt](https://docs.troqueedevolva.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.troqueedevolva.com.br/configuracoes/e-mails-automaticos.md). # E-mails automáticos Templates dos e-mails transacionais enviados aos seus clientes. ### E-mail usado como remetente Por padrão, os e-mails transacionais são enviados de nosso remetente **.** {% hint style="info" %} **Você pode usar seu próprio e-mail como remetente.** A configuração é feita diretamente no painel, em Configurações > Remetente de E-mail.\ \ Aprenda como: [Remetente de e-mail](https://docs.troqueedevolva.com.br/configuracoes/remetente-de-e-mail) {% endhint %} ### E-mails permitidos Você pode personalizar os e-mails de: * **Nova solicitação**: quando o cliente fez a solicitação. * **Solicitação negada**: pedido improcedente. * **Solicitação autorizada**: pedido procedente e autorização de postagem emitida para que o cliente compareça até a agência. * **Solicitação autorizada sem envio**: quando a devolução dos itens não é necessária. * **Solicitação autorizada com devolução pessoal**: quando o cliente precisa levar os itens até o centro de retorno indicado na autorização. * **Solicitação autorizada com coleta**: pedido procedente e autorização de coleta emitida, para que a transportadora compareça ao endereço do cliente buscar o pacote. * **Solicitação autorizada com etiqueta impressa**: quando a etiqueta é enviada ao cliente para que ele imprima, cole no pacote e faça a postagem. * **Autorização com envio por conta do cliente**: pedido procedente em que o custo do frete de retorno fica com o consumidor, que recebe o endereço de destino e posta por onde preferir. * **Etiqueta pronta para o cliente**: quando a etiqueta é emitida em uma segunda tentativa, após a autorização. Acontece, por exemplo, quando a emissão inicial falha por falta de saldo e o sistema segue tentando até conseguir. * **Confirmação de postagem**: o cliente fez a postagem ou a transportadora realizou a coleta. * **Confirmação de recebimento**: a devolução foi entregue no centro de retorno. * **Perguntar dados bancários**: para que o cliente acesse a página da solicitação e informe os dados para o reembolso. * **Perguntar ao cliente**: para perguntar algo ao cliente, com a opção de exigir anexos (fotos, documentos, etc). * **Novo comentário na solicitação**: quando um comentário é adicionado à solicitação. * **Reembolso por PIX realizado**: quando o reembolso por PIX já foi efetivado. * **Reembolso por Vale-Trocas realizado**: quando o vale-trocas já foi emitido no e-commerce. * **Reembolso por forma de pagamento personalizada**: quando o reembolso é feito por uma forma de pagamento cadastrada por você. * **Troca por produto realizada**: quando for uma troca direta e o novo produto já tiver sido despachado. * **Encerramento agendado**: quando a solicitação está pronta para ser paga, mas será concluída em uma data futura. * **Transportadora - E-mail de solicitação**: enviado para o e-mail cadastrado na transportadora, solicitando a coleta. ### Formulário de edição A personalização pode ser completa, **que deve ser feita pelo programador da sua loja.** É possível editar o **titulo do e-mail** e o **conteúdo**, utilizando texto simples ou formatação HTML e EJS. Você pode usar *emoji* livremente. O campo **Template ativo** define se aquele e-mail será disparado. Ao selecionar **Não**, o template deixa de ser enviado, sem perder a personalização já feita. Ao editar um novo e-mail, já aparecerá o modelo pronto e configurado:

Formulário de edição de um template de e-mail

Observe que temos uma caixa de texto, local onde seu desenvolvedor irá colar o HTML. **Depois, mostramos um simulador de como o e-mail ficará com dados fictícios.** Após terminar a edição, clique em **salvar**. O template passará a ser disparado de acordo com as configurações visuais que você editou. ### E-mails para cópia oculta (BCC) Você pode enviar uma cópia oculta de cada e-mail transacional para endereços internos da sua operação. É útil quando um setor precisa acompanhar as comunicações enviadas aos clientes sem depender do painel, como logística, financeiro ou atendimento. No campo **E-mails para cópia oculta (BCC)**, informe os endereços separados por vírgula: ,

Campo de e-mails para cópia oculta

A configuração é feita por template, então cada e-mail transacional pode ter destinatários diferentes. O e-mail de solicitação autorizada pode ir para a logística, enquanto o de reembolso vai para o financeiro. {% hint style="info" %} A cópia é oculta: o cliente não vê os endereços internos que receberam a mensagem. {% endhint %} ### Entendendo o código de personalização Por padrão, utilizamos [EJS](https://ejs.co/) como linguagem de marcação para os templates. Isso permite que seu **desenvolvedor** possa *programar* dentro dos e-mails. Além de personalizar a parte visual, é possível criar programação em *javascript* e utilizar qualquer dado do *json* de solicitações dentro do conteúdo do e-mail. Como pode parecer um pouco complicado para usuários comuns, recomendamos que seu desenvolvedor realize os ajustes necessários. #### Exemplo de *json* da solicitação ```json { "_id": "6679a3721de31a0011825094", "order": { "buyer": { "document": { "number": "00000000000", "type": "cpf" }, "address": { "country": "brasil", "address": "Rua Do Endereço", "number": "88", "address2": "apto 101", "postal_code": 81250280, "neighborhood": "CIC", "city": "Curitiba", "state": "PR" }, "id": "38011876", "name": "Cliente de Teste", "email": "email@docliente.com.br", "mobile": "41999999999" }, "shippment": { "destination": { "country": "brasil", "address": "Rua Do Endereço", "number": "88", "address2": "apto 101", "postal_code": 81250280, "neighborhood": "CIC", "city": "Curitiba", "state": "PR" }, "last_delivered": true, "last_delivered_at": "2021-07-22", "packages": [ { "delivered": false, "_id": "6679a3721de31a0011825096", "carrier": "pac - Frete Grátis", "tracking_number": "QF651787795BR", "tracking_url": "", "cost": 0, "shipped_at": "2021-07-15T11:05:40.000Z", "delivered_at": "2021-07-22" } ] }, "created_at": "2021-06-22T22:41:46.000Z", "order_id": "654654333", "order_number": "654654333", "payment": [ { "_id": "6679a3721de31a0011825095", "amount": 355.96, "detail": "Parcelas: 4" } ], "cart": [ { "_id": "6679a3721de31a0011825097", "sku": "SKU1", "image": "https://troqueedevolva.com.br/test-store/sandalia.webp", "link": "link", "name": "Sandália de salto Anabela 36", "quantity": 1, "price": 199.9 }, { "_id": "6679a3721de31a0011825098", "sku": "SKU2", "image": "https://troqueedevolva.com.br/test-store/vestido.webp", "link": "link", "name": "Vestido com cinto elegante", "quantity": 1, "price": 129 }, { "_id": "6679a3721de31a0011825099", "sku": "SKU3", "image": "https://troqueedevolva.com.br/test-store/blazer.webp", "link": "link", "name": "Blazer longo alfaiataria bege", "quantity": 1, "price": 219 } ] }, "request": { "items": [ { "pictures": [], "_id": "6679a3721de31a001182509a", "sku": "SKU1", "image": "https://troqueedevolva.com.br/test-store/sandalia.webp", "link": "link", "name": "Sandália de salto Anabela 36", "quantity": 1, "price": 199.9, "questions": [ { "options": [], "_id": "661180a35c83aa0011378701", "required": true, "area": "refund", "question": "Qual o motivo da devolução?", "value": "Não serviu" } ], "type": "refund" } ] }, "process": { "status": 0, "status_history": [ { "_id": "6679a5cf1de31a00118489c7", "to": 0, "user": "customer", "from": 0, "message": "solicitação criada", "updated_at": "2024-06-24T16:58:55.860Z" } ], "shippment_authorization": [] }, "createdAt": "2024-06-24T16:48:50.483Z", "updatedAt": "2024-06-27T13:23:20.696Z", } ```