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 e-mail, e trabalhar com a Conversations API e webhooks.
Geral
Como posso saber de qual canal um cliente está me contatando?
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 aplicativo móvel terá um ícone da Apple ou Android. Um e-mail 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:
Posso desativar o recurso que mostra quem está visualizando as conversas?
Posso desativar o recurso que mostra quem está visualizando as conversas?
Esse recurso é chamado de presença de colega. Ele permite que você veja se outro colega 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 colegas.
Esse recurso pode ser ativado/desativado em Configurações > Inbox > Assignments > Geral na seção "Presença de colegas".
Nota: Se você trocar de aba ou não estiver visualizando ativamente a conversa/ticket, sua presença de colega não aparecerá na conversa/ticket.
Como faço para baixar a transcrição de uma conversa?
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:
Abra a conversa na Inbox.
Clique no menu de três pontos (...) no topo da conversa.
Selecione Exportar conversa.
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:
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 colega
A data e hora em que a conversa foi baixada
O que não está incluído?
O arquivo de transcrição da conversa não inclui:
Os diferentes estados das conversas (suspensas, reativadas, fechadas)
Notas vistas/não vistas
Notas internas
Como e quando a conversa foi atribuída
CC/BCC (campos de e-mail 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 [Artigo - 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 problema é do lado do user, não nosso, e não podemos corrigi-lo. Os users 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?
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:
Passe o mouse sobre a resposta e clique nos três pontos.
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?
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. Será necessário 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.
Então 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.
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.
Onde posso encontrar dados ou relatórios para conversas de email recebidas?
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 do Inbox?
Posso mesclar leads em users a partir do Inbox?
Sim, você pode ver os detalhes de cada possível duplicado e seus atributos correspondentes no painel Detalhes da conversa no inbox.
Se a conversa for com um lead e o duplicado detectado for um user, você pode clicar em Mesclar Lead em User. Isso atualizará a conversa no inbox com os detalhes do user recém-mesclado, para que você possa ver conversas anteriores, etc.
Posso mesclar conversas?
Posso mesclar conversas?
Sim, você pode mesclar conversas, veja como funciona aqui.
Posso excluir a nota de resumo criada quando duas conversas são mescladas?
Posso excluir a nota de resumo 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 a um user?
Posso cancelar o envio, relembrar ou excluir uma resposta que envio a um user?
Você pode cancelar o envio de uma resposta usando o recurso de atraso para desfazer envio, ou excluí-la após o envio.
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 ao 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 no Inbox, clique nos três pontos ao lado da mensagem.
Então selecione Excluir mensagem.
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:
Veja como a mensagem excluída aparecerá para você no inbox:
Por que não vejo a opção de atraso para desfazer envio no meu compositor?
Por que não vejo a opção de atraso para desfazer envio no meu compositor?
A opção de atraso para desfazer envio só aparece no compositor do 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 a duração do atraso preferida (5s, 10s, 20s ou 30s). A opção está disponível em mensagens diretas, canais e threads.
Posso excluir uma nota?
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:
Para excluir uma resposta de uma conversa, os colegas 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?
Posso editar uma nota?
Sim, você pode editar notas que postou em conversas e tickets na inbox. Não é necessário excluir e reescrever — basta fazer suas alterações inline 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 carimbo de data/hora 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. Notas compartilhadas em tickets back-office não podem ser editadas. A edição é controlada pela permissão Can edit notes do teammate. Macros são desativadas durante a edição de uma nota, pois são projetadas apenas para novas respostas e notas.
Posso reagir a uma nota?
Posso reagir a uma nota?
Sim, os colegas podem adicionar reações emoji a notas de admin em threads de conversa. Reações permitem comunicar sinais leves — como reconhecimento ou concordância — diretamente em uma nota, sem poluir a thread com uma resposta completa.
Como adiciono uma reação emoji a uma nota?
Na Intercom Inbox, passe o mouse sobre qualquer nota de teammate 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 emoji em uma nota?
Cada reação emoji única aparece como um pequeno distintivo abaixo da nota na Inbox, mostrando o emoji e a contagem de quantos teammates a usaram. Passe o mouse sobre o 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 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 teammates.
Reações emoji contam para métricas de relatório?
Reações emoji não contam como participação em conversa nos relatórios. Reagir a uma nota é excluído das métricas de atribuição de teammates, então não aparecerá como conversa participada para o teammate que reagiu.
Como removo endereços de email da empresa de conversas em grupo?
Como removo endereços de email 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 (ex.: 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.
Dica: O Intercom tentará detectar automaticamente e adicionar quaisquer endereços de email 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 email para seu endereço de suporte e para um teammate ao mesmo tempo, se o endereço de email do teammate estiver na lista acima, ele não será automaticamente atribuído a ele.
Para que isso seja atribuído ao teammate, você precisaria configurar ramificações em um Workflow que tenha como alvo esses endereços de email dos teammates.
Por que estou recebendo emails inesperados no meu endereço de suporte no Intercom?
Por que estou recebendo emails 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 email, como Google Workspace ou Microsoft 365) que recebe emails enviados para seu endereço de suporte (ex.: support@examply.io). Esta é a razão mais comum para entrega inesperada de emails quando nenhum encaminhamento está configurado e nada está configurado no Intercom.
Posso iniciar conversas em grupo a partir da Inbox?
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 email dele.
Como envio email para várias pessoas ao mesmo tempo a partir da Inbox?
Você também pode iniciar uma conversa por email com várias pessoas a partir da Inbox:
Inicie uma conversa no canto superior esquerdo e depois selecione Conversation.
Defina o canal para Email.
Adicione vários users no campo To.
Por padrão, todos os users serão adicionados como participantes na mesma conversa. Se quiser criar conversas separadas para cada user, você pode ativar a opção Send Separately.
Notas:
Quando você adiciona pessoas a uma conversa, os endereços de suporte da sua empresa (ex.: 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 users está disponível apenas em conversas por email, onde o email de cada user é mostrado.
É possível fechar automaticamente uma conversa após um determinado período de tempo?
É 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?
Posso excluir conversas na 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:
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.
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.
Exclua usuários em massa usando a REST API do Intercom, que também exclui suas conversas associadas.
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?
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, uma 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 para que possamos recuperar as informações. Após 7 dias, esses dados serão destruídos permanentemente.Atribuição de equipe/companheiro: Quando a conversa é reatribuída para outra equipe ou companheiro, isso muda em quais inboxes ela aparece. Se você está procurando uma conversa específica na sua Inbox ou em uma Visualização, ela pode ter sido reatribuída para outro companheiro.
Como visualizo uma conversa arquivada?
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?
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 — os companheiros podem revisar o motivo 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:
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.
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.
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 muda para um estado fechado assim que é marcada como spam. Se estava atribuída a uma equipe ou companheiro, 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 reenfileirar ou enviar uma nova resposta para ela. Se o mesmo cliente iniciar uma conversa nova, o Fin a 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 os clientes recebam e-mails quando um ticket é atualizado/resolvido, garantindo que ainda recebam respostas às conversas?
Como podemos evitar que os clientes recebam e-mails quando um ticket é atualizado/resolvido, garantindo que ainda recebam respostas às conversas?
Você pode gerenciar notificações de e-mail em Configurações > Canais > E-mail > Configurações de e-mail na seção “Notificações de e-mail”:
Para impedir que os 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?
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?
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 de por que o Google Groups não é recomendado 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?
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 companheiro contata um usuário primeiro, criando assim uma nova conversa.conversation.deleted: Este evento é acionado quando uma conversa é excluída.
Para configurar webhooks para criar e excluir conversas no Intercom, use os seguintes eventos:
conversation.deletedpara notificações de exclusão de conversa.conversation.user.createdpara conversas iniciadas pelo cliente.conversation.admin.single.createdpara conversas iniciadas por um colega de equipe.
Qual tópico de webhook devo usar para ser notificado quando uma conversa for encerrada?
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 consulta 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 de equipe humano.
Quais são as capacidades e limitações de gerenciar avaliações de conversa através da API do Intercom?
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, não é possível 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?
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 de equipe humano. É null se nenhum colega de equipe 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 de CSAT é criada para o novo colega de equipe. 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 de CSAT é atribuída ao Fin (porque a conversa foi encerrada por uma ação de operador/bot), mas a flag
fin_participateddo Fin é falsa, a avaliação não aparecerá emai_agent.ratingvia 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?
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?
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?
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?
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?
Como identificar o método de atribuição de conversa usando a REST API?
Não há um atributo específico no Objeto Conversation da REST API que informe explicitamente como uma conversa foi atribuída a um colega de equipe. No entanto, explorando o atributo conversation_part do objeto, deve haver informações suficientes para descobrir isso.
Abaixo está uma lista de maneiras 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_partque tem um atributopart_typecom o valor “assignment”. Se o atributoauthor.typetiver o valor “bot”, isso significa que a conversa foi atribuída pelo método padrão de atribuição do workspace ou via um Workflow, como mostrado na captura de tela abaixo.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_typetem 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.
Conversas criadas via API são elegíveis para atribuição de inbox de 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?
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 seu 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 e-mail para identificar o remetente, mas às vezes, com formulários de contato ou algumas configurações de encaminhamento de e-mail, 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 está verificado ou se foi encaminhado várias vezes antes de chegar à sua Inbox.
Portanto, 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 inbound?
Como posso saber se um link é seguro em um email inbound?
Links em emails inbound mostrarão dicas de ferramenta ao passar o mouse:
Links confiáveis (ou seja, domínios de propriedade da Intercom) serão exibidos com fundo branco.
Links não confiáveis serão exibidos com fundo laranja.
Imagens vinculadas em emails inbound 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 irão disparar uma intersticial para abrir em uma nova aba, exibindo a URL completa.
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?
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 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?
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 deseja manter entre conversas.
Por que espaços extras e recuos são removidos quando envio uma mensagem para meus clientes?
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.






















