Referência de dados de eventos do Customer Agent
O que você vai aprender
Saiba quais eventos o Customer Agent emite para sua conta Klaviyo, quais dados cada evento carrega e como usar esses eventos para criar segmentos e fluxo.
Como os eventos do Customer Agent funcionam
Os eventos são disparados automaticamente — não é necessário nenhuma configuração. Quando vinculados a um perfil, os eventos aparecem junto com suas outras atividades do perfil da Klaviyo. Você pode usá-los para criar segmentos, disparar fluxos e fazer referência a eles em relatórios.
A Klaviyo associa eventos a compradores usando o endereço de e-mail, o número de telefone, o ID do perfil ou o ID anônimo disponíveis. Se nenhum identificador do comprador estiver disponível, nenhum evento será registrado. Essas informações do perfil são separadas das propriedades do evento listadas abaixo.
Para ver eventos do Customer Agent, navegue até Análises > Métricas, pesquise por Customer Agent e selecione uma métrica. Abra o Feed de atividades para ver eventos recentes.
Para ver eventos de um comprador específico, abra o Registro de atividades do perfil.
Eventos
Evento | Aciona quando | Principais propriedades |
Conversa com Customer Agent Iniciada | O Customer Agent começa a lidar com a mensagem de um comprador em uma nova conversa | ID da conversa, canal, habilidade inicial |
Conversa com Customer Agent Resolvida | Uma conversa é encerrada e classificada como resolvida pela IA | ID da conversa, Canal, Habilidade final, Tags |
Conversa com Customer Agent Encaminhada | O Customer Agent aciona uma transferência ou uma conversa é encaminhada para sua equipe | ID da conversa, Canal, Motivo da escalada, Tags |
Recomendação de Produto Recebida do Customer Agent | Customer Agent exibe recomendações de produtos | ID da conversa, canal, produtos |
Conversa com Customer Agent Iniciada
Dispara quando o Customer Agent começa a atender a mensagem de um cliente em uma nova conversa.
Propriedades:
- ID da conversa
- Canal (chat web, e-mail, SMS, WhatsApp)
- Habilidade inicial (initial_skill): a habilidade detectada no início da conversa
Conversa com Customer Agent Resolvida
É acionado quando uma conversa é encerrada e classificada como resolvida por IA. Essa classificação não exige que o cliente confirme que o problema foi resolvido.
Propriedades:
- ID da conversa
- Canal
- Habilidade final (final_skill): a última habilidade detectada antes de a conversa ser encerrada
- Tags
Conversa com Customer Agent Encaminhada
Dispara quando o Customer Agent aciona uma transferência, como para uma regra de escalonamento ou uma solicitação do cliente, ou quando uma conversa é direcionada para a sua equipe. Uma transferência pode acionar esse evento antes de o cliente aceitá-la.
Propriedades:
- ID da conversa
- Canal
- Motivo da escalonamento (escalation_reason): uma categoria como knowledge_gap, explicit_ask ou custom_guidance
- Tags
Recomendação de Produto Recebida do Customer Agent
É acionado quando o Customer Agent exibe recomendações de produtos para um comprador.
Propriedades:
- ID da conversa
- Canal
- Produtos (products): uma lista que inclui o ID, o título e o URL de cada produto recomendado
Segmentos de exemplo
Para os 3 exemplos de segmentos abaixo, use O que alguém fez (ou não fez) para adicionar cada condição de evento.
Reengaje compradores que receberam uma recomendação de produto
O perfil tem pelo menos 1 Recomendação de produto recebida do Customer Agent nos últimos 14 dias E fez zero pedidos nos últimos 14 dias
Use este segmento para disparar um fluxo de acompanhamento com um lembrete sutil ou desconto. Ele exclui compradores que fizeram qualquer pedido nos últimos 14 dias, inclusive antes de receberem uma recomendação.
Exclua compradores com escalonamento recente do alcance automatizado
O perfil tem pelo menos 1 conversa do Customer Agent com o cliente escalada nos últimos 7 dias
Adicione este segmento como uma exclusão na segmentação da sua campanha para evitar entrar em contato com compradores com atividade recente de escalonamento. Este segmento não mostra se a conversa de atendimento ainda está aberta.
Para fluxos, adicione um filtro de perfil exigindo Escalated Customer Agent Conversation zero vezes nos últimos 7 dias.
Identifique compradores com conversas resolvidas
O perfil tem pelo menos 1 Resolved Customer Agent Conversation nos últimos 30 dias E fez um pedido nos últimos 30 dias
Use isso como um sinal positivo para a segmentação de VIP. As 2 condições são verificadas de forma independente, então um pedido pode ter ocorrido antes da conversa. Esse segmento não mede a conversão após a conversa.
Próximas etapas
- Crie segmentos no Klaviyo usando estes eventos — veja Segmentação no Klaviyo
- Acione fluxos com base em eventos do Customer Agent para mensagens de acompanhamento
- Revise o painel para ver tendências gerais — consulte Entendendo o painel de desempenho
Recursos adicionais
- Getting started with Customer Agent
Learn how to activate Klaviyo's Customer Agent, an AI-powered tool that provides instant support to your website visitors. Customer Agent ingests information from your Shopify store, and learns any additional information you provide, to answer shopper inquiries across web chat, email, SMS, and WhatsApp.
- Understanding the performance dashboard
Learn how to use the performance dashboard to analyze your Customer Agent’s performance and monitor its interactions.
- Segment conditions reference
Learn more about segment conditions, including how to filter your conditions and more. When building segments in Klaviyo, conditions are the building blocks that you customize to either include or exclude certain sectors of your audience. In a nutshell, profiles will only appear in your dynamic segments when they meet the specific conditions you make when creating the segment.