Passar para o conteúdo principal

Perguntas Frequentes sobre Conversas

Respostas às perguntas comuns sobre conversas no Intercom — canais, transcrições, gerenciamento de respostas, spam, configurações de email e a API.

Escrito por Ivan Branimir Skoric

Use este artigo para entender como as conversas funcionam no Intercom — desde identificar o canal pelo qual um cliente entrou em contato, até baixar transcrições, gerenciar respostas e notas, lidar com spam e configurações de email, e trabalhar com a Conversations API e webhooks.

Geral

Como posso saber de qual canal um cliente está me contatando?

Quando uma mensagem de cliente é exibida na Inbox, haverá um pequeno ícone indicando o canal de onde a mensagem foi enviada. Você também verá ícones de canal na página "todas as conversas" do perfil do usuário, exibidos acima do carimbo de data/hora em cada cartão de conversa.

Uma mensagem enviada pelo web Messenger terá um ícone do Messenger. Uma enviada por um app móvel terá um ícone da Apple ou Android. Um email terá um envelope, e uma mensagem SMS terá um ícone de telefone. Mensagens enviadas de uma plataforma de mídia social (WhatsApp, Facebook, Instagram) terão o logo dessa plataforma.

Aqui está um exemplo de onde encontrar o ícone do canal em uma mensagem exibida na Inbox:

Ícones de canal na Inbox do Intercom indicando a origem de uma mensagem — Messenger, Apple (iOS), Android, email (envelope), SMS (telefone), logos do WhatsApp, Facebook e Instagram

Posso desativar o recurso que mostra quem está visualizando as conversas?

Esse recurso é chamado de teammate presence. Ele permite que você veja se outro teammate está visualizando uma conversa ou ticket. Isso ajuda a evitar que duas pessoas trabalhem na mesma conversa ou ticket e facilita a colaboração entre teammates.

Esse recurso pode ser ativado/desativado em Configurações > Inbox > Assignments > Geral na seção "Teammates presence".

Alternador de teammate presence em Configurações > Inbox > Assignments > Geral, mostrando a opção para ativar ou desativar o recurso

Nota: Se você trocar de aba ou não estiver visualizando ativamente a conversa/ticket, sua teammate presence não aparecerá na conversa/ticket.

Como faço para baixar a transcrição de uma conversa?

Se você precisar compartilhar uma conversa ou manter um registro dela, pode facilmente baixar sua transcrição.

Para baixar a transcrição de uma conversa da Inbox:

  1. Abra a conversa na Inbox.

  2. Clique no menu de três pontos (...) no topo da conversa.

  3. Selecione Export conversation.

Menu de três pontos aberto em uma conversa na Inbox, com a opção Export conversation destacada

A transcrição da conversa será baixada como um arquivo .txt.

Seus users e leads também podem baixar a transcrição de uma conversa enquanto conversam com você ou interagem com Fin no Messenger:

Botão de download da transcrição como aparece para o cliente dentro do Intercom Messenger

As transcrições de conversa estão disponíveis apenas na versão desktop do Messenger.

O que está incluído na transcrição?

Sua transcrição de conversa inclui:

  • Todas as respostas na conversa

  • Os carimbos de data/hora de cada resposta

  • A data e hora em que a conversa foi criada (no fuso horário do seu workspace)

  • Respostas do Fin

  • Respostas do chatbot (mensagens automatizadas)

  • Os nomes do cliente e do teammate

  • A data e hora em que a conversa foi baixada

O que não está incluído?

O arquivo da transcrição da conversa não inclui:

  • Os diferentes estados das conversas (soneca, sem soneca, fechada)

  • Notas vistas/não vistas

  • Notas internas

  • Como e quando a conversa foi atribuída

  • CC/BCC (Campos de email Cópia Carbono / Cópia Carbono Oculta)

  • Imagens

  • Anexos

  • GIFs

  • Artigos

  • Apps

Imagens, anexos, GIFs, artigos e apps serão rotulados como texto no arquivo, como [GIF] e [Article - nome do artigo], por exemplo.

Você não pode exportar múltiplas transcrições de conversa do seu workspace, mas pode usar nossa API para isso usando nossa Conversations API.

Passos de solução de problemas que você pode tentar se...

O user está vendo caracteres estranhos na transcrição baixada. Pode acontecer que users em máquinas antigas (versões desatualizadas de Mac, Windows ou Linux) baixem uma transcrição que contém caracteres unicode (ex.: novos emojis) não presentes no sistema operacional desatualizado. Esses caracteres aparecerão como letras/números aleatórios e não como vistos no navegador. Esse é um problema do lado do user, não nosso, e não podemos corrigir. Usuários afetados precisam atualizar seu sistema operacional (ou seus conjuntos de caracteres) ou visualizar a transcrição em outra máquina. Outras pessoas para quem eles enviam a transcrição não terão o mesmo problema, verão os caracteres corretos (a menos que estejam no mesmo sistema/máquina desatualizados).

