Ferramentas de perfil do Customer Agent

O que você vai aprender

O que são ferramentas de perfil do Customer Agent, o que cada uma faz e como usá-las em habilidades. Essas ferramentas permitem que seu agente leia e escreva para o perfil da Klaviyo de um comprador durante uma conversa, para que ele possa personalizar respostas, responder às perguntas do tipo "o que é meu..." e capturar novos dados de volta para o perfil.

As 5 ferramentas de perfil

Essas 5 ferramentas integradas leem ou gravam dados no perfil do comprador autenticado. Você pode adicioná-las a habilidades personalizadas. Algumas ferramentas exigem que você selecione entradas ao adicioná-las, como o tipo de evento ou as Propriedades do perfil.

Todos os 5 identificam o shopper automaticamente a partir do contexto da conversa (e-mail, telefone ou ID do perfil). Eles funcionam apenas para shoppers identificados.

Para visualizar essas ferramentas, navegue até Customer Agent > Conectores e selecione Klaviyo. Você pode adicioná-los a uma habilidade personalizada pelo editor de habilidades.

Quando usar cada um

Obter perfil

Use quando o agente precisar saber com quem está falando — propriedades como nome, preferências de e-mail, o endereço salvo no perfil ou qualquer propriedade personalizada que você armazenar.

Exemplo: “Oi, Sarah! ” Vejo que o endereço no seu perfil termina em 1234. Podemos usar esse de novo?”

Get Profile também retorna onde o shopper está: o país que o Customer Agent detectou para a conversa e a localização no perfil dele. Use isso para tratar a mesma solicitação de forma diferente por país.

Exemplo: “Chame Get perfil para verificar o país do comprador.” “Se o país for o Canadá, explique que os pedidos são enviados do nosso armazém de Toronto.”

Para restringir uma habilidade inteira ou um conteúdo a alguns países, use regiões. Confira Como configurar o Customer Agent para vários países e regiões.

Obter eventos de perfil

Use quando o agente precisa saber o que o comprador fez. Pedidos, aberturas de e-mail, envios de formulários, visualizações de páginas, inscrições — qualquer coisa rastreada como um evento no perfil.

Exemplos:

• Um comprador pergunta: "Quando foi meu último pedido?" A habilidade anexa Get perfil Events com Event type = Placed Order e responde com a data.
• Um shopper pergunta: “O que eu adicionei recentemente ao meu carrinho?” A habilidade anexa Get perfil Events com Event type = Added to Cart e lista os itens em resposta.

Você escolhe o tipo de evento e outras configurações na barra lateral da ferramenta ao anexar a ferramenta. Consulte Configuração de uma ferramenta ao anexá-la abaixo.

Obter Listas e Segmentos de Perfil

Use quando o comportamento do agente deve depender do público em que o comprador está. Cliente VIP? Já está na lista de reposição de estoque? Excluído dos e-mails promocionais?

Exemplo: Se o comprador estiver no segmento VIP, o agente oferece um upgrade gratuito em uma devolução.

Obter Resumo Preditivo do Perfil

Use quando o comprador ou a habilidade precisar dos insights preditivos da Klaviyo — valor da vida útil do cliente, risco de taxa de desistência ou próxima compra esperada.

Exemplo: Uma habilidade de retenção verifica o risco de desistência antes de oferecer um desconto para salvar — os compradores de alto risco recebem uma oferta mais forte.

As previsões não estão disponíveis para todos os perfis. Diga à skill o que fazer quando os dados preditivos estiverem ausentes, como continuar sem uma oferta baseada em previsão.

Atualizar propriedade do perfil

Use quando o agente deve escrever algo de volta ao perfil do comprador durante uma conversa — respostas de questionários, preferências, feedback, qualquer coisa que você possa capturar em um formulário.

Exemplos:

• Um cliente responde a um quiz: "Eu prefiro fragrâncias terrosas." → O agente escreve scent_preference: earthy.
• Um comprador dá feedback durante uma devolução: "Não serviu, ficou pequeno." → O agente salva last_return_reason: sizing.

Quando uma propriedade estiver no perfil, todas as outras partes da Klaviyo poderão usá-la: fluxos, segmentos, campanhas e futuras conversas do Customer Agent.

Como usar essas ferramentas em uma habilidade

