---
title: "Mostrar o design do comprador nos e-mails do Klaviyo | Centro de ajuda | Customix"
description: "Mostre o design personalizado do comprador nos e-mails do Klaviyo com código de modelo e envie um evento Customix Personalized Order ao Klaviyo para fluxos e segmentos."
url: https://customix.io/pt/help/klaviyo-email-design-images
language: pt-PT
---

# Mostrar o design do comprador nos e-mails do Klaviyo

Mostre o design personalizado do comprador nos e-mails do Klaviyo com código de modelo e envie um evento Customix Personalized Order ao Klaviyo para fluxos e segmentos.

Atualizado em 20/11/2026

Os e-mails do Klaviyo de checkout abandonado, confirmação de encomenda e envio mostram a imagem do produto, não o que o comprador personalizou. O Customix já guarda o design em cada linha da encomenda e o Klaviyo sincroniza-o a partir do Shopify. Cole um pequeno excerto de código de modelo nos seus e-mails do Klaviyo e cada linha mostra:

- a imagem do design do comprador (ou a imagem do produto quando a linha não tem design);
- as opções escolhidas pelo comprador (os campos técnicos ficam ocultos; as fotos carregadas passam a uma ligação **View image**);
- uma ligação que volta a abrir o design guardado na página do produto, em qualquer dispositivo.