Parte da conversa não está incluída na transcrição. Se um trecho da conversa não estiver incluído na transcrição, provavelmente é porque a conversa ultrapassa o limite visível de comentários da transcrição, que no momento está definido para 200 linhas. Se a conversa ultrapassar o limite de 200 linhas, a transcrição incluirá a primeira linha da conversa e então pulará o restante até que esteja dentro do limite de 200 linhas de comentário.

Posso vincular a uma resposta específica em uma conversa?

Sim. Para compartilhar um link para uma resposta específica em uma conversa do Intercom:

  1. Passe o mouse sobre a resposta e clique nos três pontos.

  2. Clique em Copiar link para a parte selecionada da conversa.

O link é copiado para sua área de transferência. Compartilhe com um colega e ele será direcionado diretamente para essa resposta.

Como posso rastrear para qual empresa um cliente iniciou uma conversa?

Se um cliente pertence a apenas uma empresa, o Intercom vincula automaticamente essa empresa à conversa. No entanto, se um cliente faz parte de múltiplas empresas, atualmente não há um método padrão para ver para qual empresa ele estava logado quando iniciou uma conversa no Messenger.

Para rastrear isso, você pode registrar a empresa para a qual o cliente está logado em um atributo personalizado da pessoa, quando ele é carregado no Messenger. Você precisará editar sua instalação do Messenger para definir o valor desse atributo.

Então, você pode usar um workflow para adicionar uma nota à conversa que faça referência a esse atributo personalizado, quando um cliente iniciar uma conversa no Messenger.

Por exemplo, você pode criar um atributo personalizado da pessoa chamado Current Company.

Atributo personalizado da pessoa chamado Current Company configurado nas configurações de Pessoas do Intercom

Depois, crie um workflow "Cliente envia sua primeira mensagem" que envie nos canais onde você tem seu Messenger instalado (Web, iOS e Android), e selecione a ação "Adicionar uma nota".

Por fim, adicione o atributo personalizado da pessoa Current Company à nota.

Ação Adicionar uma nota do workflow configurada para incluir o atributo personalizado Current Company no corpo da nota

Uma vez ativo, esse workflow adicionará uma nota com o nome da empresa para a qual o cliente está logado quando iniciar uma conversa no Messenger.

Como posso saber de onde um usuário entrou em contato?

Você pode ver a URL de origem de uma conversa indo até a mensagem inicial e passando o mouse sobre o ícone de chat, como mostrado na captura de tela abaixo.

Tooltip mostrando a URL de origem de uma conversa ao passar o mouse sobre o ícone de chat na mensagem inicial na Inbox

Onde posso encontrar dados ou relatórios para conversas de email recebidas?

Veja dados e relatórios de email recebidos usando o relatório de Conversas e clique em + Adicionar filtro e selecione um Canal de mensagem (email).


Gerenciando conversas

Posso mesclar leads em users a partir da Inbox?

Sim, você pode ver os detalhes de cada possível duplicado e seus atributos correspondentes no painel Details da conversa na inbox.

Painel Details da conversa na Inbox mostrando um contato duplicado detectado com atributos correspondentes listados para revisão

Se a conversa for com um lead e o duplicado detectado for um user, você pode clicar em Merge Lead into User. Isso atualizará a conversa na inbox com os detalhes do user recém-mesclado, para que você possa ver conversas anteriores, etc.

Botão Merge Lead into User no painel Details da conversa, usado para combinar um lead e um registro de user

Posso mesclar conversas?

Sim, você pode mesclar conversas, veja como funciona aqui.

Posso excluir a nota de resumo que é criada quando duas conversas são mescladas?

Não, atualmente não há opção para excluir isso pela interface. Se for urgente, por favor, entre em contato conosco no Messenger.

Posso cancelar o envio, relembrar ou excluir uma resposta que envio para um user?

Você pode cancelar o envio de uma resposta usando o recurso de atraso para desfazer envio, ou excluí-la depois que ela for enviada.

Se a permissão undo send delay estiver ativada para você, um popup aparece após o envio da mensagem — clique em Desfazer antes que o temporizador expire para cancelar a mensagem. Opções de atraso de 5s, 10s, 20s ou 30s. O recurso funciona em mensagens diretas, canais e threads.

No entanto, respostas enviadas por email não podem ser excluídas do cliente de email do seu user. Se seu user não vir sua resposta no Messenger em até três minutos, uma notificação por email com a conversa será enviada para o user — que você também não pode excluir. Não há funcionalidade de recall de email.

Nota: Desativar notificações por email após Conversas só é possível no nível do workspace. Atualmente não há opção para desligar esses emails para clientes ou Conversas específicas.