Para Atualizar propriedades do perfil, crie a propriedade personalizada no Klaviyo antes de adicionar a ferramenta a uma habilidade. Por exemplo, defina isso em um perfil de teste para que fique disponível no seletor de Propriedades do perfil.

1. Acesse Customer Agent > Habilidades e abra uma habilidade personalizada ou clique em Criar habilidade. Para uma nova habilidade, insira o nome e preencha Quando usar esta habilidade.
2. Em Como responder, digite / e selecione uma ferramenta de perfil no menu Ferramentas.
3. Se a barra lateral de configuração da ferramenta abrir, selecione as entradas obrigatórias e quaisquer configurações opcionais e, em seguida, clique em Salvar. Veja Configurando uma ferramenta ao anexá-la abaixo. Para alterar essas configurações depois, clique na ferramenta inserida no editor. Repita as etapas 2–3 para cada ferramenta de que você precisa.
4. Na seção Como responder, informe a habilidade quando e como usar cada ferramenta. Seja específico:
   • Quando o agente deve chamar a ferramenta
   • O que deve fazer com o resultado
   • Para Atualizar Propriedade de Perfil: qual propriedade escrever, em que formato o valor deve estar e quando não escrever
5. Se você estiver criando uma nova habilidade, clique em Salvar como rascunho para salvá-la e abrir os detalhes dela.
6. Revise suas instruções e, em seguida, clique em Publicar para uma habilidade em rascunho ou em Atualizar para uma habilidade ao vivo. Isso disponibiliza as alterações nas conversas ao vivo.

Configurando uma ferramenta quando você a anexa

Algumas ferramentas de perfil têm campos que você pode preencher previamente para cada ferramenta que inserir. O preenchimento prévio bloqueia o valor para cada chamada dessa instância da ferramenta, o que dá a você um controle mais rígido e evita que o agente tenha que descobrir isso em tempo de execução.

Obter eventos de perfil é o exemplo principal. Ao anexá-lo a uma habilidade, você pode configurar:

• Tipo de evento (obrigatório) — qual métrica buscar (por exemplo, Placed Order, Checkout Started, Added to Cart, Opened Email, Viewed Product).
• Limite — o número máximo de eventos a retornar. Escolha 1, 5, 10, 25 ou 50. O padrão é 10. Para recuperar o evento mais recente, selecione 1 evento e Mais recentes primeiro.
• Ordem de classificação — Mais recentes primeiro (padrão) ou Mais antigos primeiro.
• Janela de lookback — a que distância voltar para pesquisar. Padrão 90 dias.

Por exemplo, uma skill que precisa olhar o carrinho mais recente do comprador pode anexar Obter eventos do perfil com Tipo de evento = Checkout Started, Limite = 1 event, Ordem de classificação = Newest first, Janela de lookback = 30 days. Assim, o agente não precisa pensar nessas escolhas — elas já estão incorporadas.

Atualizar propriedades do perfil exige que você selecione Propriedades do perfil. Escolha a propriedade personalizada existente que a ferramenta deve atualizar e, em seguida, clique em Salvar. Em Como responder, informe ao agente quais valores salvar e quando salvá-los.

Obter listas e segmentos do perfil permite que você selecione Tipo de associação para retornar listas, segmentos ou ambos. O padrão retorna os dois.

Exemplo de snippet “Como responder” (Atualizar propriedade do perfil):

Quando o cliente informar a preferência de fragrância, chame Update Profile Property para salvá-la na propriedade scent_preference usando uma destas opções: floral, earthy, citrus, fresh. Escreva somente se o cliente confirmar explicitamente. Confirme o salvamento para o cliente em apenas uma frase somente se a ferramenta informar sucesso. Se falhar, explique que a preferência não foi salva.

Exemplo de snippet “Como responder” (Obter perfil + Obter eventos de perfil):

Quando o comprador perguntar sobre os pedidos recentes, chame Get Perfil Events para recuperar o histórico de pedidos. Resuma as datas e os detalhes do pedido disponíveis registrados nesses eventos. Se o comprador perguntar quem ele é ou o que está registrado, use Get Perfil.

(Anexe Obter eventos do perfil com Tipo de evento = Placed Order, Limite = 5 events, Ordem de classificação = Mais recentes primeiro.)

Dicas

