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
- Introdução ao Customer Agent
Saiba como ativar o Customer Agent da Klaviyo, uma ferramenta com tecnologia de IA que oferece suporte instantâneo aos visitantes do seu site. O Customer Agent incorpora informações da sua loja na Shopify e aprende qualquer informação adicional que você fornecer para responder às perguntas dos compradores por chat web, e-mail, SMS e WhatsApp.
- Entendendo o painel de desempenho
Saiba como usar o painel de desempenho para analisar o desempenho do Customer Agent e monitorar as interações dele.
- Referência de condições do segmento
Saiba mais sobre as condições de segmento, incluindo como filtrar suas condições e muito mais. Ao criar segmentos na Klaviyo, as condições são os blocos de construção que você personaliza para incluir ou excluir determinados setores do seu público. Em resumo, os perfis só vão aparecer nos seus segmentos dinâmicos quando atenderem às condições específicas que você definir ao criar o segmento.