Para excluir uma resposta na Inbox, clique nos três pontos ao lado da mensagem.

Ícone de menu de três pontos visível ao lado de uma mensagem no thread da conversa na Inbox

Então selecione Excluir mensagem.

Dropdown de ações da mensagem com a opção Excluir mensagem visível

Você será solicitado a confirmar sua escolha. Isso ajuda a garantir que você não exclua uma mensagem por acidente.

Importante: Você não pode recuperar mensagens que excluir.

Seu user agora não verá mais a mensagem. Veja como ela aparecerá para ele no Messenger:

Como uma mensagem excluída aparece para o cliente no Intercom Messenger — um espaço reservado substitui o conteúdo original

Veja como a mensagem excluída aparecerá para você na inbox:

Como uma mensagem excluída aparece para um colega na Inbox — a mensagem é substituída por um indicador de estado excluído

Por que não consigo ver a opção de atraso para desfazer envio no meu compositor?

A opção de atraso para desfazer envio só aparece no compositor da Inbox quando a permissão Can enable undo send delay foi ativada para sua conta. Se você não a vê, peça ao administrador do workspace para ativar essa permissão para você.

Uma vez que a permissão esteja ativada, você pode definir sua duração de atraso preferida (5s, 10s, 20s ou 30s). A opção está disponível em mensagens diretas, canais e threads.

Posso excluir uma nota?

Sim, você pode excluir uma nota em uma conversa. Para excluir uma nota na Inbox, clique nos três pontos ao lado da nota e selecione Excluir mensagem. Você será solicitado a confirmar — esta ação não pode ser desfeita.

Veja como a nota excluída aparecerá para você na inbox:

Como uma nota excluída aparece na visualização da conversa na Inbox — um espaço reservado substitui a nota original

Para excluir uma resposta de uma conversa, os colegas de equipe precisam da permissão Can delete replies from a conversation permission. Para excluir uma nota, eles precisam da permissão Can delete notes from a conversation. Essas permissões podem ser configuradas independentemente em Configurações > Teammates.

Posso editar uma nota?

Sim, você pode editar notas que você postou em conversas e tickets na inbox. Não é necessário excluir e reescrever — basta fazer suas alterações diretamente e salvar. Esse recurso está disponível apenas na web.

Como editar uma nota:

Notas editadas exibem um rótulo "Editado". Passar o mouse sobre esse rótulo mostra o horário da última atualização da nota. A edição de nota funciona tanto no fluxo principal da conversa quanto no painel lateral.

Nota: Apenas o autor original de uma nota pode editá-la — não há substituição administrativa para editar notas de outro colega. Notas geradas por bot, workflow e Fin não são editáveis. Editar uma nota publicada em múltiplos locais de um ticket back-office não edita a nota original do back-office, e vice-versa. A edição é controlada pela permissão Can edit notes do colega de equipe.

Posso reagir a uma nota?

Sim, os colegas de equipe podem adicionar reações de emoji às notas de administrador nos tópicos de conversa. As reações permitem comunicar sinais leves — como reconhecimento ou concordância — diretamente em uma nota, sem poluir o tópico com uma resposta completa.

Como adiciono uma reação de emoji a uma nota?

Na Intercom Inbox, passe o mouse sobre qualquer nota de colega e clique no ícone de rosto sorridente na barra de ações (junto com marcador e copiar). Selecione um emoji no seletor para adicioná-lo como reação abaixo da nota.

Como vejo as reações de emoji em uma nota?

Cada reação de emoji única aparece como um pequeno distintivo abaixo da nota na Inbox, mostrando o emoji e a contagem de quantos colegas o usaram. Passe o mouse sobre um distintivo para ver quem reagiu — se você reagiu, aparece "Você reagiu" junto com os nomes dos outros que reagiram. Suas próprias reações são destacadas visualmente para que você veja facilmente quais emojis adicionou.

Como alterno ou removo uma reação de emoji?

Na Intercom Inbox, clique em um distintivo de reação existente para alternar sua reação — não é necessário reabrir o seletor. Você só pode remover suas próprias reações, não as adicionadas por outros colegas.

As reações de emoji contam para as métricas de relatório?

Reações de emoji não contam como participação na conversa nos relatórios. Reagir a uma nota é excluído das métricas de atribuição de colegas, então não aparecerá como uma conversa participada para o colega que reagiu.

Posso excluir nota de Users na barra lateral direita das conversas?

Sim, você pode excluir uma nota que está na barra lateral da conversa em "User notes" clicando no ícone de lixeira, como mostrado na captura de tela abaixo.

Ícone de lixeira (excluir) mostrado ao lado de uma nota de usuário na seção User notes da barra lateral direita da conversa

As notas de usuário no Messenger quebram para uma nova linha?