![Pré-visualização de uma confirmação de encomenda do Klaviyo com duas canecas personalizadas que mostram a imagem do design](https://cdn.sanity.io/images/30j60knw/production/63b455aa9b744d2f81f46a1e34fcd758f74d5572-1202x920.png?w=1202&fit=max&auto=format)

## Antes de começar

- O Klaviyo está ligado à sua loja Shopify (**Klaviyo > Integrations > Shopify**).
- O e-mail pertence a um fluxo acionado por um destes eventos do Shopify: **Checkout Started** (checkout abandonado), **Placed Order** (confirmação de encomenda) ou **Fulfilled Order** (envio). Estes eventos incluem as linhas da encomenda.
- **Added to Cart** não inclui linhas da encomenda no Klaviyo, pelo que o código não funciona em fluxos de Added to Cart.

Encontra o código na app do Customix: **Definições > Integrações > Klaviyo**, cartão **Código do modelo de e-mail**, com um botão **Copiar** para cada excerto.

## Opção 1: adicionar o bloco de linhas da encomenda

Utilize-a quando o seu e-mail ainda não lista os produtos ou quando quer substituir a lista.

1. No Klaviyo, abra o e-mail do fluxo e clique em **Edit**.
2. Arraste um bloco **HTML** para o local onde os produtos devem aparecer.
3. Cole o código **Linhas da encomenda com imagens do design**:

```
{% for item in event.extra.line_items %}
<table width="100%" cellpadding="0" cellspacing="0" border="0" role="presentation"><tr>
<td width="120" valign="top" style="padding:12px 0;"><img src="{% if item.product.properties|lookup:'_cm-thumb-url' %}{{ item.product.properties|lookup:'_cm-thumb-url' }}{% else %}{% if item.product.variant.images.0.src %}{{ item.product.variant.images.0.src }}{% else %}{{ item.product.images.0.src|missing_product_image }}{% endif %}{% endif %}" width="120" alt="{{ item.title }}" style="display:block;width:120px;max-width:120px;height:auto;border:0;border-radius:8px;"></td>
<td valign="top" style="padding:12px 0 12px 16px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:20px;color:#202223;">
<strong>{{ item.title }}</strong><br>
{% if item.variant_title %}{{ item.variant_title }}<br>{% endif %}
{% for prop in item.properties %}{% if prop.value and prop.name|slice:":1" != "_" %}{{ prop.name }}: {% if prop.value|slice:":8" == "https://" %}<a href="{{ prop.value }}" style="color:#2c6ecb;">View image</a>{% else %}{{ prop.value }}{% endif %}<br>{% endif %}{% endfor %}
Qty: {{ item.quantity|floatformat:0 }}
{% if item.product.properties|lookup:'_cm-customization-url' %}<br><a href="{{ item.product.properties|lookup:'_cm-customization-url' }}" style="color:#2c6ecb;text-decoration:underline;">View your design</a>{% endif %}
</td>
</tr></table>
{% endfor %}
```

Pode alterar as palavras "Qty", "View image" e "View your design", as cores e a largura da imagem (120) para combinar com o seu e-mail. Num e-mail de checkout abandonado, "Finish your design" costuma resultar melhor do que "View your design".

![Pré-visualização no telemóvel de um checkout abandonado do Klaviyo com a imagem do design e uma ligação Finish your design](https://cdn.sanity.io/images/30j60knw/production/9aa6da2282d5a604f3431db53ca13d43ec6f0914-808x476.png?w=1100&fit=max&auto=format)

## Opção 2: manter a sua tabela de produtos e alterar a imagem

Utilize-a quando o seu e-mail já lista os produtos num bloco de tabela com linhas dinâmicas (alias da linha `item`, o predefinido do Klaviyo).

1. Selecione a imagem do produto da linha.
2. Defina o URL da imagem (imagem dinâmica) com o código **URL da imagem do design**:

```
{% if item.product.properties|lookup:'_cm-thumb-url' %}{{ item.product.properties|lookup:'_cm-thumb-url' }}{% else %}{% if item.product.variant.images.0.src %}{{ item.product.variant.images.0.src }}{% else %}{{ item.product.images.0.src|missing_product_image }}{% endif %}{% endif %}
```

1. Para adicionar a ligação de volta ao design, cole o código **Link do design** no texto da linha:

```
{% if item.product.properties|lookup:'_cm-customization-url' %}<a href="{{ item.product.properties|lookup:'_cm-customization-url' }}">View your design</a>{% endif %}
```

Se as suas linhas usarem um alias diferente de `item`, substitua `item.` pelo seu.

## Pré-visualizar antes de ativar o fluxo

No editor de e-mail, clique em **Preview** e escolha um evento recente (o Klaviyo lista os últimos 10). As linhas personalizadas mostram a imagem do design; as restantes mostram a imagem do produto.

## Bom saber

- **Sem imagem do design?** Se não foi possível guardar a imagem do design quando o comprador adicionou o produto ao carrinho, a linha mostra a imagem do produto. Nada deixa de funcionar.
- **Complementos e packs:** os complementos e os artigos de um pack aparecem como linhas próprias, cada uma com o seu design.
- **Campos ocultos:** as linhas da encomenda também incluem campos técnicos cujos nomes começam por `_cm-` (ficheiros de impressão, ids). O código nunca os mostra.
- **Onde estão as imagens:** as imagens do design são imagens públicas em cdn.customix.io (JPEG, cerca de 1000–1200 px, à volta de 100 KB), para que os clientes de e-mail as possam carregar.
- **Privacidade:** o código do modelo não precisa de ligação: o Klaviyo lê a encomenda a partir do Shopify. O Customix só envia o seu próprio evento depois de ligar uma chave do Klaviyo, para as encomendas feitas a partir desse momento.

## Enviar encomendas personalizadas para o Klaviyo

Ligue a sua conta do Klaviyo e o Customix envia um evento **Customix Personalized Order** por cada encomenda com design: a imagem do design, a ligação para o design e as opções escolhidas pelo comprador. Utilize-o para iniciar fluxos (um e-mail de agradecimento que mostra o design, um lembrete de reencomenda) e para criar segmentos de compradores que personalizam.

### 1\. Crie uma chave de API privada no Klaviyo

1. No Klaviyo, abra **Settings > API keys** (Account > Settings > API keys).
2. Em **Private API Keys**, clique em **Create Private API Key**.
3. Dê-lhe um nome, por exemplo `Customix`.
4. Escolha **Custom Key**, defina **Accounts** como Read Access e **Events** como Full Access, e deixe tudo o resto em No Access.
5. Clique em **Create** e copie a chave de imediato. Começa por `pk_`.

Mantenha a chave privada: quem a tiver pode escrever na sua conta do Klaviyo. Não a envie por e-mail nem por chat; cole-a apenas na app do Customix.

### 2\. Ligue-a no Customix

Só o proprietário da loja pode ligar, substituir ou desligar o Klaviyo: a chave determina que conta do Klaviyo recebe as encomendas dos seus compradores. O pessoal da loja vê uma nota em vez do formulário.

1. Na app do Customix, abra **Definições > Integrações > Klaviyo**.
2. No cartão **Enviar encomendas para o Klaviyo**, cole a chave em **Chave de API privada** e clique em **Ligar**.
3. O Customix verifica a chave junto do Klaviyo antes de a guardar. O cartão passa então a mostrar **Ligado a {a sua conta do Klaviyo}**, os últimos quatro carateres da chave e quando foi enviada a última encomenda.

Se o Klaviyo recusar a chave, o cartão indica-o por baixo do campo. Verifique se é uma chave privada (`pk_…`) com acesso Accounts (leitura) e Events (total).

A partir daí, cada nova encomenda com design é enviada em poucos minutos. As encomendas feitas antes de ligar não são enviadas.

### O que o evento contém

O evento **Customix Personalized Order** é enviado uma vez por encomenda, apenas para encomendas com pelo menos um design. As suas propriedades:

- `OrderNumber`, `OrderId`: o nome da encomenda no Shopify (#1001) e o respetivo id.
- `ProductName`, `ImageURL`, `DesignURL`: a primeira linha personalizada: produto, imagem do design e a ligação que volta a abrir o design.
- `ItemNames`, `ItemCount`: as linhas personalizadas.
- `Items`: todas as linhas personalizadas, com `ProductName`, `VariantName`, `ProductID`, `VariantID`, `SKU`, `Quantity`, `ItemPrice`, `ImageURL`, `DesignURL`, `CustomizationID` e `Options` (as opções escolhidas pelo comprador, por nome).
- O valor do evento é o total da encomenda, na moeda da encomenda.

Exemplo num e-mail de fluxo acionado pelo evento:

```
<img src="{{ event.ImageURL }}" width="300" alt="{{ event.ProductName }}">
<a href="{{ event.DesignURL }}">View your design</a>

{% for item in event.Items %}
  <img src="{{ item.ImageURL }}" width="120"> {{ item.ProductName }} × {{ item.Quantity }}
{% endfor %}
```

O perfil do comprador no Klaviyo também recebe estas propriedades, úteis para segmentos e e-mails posteriores:

- `Customix Last Personalized Product`
- `Customix Last Design Image`
- `Customix Last Design URL`
- `Customix Last Personalized Order At`

### Ideias

- **Fluxo de agradecimento** acionado por Customix Personalized Order, a mostrar `event.ImageURL`.
- **Segmento** "What someone has done: Customix Personalized Order at least once" para os compradores que personalizam.
- **Lembrete de reencomenda ou de oferta** antes do aniversário de `Customix Last Personalized Order At`, a mostrar `person|lookup:'Customix Last Design Image'`.

### Fotos carregadas pelos compradores

**Enviar as fotos carregadas pelos compradores** está desativado por predefinição, porque uma foto pode mostrar uma pessoa. Quando está ativado, as ligações para as fotos são enviadas juntamente com as opções. A imagem do design é sempre enviada: mostra a foto apenas tal como é impressa no produto.

### Sobre a ligação

- O Customix envia apenas para a sua própria conta do Klaviyo, com a sua chave. Clique em **Desligar** em qualquer altura; os eventos já enviados ficam no Klaviyo. Desinstalar o Customix também elimina a chave.
- O Shopify por vezes entrega uma encomenda duas vezes; o Klaviyo mantém um só evento por encomenda.
- O evento não altera o consentimento de ninguém para e-mail ou SMS. O Klaviyo só envia e-mails a pessoas que podem receber marketing, como em qualquer fluxo.
- Uma encomenda sem o e-mail do comprador não é enviada, porque o Klaviyo precisa de um perfil.
- Se o Klaviyo deixar de aceitar a chave (eliminada, permissões alteradas), o cartão mostra **Requer atenção** com o motivo indicado pelo Klaviyo. Clique em **Substituir chave** para colar uma nova.

## Ainda precisa de ajuda?

A nossa equipa de suporte acompanha-o em todo o processo. Envie-nos um e-mail ou marque uma chamada com a equipa.

[Enviar e-mail ao suporte →](mailto:support@customix.io?subject=Customix%20support)[Marcar uma chamada](https://calendly.com/customix-support/30min)