• Leia antes de escrever. Se estiver personalizando uma resposta, anexe primeiro a opção Obter perfil ou Obter eventos de perfil. O agente não pode fazer referência a dados que não extraiu.
• A propriedade precisa existir primeiro e precisa ser uma propriedade personalizada. Update Profile Property só grava em propriedades do perfil personalizadas que já existem nos perfis da sua empresa. Campos do sistema (Email, First Name, phone number, subcampos de localização) e campos derivados (Created, First com atividade, $id) não são editáveis. Primeiro, crie a propriedade personalizada no Klaviyo e, depois, selecione-a em Propriedades do perfil ao configurar a ferramenta.
• Restringir o valor definido ao escrever. Explique os valores permitidos nas instruções de habilidade ("um de: floral, terroso, cítrico, fresco"). Caso contrário, o agente escreverá um texto livre e seus segmentos não corresponderão.
• Diga ao agente quando não escrever. "Somente escrever se o comprador confirmar explicitamente" evita substituições acidentais.
• Confirme que você enviou mensagens para o consumidor. Depois que a ferramenta indicar sucesso, uma breve mensagem "Entendi, salvei isso como sua preferência" encerra o processo.
• Corresponda a ferramenta à pergunta. "O que eu comprei?" → Eventos de perfil. "Sou VIP?" → Listas e segmentos. "Qual é a probabilidade de eu desisti?" → Resumo preditivo.
• Use o Composer para conectar tudo isso. Descreva o que você quer em português simples, e o Composer vai anexar as ferramentas certas e rascunhar as instruções da skill para você revisar e publicar. Por exemplo: "Quero que minha skill de recomendações analise o que estava no carrinho do comprador para recomendar algo semelhante."
• Use regiões antes de criar ramificações por país. Se uma habilidade inteira se aplica apenas em alguns países, defina regiões na habilidade. Use Obter perfil quando uma habilidade precisar de uma pequena diferença por país.

O que essas ferramentas não fazem

• Eles não funcionam diretamente em conversas anônimas. No chat web, se o agente precisar de uma dessas ferramentas e o cliente não estiver identificado, ele solicita que o cliente faça login primeiro. Depois que ele for identificado, a ferramenta é executada.
• A Atualização da Propriedade de Perfil não cria novos compradores. O perfil já deve existir.
• A propriedade Update Profile não grava eventos. A redação de eventos será uma ferramenta separada — em breve.
• Nenhuma das ferramentas lidas modifica os dados. Eles só buscam.

Perguntas frequentes

Posso escrever em qualquer propriedade com Atualizar propriedade de perfil?

Somente as Propriedades do perfil personalizadas (aquelas que você define nos perfis, como scent_preference ou isMom). No momento, não é possível editar campos do sistema — Email, First Name, $phone_number, subcampos de local, como $locale_country, e campos de patch de lista, como Viewed Items. Os campos derivados que o sistema calcula para você (Created, First Active, $id) são permanentemente somente leitura.

E se a propriedade ainda não existir?

A propriedade já deve existir na sua conta para aparecer no seletor Propriedades do perfil. Primeiro, crie-a no Klaviyo (por exemplo, definindo-a em um perfil de teste ou via um fluxo) e, em seguida, selecione-a ao configurar a ferramenta. Ela não precisa já estar definida no perfil de todos os clientes.

Uma habilidade pode chamar várias ferramentas de perfil em um turno?

Sim. Uma habilidade pode chamar qualquer combinação de ferramentas de perfil em uma única resposta, por exemplo, "Obter perfil" e "Reunir eventos de perfil" para criar uma imagem mais completa antes de responder.

O que acontece com compradores anônimos?

No chat web, se o agente precisar de uma dessas ferramentas e o cliente não for identificado, o sistema solicitará que o cliente faça login. Depois que ele for identificado, a ferramenta é executada e a conversa continua.

Essas ferramentas estão sujeitas às mesmas regras de consentimento do restante da Klaviyo?

Sim. O fluxo de dados pelo modelo padrão de perfil e consentimento do Klaviyo. Salvar uma preferência personalizada com Atualizar Propriedades do perfil não inscreve o cliente em marketing.

Próximas etapas

• Como funcionam as ferramentas do Customer Agent
• Compreensão de habilidades
• Como criar uma habilidade totalmente personalizada

Artigos relacionados