Sim. As notas de usuário no Messenger quebram automaticamente para uma nova linha quando o texto ultrapassa a largura do painel — não são necessárias quebras de linha manuais.

Como removo endereços de e-mail da empresa de conversas em grupo?

Quando seus clientes copiam pessoas em uma conversa, isso pode fazer com que os endereços de suporte da sua empresa (por exemplo, support@exampleapp.io) sejam incluídos na conversa como um lead. Para evitar isso, você precisará marcar esses endereços como 'endereços da empresa' para que saibamos ignorá-los.

Em Configurações > Canais > Email > Configurações de email, você pode adicionar quantos endereços da empresa quiser na seção "Endereços ignorados". Uma vez adicionados, eles não aparecerão em conversas em grupo.

Seção Endereços ignorados em Configurações > Canais > Email > Configurações de email, mostrando uma lista de endereços de e-mail da empresa excluídos de conversas em grupo

Dica: O Intercom tentará detectar automaticamente e adicionar quaisquer endereços de e-mail que você encaminha para sua Inbox como endereços ignorados nesta lista. Você verá "Detectado automaticamente" ao lado do endereço quando isso acontecer.

Se alguém enviar um e-mail para seu endereço de suporte e para um colega ao mesmo tempo, se o endereço de e-mail do colega estiver na lista acima, ele não será automaticamente atribuído a ele.

Exemplo mostrando um e-mail recebido enviado tanto para um endereço de suporte quanto para o e-mail de um colega, ilustrando como endereços ignorados afetam a atribuição automática de conversas

Para que isso seja atribuído ao colega, você precisará configurar ramificações em um Workflow que tenha como alvo esses endereços de e-mail dos colegas.

Por que estou recebendo e-mails inesperados no meu endereço de suporte no Intercom?

Sua conta pode fazer parte de um grupo, alias ou lista de distribuição (gerenciada no seu provedor de e-mail, como Google Workspace ou Microsoft 365) que recebe e-mails enviados para seu endereço de suporte (por exemplo, support@examply.io). Esta é a razão mais comum para entrega inesperada de e-mails quando nenhum encaminhamento está configurado e nada está configurado no Intercom.

Posso iniciar conversas em grupo a partir da Inbox?

Sim, quando você está conversando com um cliente, pode incluir outro cliente na conversa.

Isso é útil se você está conversando com um cliente e ele precisa da opinião de um colega sobre um problema específico, como preço, por exemplo.

Basta clicar ao lado de Reply no compositor e depois selecionar o contato atual para adicionar outro contato como participante digitando o nome ou endereço de e-mail dele.

Compositor da Inbox mostrando a opção de adicionar outro cliente como participante de uma conversa existente digitando o nome ou e-mail dele

Como envio e-mail para várias pessoas ao mesmo tempo a partir da Inbox?

Você também pode iniciar uma conversa por e-mail com várias pessoas a partir da Inbox:

  1. Inicie uma conversa no canto superior esquerdo e depois selecione Conversation.

  2. Defina o canal para Email.

  3. Adicione vários users no campo To.

    Campo To do compositor de e-mail com vários users adicionados, pronto para enviar uma conversa por e-mail em grupo a partir da Inbox

  4. Por padrão, todos os users serão adicionados como participantes na mesma conversa. Se você quiser criar conversas separadas para cada user, pode ativar a opção Send Separately.

Notas:

  • Quando você adiciona pessoas a uma conversa, os endereços de suporte da sua empresa (por exemplo, support@exampleapp.io) geralmente são incluídos. Você precisará marcar esses endereços como ‘endereços da empresa’ para que saibamos ignorá-los.

  • O Intercom Messenger não suporta múltiplos clientes participando simultaneamente de uma conversa, pois não é possível distinguir entre diferentes clientes dentro do próprio Messenger. A diferenciação de usuários está disponível apenas em conversas por e-mail, onde o e-mail de cada user é mostrado.

É possível fechar automaticamente uma conversa após um determinado período de tempo?

Sim, lançamos um recurso que permite criar uma automação Workflow para fechar conversas quando elas correspondem a certos critérios.

Posso excluir conversas na Inbox?

Quando um contato é excluído de um workspace, todas as conversas associadas a esse contato são removidas da inbox.

Você só pode excluir conversas na Inbox se arquivar ou excluir o usuário vinculado à conversa.

Para excluir um usuário e suas conversas, você pode usar qualquer um dos seguintes métodos:

  1. Arquive ou exclua o usuário vinculado à conversa. Arquivar funciona como uma exclusão suave — se a pessoa retornar, todos os dados, incluindo as conversas associadas, serão restaurados.

  2. Remova permanentemente todos os dados de um usuário ou lead: vá para Configurações > Dados > Excluir dados e insira o ID do usuário ou endereço de e-mail para excluí-los individualmente.

  3. Exclua usuários em massa usando a REST API do Intercom, que também exclui suas conversas associadas.

