---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://yandex.com.tr/support/metrica/en/data/chat.md
- https://yandex.com.tr/support/metrica/es/data/chat.md
- https://yandex.com.tr/support/metrica/pt/data/chat.md
- https://yandex.com.tr/support/metrica/ru/data/chat.md
- https://yandex.com.tr/support/metrica/tr/data/chat.md
title: Importação de chats
description: Caso os usuários prefiram obter informações ou efetuar pedidos usando apps de mensagem (WhatsApp, Telegram ou Viber) ao interagirem com o seu site, é possível rastrear esses contatos através de eventos de chat e vinculá-los às ações do usuário no site.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/metrica/pt/llms.txt
# Importação de chats
Caso os usuários prefiram obter informações ou efetuar pedidos usando apps de mensagem (WhatsApp, Telegram ou Viber) ao interagirem com o seu site, é possível rastrear esses contatos através de eventos de chat e vinculá-los às ações do usuário no site.
A importação de chats contribui para:
- Saber quantas conversas via chat aconteceram.
- Estimar a qualidade delas: por exemplo, descobrir quantos chats não foram respondidos.
- Avaliar os resultados. É possível ver se uma conversa resultou numa compra, por exemplo.
- Ter um panorama melhor das suas interações com os clientes e ver se os canais de publicidade que geram conversas em apps de mensagem são eficazes.
## Como rastrear chats no Yandex Metrica {#follow}
Para coletar dados, utilize um [serviço de rastreamento de chat](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) ou alguma solução personalizada e depois transmita os dados de chat para o Yandex Metrica usando a [API](https://yandex.com.tr/dev/metrika/ru/data-import/).
{% note info %}
Caso você utilize uma solução personalizada e transmita os dados pela API, seu site deve possuir um sistema para coletar IDs de usuário (`ClientID`, `UserID`, `Yclid`, `EPurchaseID`) em operação, para que você possa vincular chats offline a sessões específicas do site.
{% endnote %}
O Yandex Metrica rastreia conversas usando [objetivos](https://yandex.com.tr/support/metrica/pt/general/goals.md): quando você transmite dados de conversão de chat pela primeira vez, o serviço automaticamente cria uma objetivo especial **Chat**. Esse objetivo automático aparece então na página de gerenciamento de objetivos, na interface do Yandex Metrica.
Não é preciso criar um objetivo distinto manualmente: o Yandex Metrica vai reconhecer os eventos de chat transmitidos e começar a contabilizar conversões.
O objetivo **Chat** pode ser adicionado a todo e qualquer relatório do Yandex Metrica. Você poderá visualizar métricas de conversão (conversões, objetivos atingidos etc.) relativas a esse objetivo. Também é possível utilizar o objetivo e suas conversões para otimizar anúncios, ajustar esse objetivo e suas conversões para que só sejam acionados com alguns chats específicos, e adicionar novos objetivos desse tipo.
## O que os dados de chat podem transmitir {#info}
{% note warning %}
Os dados de chat transmitidos aparecerão nos relatórios do Yandex Metrica em até 2 horas.
{% endnote %}
Você pode usar a API ou algum [serviço de rastreamento de apps de mensagem](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) para transmitir informações básicas e adicionais sobre chats para o Yandex Metrica. Entre os dados necessários incluem-se os dados que permitem identificar um evento de chat por horário e app de mensagem, assim como as IDs de uma conversa. Além disso, é possível transmitir métricas usadas para avaliar a qualidade e valor dos chats.
Para informações a respeito de dados disponíveis e como eles são usados nos relatórios, leia abaixo.
**Campos para upload de chat**
#|
|| **Informações** | **Obrigatório?** | **Descrição** ||
|| Data e horário do chat (Unix time, UTC) | Sim | Usado para registrar o evento de chat. Deve ser especificado no formato Unix timestamp (UTC). ||
|| Plataforma de chat (app de mensagem: `whatsapp`, `telegram`, `viber`) | Sim | O nome do app de mensagem. Valores aceitos: `whatsapp`, `telegram` e `viber`. ||
|| IDs de chat (nome de usuário, ID, número de telefone) | Sim (pelo menos uma ID) | Pelo menos um dos seguintes campos deve ser preenchido: `ChatUsername`, `ChatUserID` ou `PhoneNumber`. ||
|| Resposta ao chat (se o usuário recebeu ou não uma resposta) | Não | Registra se algum atendente respondeu ao chat. Valor: `1` ou `0`. ||
|| Tags de chat | Não | Uma tag de texto de até 100 caracteres. Usada para segmentação de chat. ||
|| Quantia de conversão (valor do chat) e moeda | Não | Utilize para transmitir dados de receita relativos a um chat: um valor numérico e um código de moeda ISO 4217. ||
|| URL da página na qual o chat foi iniciado no site | Não | A URL da página na qual o usuário iniciou a conversa. ||
|| Link de um serviço de rastreamento de apps de mensagem | Não | Um link técnico para o chat no sistema de rastreamento, usado para análise interna. ||
|#
## Como transmitir dados de chat {#how-send}
Há duas maneiras de se fazer a integração:
- **Usando [serviços de rastreamento de chat](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)**
O serviço fornece um código, que pode ser um widget ou um script, para ser adicionado ao seu site. O snippet de código coleta automaticamente as IDs necessárias e prepara os eventos para a importação no Yandex Metrica.
- **Diretamente por meio da API**
Para este método, siga as recomendações abaixo.
### Passo 1. Coletar IDs de usuário {#step-1}
**Objetivo**: assegurar que os chats estejam vinculados a sessões do site ou a cliques em anúncios.
- **Caso você utilize um [serviço de rastreamento de chat](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)**
Basta instalar o snippet de código que lhe foi fornecido. Ele obtém e transmite as IDs necessárias para o Yandex Metrica de forma automática, inclusive:
- **ClientID** da `_ym_uid`.
- **UserID**, caso necessária.
- **Yclid**, para tráfego do Yandex Direct.
- **Caso você utilize uma integração personalizada**
Transmitir uma ou mais das seguintes IDs:
- **ClientID**: o identificador principal de um usuário no Yandex Metrica. Recomendamos que você a envie caso um chat tenha se originado de uma sessão do site.
- **UserID**: sua ID de usuário interna, caso a funcionalidade UserID esteja habilitada.
- **Yclid**: a ID de um clique, usada no Yandex Direct. Útil para quando o usuário vai direto para o app de mensagem, sem visitar o site.
- **PurchaseID**: a ID do pedido, usada caso o chat esteja vinculado a uma transação específica. Trata-se de um caso raro.
Se nenhuma ID for transmitida, o evento será considerado **sem atribuição** e não será vinculado a nenhuma sessão ou clique.
### Passo 2. Adicionar sua própria ID de chat a links de apps de mensagem {#step-2}
**Objetivo**: fazer a correspondência explícita do chat com as IDs Yandex Metrica do Passo 1 quando uma nova conversa for iniciada.
Recomendamos o seguinte algoritmo, que é usado por [serviços de rastreamento de chat](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) e também funciona com integrações personalizadas:
1. Gerar uma **ID de chat única**. Por exemplo, `CT8F2A9`.
2. O snippet de código instalado no seu site **vai adicionar essa ID a cada link de app de mensagem:**
- **Robô do Telegram**: através de um deeplink (parâmetro de lançamento). O usuário não verá a ID, mas o robô a receberá quando contatado pela primeira vez.
- **Contas pessoais no Telegram, WhatsApp ou Viber**: através de um **modelo de primeira mensagem** pré-preenchido com a ID. Por exemplo, a ID pode ser informada em forma de tag técnica no final de uma mensagem.
3. Depois que a conversa se inicia, o serviço obtém a ID do chat do deeplink ou da primeira mensagem e **faz a correspondência** dela com as IDs Yandex Metrica coletadas anteriormente: `ClientID`, `UserID`, `Yclid`.
4. O serviço então estabelece um vínculo **ID do chat ↔ IDs Yandex Metrica** forte, suficiente para uma atribuição correta.
### Passo 3. Importar eventos para o Yandex Metrica {#step-3}
Depois que o vínculo for estabelecido, você pode começar a transmitir eventos de chat por meio da [API importadora de chats do Yandex Metrica](https://yandex.com.tr/dev/metrika/ru/management/chats). Os requisitos relativos à formatação dos dados (o horário do evento, valores aceitáveis pela plataforma, estrutura dos campos etc.) estão descritos na especificação da API.
[Fale conosco](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
- - -
#|
||
Links úteis
- [Tag de demonstração](https://metrica.yandex.com.tr/r/dashboard?)
- [Adicionar uma tag](https://metrica.yandex.com.tr/add/)
- [Configuração gratuita de tag](https://yandex.com.tr/promo/freeservice/metrica?utm_source=help_metrica_tr&utm_medium=cpc&utm_campaign=1)
- [API do Yandex Metrica](https://tech.yandex.com.tr/metrika/)
- [Sugerir uma idea](https://yandex.com.tr/support/metrica/troubleshooting/idea.html)
- [Debater no Telegram](https://t.me/yandexmetrika)
|
Treinamento online
- [Obter um certificado do Yandex Metrica](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
- [Fazer um curso](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
||
|#