Página Configurações > Dados > Excluir dados no Intercom, mostrando campos para inserir ID do usuário ou endereço de e-mail para exclusão permanente

Nota: O método REST API em massa (opção 3 acima) exclui o usuário e todos os seus dados associados, não apenas uma única conversa. No entanto, você pode excluir conversas individuais usando a REST API aqui.

Por que não consigo visualizar algumas conversas?

Isso pode ter várias causas, mas algumas razões comuns incluem:

  • Usuário arquivado/excluído: quando um lead/usuário é arquivado ou excluído, isso também arquiva ou exclui a conversa associada ao perfil do usuário.
    Se as conversas ausentes estavam associadas a um usuário que foi recentemente arquivado, você pode restaurar o perfil do usuário adicionando-o manualmente com uma importação CSV, ou usando a REST API do Intercom para Desarquivar o Usuário. Se o Usuário entrar em contato, isso também restaurará o perfil dele. Se as conversas ausentes estiverem associadas a um lead, a importação CSV não funcionará, você só pode usar a REST API do Intercom ou aguardar o lead entrar em contato. Uma vez restaurado, o perfil do lead/usuário no Intercom será restaurado com todos os dados e detalhes das conversas.
    Se as conversas ausentes estavam associadas a um lead/usuário que foi excluído permanentemente, não é possível restaurar o lead/usuário e suas conversas via UI ou REST API do Intercom. Se você excluir um lead/usuário por engano, entre em contato conosco em até 7 dias e podemos recuperar as informações. Após 7 dias, esses dados serão destruídos permanentemente.

  • Atribuição de equipe/teammate: Quando a conversa é reatribuída para outra equipe ou teammate, isso mudará em quais inboxes ela aparece. Se você está procurando uma conversa específica na sua Inbox ou em uma View, ela pode ter sido reatribuída para outro teammate.

Como visualizo uma conversa arquivada?

Para arquivar ou excluir uma conversa na inbox do Intercom, você precisa arquivar ou excluir o usuário vinculado à conversa. Arquivar um usuário funciona como uma exclusão suave, significando que todos os dados, incluindo as conversas associadas, serão arquivados. Então, você precisará restaurar o usuário para ver suas conversas na inbox novamente. Para restaurar um usuário arquivado, adicione-o novamente via uma importação CSV ou a REST API do Intercom — ou aguarde o contato entrar em contato novamente, o que automaticamente restaura o perfil e todas as conversas associadas.

Como marco um e-mail como spam?

Para workspaces com Fin AI Agent ativado, você pode marcar conversas de e-mail como spam diretamente no cabeçalho da conversa na All inbox. Uma visualização dedicada de Spam sob Fin AI Agent na navegação à esquerda mostra todas as conversas sinalizadas pelo Fin — teammates podem revisar a justificativa do Fin e marcar mensagens como Não spam se foram sinalizadas incorretamente.

Se você não usa Fin AI Agent, pode criar um Workflow para identificar spam e fechar conversas automaticamente:

  1. Configure um workflow “Customer sends their first message” e adicione regras de público para identificar se o e-mail veio de um endereço específico que você considera spam; uma vez identificado, o workflow pode marcar a mensagem como spam e fechar a conversa.

    Workflow Customer sends their first message configurado com regras de público direcionando um endereço de e-mail específico para identificar e fechar conversas de spam

  2. Ou configure um workflow “Customer sends their first message” e adicione ramificações condicionais para identificar palavras-chave no “Message Content” que você considera spam. Uma vez identificado, o workflow pode marcar a mensagem como spam e fechar a conversa.

    Workflow Customer sends their first message com ramificações condicionais verificando o conteúdo da mensagem para palavras-chave de spam para marcar e fechar conversas correspondentes

  3. Além disso, você pode bloquear usuários que enviam spam, o que arquiva suas mensagens e impede que eles entrem em contato novamente. Para bloquear um usuário, selecione o menu suspenso no canto superior direito do perfil do usuário e escolha “Block”.

Se e-mails genuínos estão sendo capturados pelo filtro de spam, você pode verificar a pasta Spam na inbox e marcar quaisquer mensagens legítimas como “Not Spam”. O filtro de spam verifica links ocultos, malware, phishing e autenticação do remetente, mas pode ocasionalmente sinalizar e-mails genuínos incorretamente.

Quando uma conversa é marcada como spam, isto acontece:

  • A conversa é fechada imediatamente. Ela passa para um estado fechado assim que é marcada como spam. Se estava atribuída a uma equipe ou teammate, não desaparecerá — você ainda pode encontrá-la na seção fechada daquela inbox.

  • O remetente não é bloqueado. Marcar uma conversa como spam não impede que o remetente envie e-mails novamente. E-mails futuros daquele endereço ainda serão entregues na sua inbox normalmente — eles apenas não aparecerão na sua visualização de Spam. Se quiser impedir que um remetente entre em contato completamente, você precisará bloquear o usuário pelo perfil dele.

  • Fin AI Agent não vai reengajar na conversa marcada como spam. Uma vez que uma conversa é marcada como spam, o Fin não vai reencaminhar ou enviar uma nova resposta para ela. Se o mesmo cliente iniciar uma conversa nova, o Fin tratará como uma conversa nova e responderá normalmente — a marcação de spam se aplica apenas à conversa específica que foi marcada.

Como podemos evitar que clientes recebam e-mails quando um ticket é atualizado/resolvido, garantindo que ainda recebam respostas às conversas?

Você pode gerenciar notificações por e-mail em Configurações > Canais > Email > Configurações de email na seção “Notificações por email”:

  • Para impedir que clientes recebam e-mails quando um ticket é atualizado ou resolvido, desative “Ticket updates”. Isso evita e-mails automáticos de atualização de status, como “Seu problema foi resolvido.”

  • Para garantir que os clientes ainda recebam e-mails quando você responder, mantenha “Conversation updates” ativado. Assim, eles receberão um e-mail quando você responder antes de fechar a conversa.

Por que as conversas do nosso formulário no site estão sendo atribuídas à inbox errada no Intercom?

Problema:
Quando um formulário do site envia um e-mail para o Intercom, as conversas estão sendo atribuídas a um e-mail técnico em vez do e-mail do usuário, mesmo que o reply-to esteja configurado corretamente.

Explicação:
O Intercom determina o remetente de um e-mail com base no campo ‘From:’, não no campo ‘Reply-To’. Em alguns casos — como formulários de contato — o remetente pode ser alterado para a conta de encaminhamento em vez do usuário original que enviou o formulário.

Como corrigir isso

Para formulários de contato do site:

  • Em vez de enviar os dados do formulário por e-mail, use a REST API do Intercom para criar conversas diretamente. Isso garante que o usuário correto seja atribuído.

Para encaminhamento de e-mail de uma conta Gmail:

  • Use as Opções de Roteamento do Google para encaminhar e-mails corretamente para sua inbox do Intercom.

  • Alternativamente, use uma integração Gmail + Zapier para encaminhar e-mails com base em rótulos ou tags.

Seguir essas melhores práticas deve resolver o problema e garantir que as conversas sejam atribuídas à inbox correta.

Como encaminho e-mails de uma conta Gmail para o Intercom?

Se você está encaminhando e-mails de uma conta Gmail, é importante notar que desencorajamos fortemente o uso de Google Groups para encaminhamento de e-mails devido a problemas com identificação do remetente e encadeamento de e-mails no Intercom. Para uma explicação detalhada do motivo pelo qual Google Groups não são recomendados e instruções passo a passo para o Roteamento do Google Workspace, consulte nosso artigo sobre Encaminhamento automático de e-mails para a Inbox.

Quais são as diferenças entre os eventos webhook conversation.user.created, conversation.admin.single.created e conversation.deleted no Intercom, e quando devo usá-los?

As diferenças entre os eventos webhook são as seguintes:

  • conversation.user.created: Este evento é acionado quando um cliente inicia uma conversa enviando a primeira mensagem.

  • conversation.admin.single.created: Este evento é acionado quando um teammate contata um usuário primeiro, criando assim uma nova conversa.

  • conversation.deleted: Este evento é acionado quando uma conversa é deletada.

Para configurar webhooks para criar e deletar conversas no Intercom, use os seguintes eventos:

  • conversation.deleted para notificações de exclusão de conversa.

  • conversation.user.created para conversas iniciadas pelo cliente.

  • conversation.admin.single.created para conversas iniciadas por um colega de equipe.

Qual tópico de webhook devo usar para ser notificado quando uma conversa for encerrada?

Assine o tópico conversation.admin.closed para receber notificações sempre que uma conversa for encerrada — independentemente de quem ou o que tenha acionado o encerramento.

Este tópico cobre todos os cenários de encerramento:

  • Um colega de equipe encerra a conversa manualmente a partir do Inbox

  • Fin encerra a conversa após resolver a dúvida do cliente

  • Um workflow encerra a conversa automaticamente

Nota: As ações do Fin são tratadas como ações de admin na plataforma Intercom. Isso significa que encerramentos acionados pelo Fin são capturados por conversation.admin.closed da mesma forma que encerramentos feitos por um colega humano.

Quais são as capacidades e limitações de gerenciar avaliações de conversa através da API do Intercom?

A API do Intercom tem as seguintes capacidades e limitações para gerenciar avaliações de conversa:

  • Não é possível acionar ou enviar avaliações de conversa diretamente via API.

  • Para implementar avaliações de conversa, você precisa configurar workflows ou automações simples em vez de usar a API.

  • Embora você possa recuperar pontuações de avaliações existentes usando a API, você não pode atualizar ou modificar avaliações através da API.

Por que conversation_rating.rating retorna null via API mesmo que uma avaliação seja visível no relatório?

Existem dois campos de avaliação separados na API do Intercom, e eles rastreiam coisas diferentes:

  • conversation_rating.rating — registra o CSAT (pontuação de satisfação do cliente) enviado pelo cliente para um colega humano. É null se nenhum colega humano foi avaliado, ou se a pesquisa foi criada mas nunca respondida.

  • ai_agent.rating — registra o CSAT enviado para o Fin AI Agent. Este campo é preenchido apenas quando fin_participated é verdadeiro (ou seja, Fin respondeu ativamente na conversa usando um passo "Let Fin handle").

Um cenário comum que causa valores nulos:

  • Away & Reassign cria um segundo registro de CSAT. Quando uma conversa é reatribuída via modo Away, uma nova pesquisa CSAT é criada para o novo colega. Se essa pesquisa nunca for respondida, ela terá um ID interno maior que a pesquisa avaliada original. Em versões da API anteriores à 2.15, a API retorna o registro com o ID mais alto — o não respondido — então conversation_rating.rating é null mesmo que uma avaliação apareça na interface. Atualizar para versão da API 2.15 ou superior resolve isso, pois retorna a avaliação concluída mais recente.

  • CSAT do Fin em uma conversa não participada. Se uma pesquisa CSAT é atribuída ao Fin (porque a conversa foi encerrada por uma ação de operador/bot), mas a flag fin_participated do Fin é falsa, a avaliação não aparecerá em ai_agent.rating via API — mesmo que possa ser visível nos relatórios do Intercom. Esta é uma discrepância conhecida em investigação.

Dica: Ao construir relatórios externos, verifique tanto conversation_rating.rating (CSAT humano) quanto ai_agent.rating (CSAT do Fin) para obter uma visão completa. Use a versão da API 2.15 ou superior para garantir que a avaliação humana mais recentemente concluída seja retornada.

Posso associar uma empresa a uma conversa específica?

Sim, você pode associar uma empresa a uma conversa específica. Se você tem clientes conectados a várias empresas, esse recurso ajuda sua equipe a entender sobre qual empresa a conversa é. Isso é especialmente útil para organizar conversas e garantir que todos na sua equipe tenham o contexto correto.

Como faço para associar uma empresa a uma conversa?

Para associar uma empresa a uma conversa, vá para a conversa que deseja atualizar. Na barra lateral direita, procure a seção Conversation attributes e clique no campo Company. Uma lista suspensa de todas as empresas associadas ao usuário aparecerá. Você pode selecionar a empresa correta da lista ou começar a digitar seu nome para buscar uma empresa específica. Depois de escolher uma empresa, a conversa será vinculada a ela. Para usuários com apenas uma empresa, esse campo será preenchido automaticamente.

Posso definir a empresa para uma nova conversa?

Sim. No entanto, para economizar seu tempo, se um cliente pertence a apenas uma empresa, essa empresa é automaticamente associada à nova conversa ao ser criada.

Se o cliente pertence a várias empresas (ou nenhuma empresa), nenhuma associação automática é aplicada. Nesse caso, você pode definir manualmente a empresa na seção Details na barra lateral direita.

Nota: A associação automática ocorre apenas quando uma conversa é criada. Se a empresa de um cliente mudar depois, a conversa não será atualizada automaticamente.

O que acontece se um usuário não estiver mais associado a uma empresa?

Se um usuário não estiver mais associado a uma empresa, essa empresa não será uma opção na lista suspensa para novas atribuições de conversa. No entanto, ela permanecerá vinculada a quaisquer conversas existentes às quais foi previamente atribuída.

Como identificar o método de atribuição de conversa usando a REST API?

Não existe um atributo específico no Objeto Conversation da REST API que informe explicitamente como uma conversa foi atribuída a um colega. No entanto, explorando o atributo conversation_part do objeto, deve haver informações suficientes para descobrir isso.

Abaixo está uma lista de formas pelas quais uma conversa pode ser atribuída e como você pode identificar esse método de atribuição via REST API:

  • Atribuição Padrão ou Atribuída via Workflow: Procure o conversation_part que tem um atributo part_type com o valor “assignment”. Se o atributo author.type tiver o valor “bot”, isso significa que a conversa foi atribuída via método padrão do workspace ou via um Workflow, como mostrado na captura de tela abaixo.

    Trecho JSON de um objeto conversation_part mostrando part_type como 'assignment' e author.type como 'bot', indicando que a conversa foi atribuída via Workflow ou método padrão do workspace

  • Atribuição Balanceada ou Clicando no Botão 'Pull Conversation': Quando uma conversa é atribuída a um admin via Atribuição Balanceada ou clicando no botão 'Pull Conversation', o atributo part_type tem o valor "message_strategy_assignment" para ambos os casos. No entanto, para o método do botão 'Pull Conversation', o atributo author.type tem o valor "admin", como mostrado na captura de tela abaixo.

    Trecho JSON de um objeto conversation_part mostrando part_type como 'message_strategy_assignment' e author.type como 'admin', indicando que o colega usou o botão Pull Conversation
  • Para o método de Atribuição Balanceada, o atributo author.type tem o valor "bot", como mostrado na captura de tela abaixo.

    Trecho JSON de um objeto conversation_part para Atribuição Balanceada mostrando author.type como 'bot'

Conversas criadas via API são elegíveis para atribuição de inbox de bot?

Não. Conversas criadas via API não são elegíveis para atribuição de inbox de bot. Essa limitação se aplica a todos os clientes que usam integrações API para criar conversas.


Segurança

O que significa o ponto de exclamação vermelho nas mensagens?

Um erro de ponto de exclamação vermelho geralmente aparece nas mensagens quando o remetente configurou o endereço Reply-To nas configurações de e-mail para ser diferente do endereço From.

Este é um cabeçalho de e-mail usado pelo remetente para especificar qual endereço de e-mail deve receber as respostas. Esse problema é devido a uma configuração do lado do usuário final e não pode ser alterado dentro do Intercom.

O Intercom usa o campo From de um email para identificar o remetente, mas às vezes, com formulários de contato ou algumas configurações de encaminhamento de email, o remetente pode ser alterado para a conta que está fazendo o encaminhamento, em vez do remetente original.

No entanto, também serve como uma notificação geral de "erros e problemas" para alertá-lo sobre possíveis agentes mal-intencionados. Por exemplo, se um email não for verificado ou se foi encaminhado várias vezes antes de chegar à sua Inbox.

Então, isso não é necessariamente um indicador de que o usuário final é um agente mal-intencionado, apenas que a pontuação de risco aplicada foi maior do que nosso limite para um email completamente legítimo.

Como posso saber se um link é seguro em um email recebido?

Links em emails recebidos mostrarão dicas de ferramenta ao passar o mouse:

  • Links confiáveis (ou seja, domínios de propriedade do Intercom) serão exibidos com fundo branco.

  • Links não confiáveis serão exibidos com fundo laranja.

Imagens vinculadas em emails recebidos mostrarão dicas de ferramenta e uma sobreposição laranja que desaparece ao passar o mouse:

  • Links não confiáveis resultarão em uma sobreposição laranja sobre a imagem que desaparece ao passar o mouse.

  • Links não confiáveis dispararão uma intersticial para abrir em uma nova aba, exibindo a URL completa.

Comparação lado a lado na Inbox de uma dica de link confiável (fundo branco) e uma dica de link não confiável (fundo laranja) em um email recebido


Solução de problemas

O que devo fazer se meus clientes não conseguirem mais colar capturas de tela/imagens na janela de chat do Intercom?

Primeiro, tente limpar o cache/cookies, usar uma janela anônima ou tentar um dispositivo/rede diferente. Se o problema persistir, pode estar relacionado à Política de Segurança de Conteúdo (CSP). Envie uma gravação da tentativa de copiar e colar, junto com os erros do console que aparecem. Alternativamente, você pode fornecer a um agente de suporte acesso ao seu site como um usuário final para testar o problema do lado deles.

Por que os dados do usuário persistem entre conversas?

Aqui está o que você precisa saber:

  • Os atributos do usuário estão associados ao perfil do usuário e são mantidos entre todas as conversas feitas por esse usuário.

  • Quando um usuário cria uma nova conversa, os detalhes dos atributos do usuário existentes serão reutilizados automaticamente.

  • Se você precisar de dados que devem ser específicos para conversas individuais, deve usar atributos de conversa em vez disso.

  • Para evitar a persistência indesejada de dados, é recomendável arquivar quaisquer atributos de usuário que você não queira que sejam mantidos entre conversas.

Por que espaços extras e recuos são removidos quando envio uma mensagem para meus clientes?

As mensagens no Messenger são normalizadas para garantir a experiência mais consistente para os clientes em todos os canais. Embora você possa adicionar recuos usando Tab, ou simplesmente adicionando múltiplos espaços na sua mensagem no Composer, eles serão removidos assim que enviados ao cliente.

Em vez disso, você pode tentar usar quebras de linha ou listas para enfatizar partes da sua mensagem.

Respondeu à sua pergunta?