Passar para o conteúdo principal

Conversations FAQs

Respostas a perguntas comuns sobre conversas no Intercom — canais, transcrições, gerenciamento de respostas, spam, configurações de e-mail 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 e-mail, e trabalhar com o Conversations API e webhooks.

Geral

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

Quando uma mensagem é 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 no web Messenger terá um ícone do Messenger. Uma enviada em 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:

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

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

Esse recurso é chamado teammate presence. Ele permite ver se outro colega está visualizando uma conversa ou ticket. Isso ajuda a evitar trabalhar potencialmente na mesma conversa ou ticket e facilita a colaboração com outros colegas.

Esse recurso pode ser ativado/desativado em Settings > Inbox > Assignments > General na seção "Teammates presence".

Alternância de teammate presence em Settings > Inbox > Assignments > General, mostrando a opção para ativar ou desativar o recurso

Observação: Se você mudar 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 precisar compartilhar uma conversa ou manter um registro dela, você 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 baixar 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 no 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)

  • As respostas do Fin

  • Respostas de chatbot (mensagens automatizadas)

  • Os nomes do cliente e do teammate

  • A data e hora em que a transcrição da 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 (snoozed, unsnoozed, closed)

  • Notas vistas/não vistas

  • Notas internas

  • Como e quando a conversa foi atribuída

  • CC/BCC (Campos de e-mail Cópia/Com Cópia Oculta)

  • Imagens

  • Anexos

  • GIFs

  • Artigos

  • Apps

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

Você não pode exportar várias transcrições de conversa do seu workspace, mas pode usar nossa API para isso usando nosso Conversations API.

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

User is seeing funny characters in their downloaded transcript. It can happen that users on old machines (outdated versions of Mac, Windows or Linux) will download a transcript that has unicode characters (e.g. new emojis) not present in their outdated OS. These characters will shows as random letters/numbers and not what they see in the browser. This is a problem on the user’s end rather than ours and we can’t fix it. Afflicted users need to update their OS (or update their character sets) or view the transcript on another machine. Other people they send the transcript to will not have the same problem, they will see the correct characters (unless they’re on the same outdated OS/machine).

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 excede o limite visível de comentários da transcrição, que no momento está definido em 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 trecho até que esteja dentro do limite de 200 linhas de comentários.

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 cursor sobre a resposta e clique nos três pontos.

  2. Clique em Copy link to selected conversation part.

O link é copiado para sua área de transferência. Compartilhe com um colega e ele cairá diretamente nessa 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 existe um método padrão para ver para qual empresa eles estavam logados quando iniciaram uma conversa no Messenger.

Para rastrear isso, você pode registrar a empresa para a qual o cliente está logado em um atributo personalizado de pessoa, quando eles forem carregados 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 de pessoa chamado Current Company.

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

Em seguida, crie um fluxo "Customer sends their first message" que envia nos canais em que você tem seu Messenger instalado (Web, iOS e Android), e selecione a ação "Add a note".

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

Ação Add a note do Workflow configurada para incluir o atributo personalizado de pessoa 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 cursor sobre o ícone de chat, como mostrado na captura de tela abaixo.

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

Onde posso encontrar dados ou relatórios de conversas por e-mail recebidas?

Veja os dados e relatórios de e-mails recebidos usando o Relatório de conversas e clique em + Add filter e então selecione um Channel de mensagem (email).


Gerenciando conversas

Posso mesclar leads em users a partir da Inbox?

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

Painel Conversation Details 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 criada quando duas conversas são mescladas?

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

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

Você pode cancelar o envio de uma resposta usando o recurso de atraso de 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 Undo 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 tópicos.

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

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

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 de conversa da Inbox

Em seguida, selecione Delete message.

Dropdown de ações da mensagem com a opção Delete message 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 nenhuma mensagem que excluir.

Seu usuário agora não verá mais a mensagem. Veja como aparecerá para eles 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 undo send delay no meu composer?

A opção undo send delay só aparece no composer 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 a 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 tópicos.

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. Será solicitado que você confirme — 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 separadamente em Settings > Teammates.

Posso editar uma nota?

Sim — você pode editar notas que publicou em conversas e tickets na inbox. Não é necessário excluir e reescrever — apenas faça suas alterações inline e salve. Esse recurso está disponível apenas na web.

Como editar uma nota:

Notas editadas exibem um rótulo "Edited". Ao passar o mouse sobre esse rótulo, é exibido o carimbo de data/hora da última atualização da nota. Edit note funciona tanto na sequência principal da conversa quanto no painel lateral.

Nota: Somente o autor original de uma nota pode editá‑la — não existe uma sobrescrita administrativa para editar as notas de outro colega de equipe. As notas geradas por bot, workflow e Fin não são editáveis. Editar uma nota veiculada a partir de um ticket de back‑office não edita a nota original do back‑office, e vice‑versa. A edição é controlada pela permissão de colega de equipe Can edit notes.

Posso reagir a uma nota?

Sim — colegas de equipe podem adicionar reações com emoji às notas de admin 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 com emoji a uma nota?

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

Como vejo reações com emoji em uma nota?

Cada reação única com emoji 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, está escrito "You reacted" junto com os nomes dos outros que reagiram. Suas próprias reações são visualmente destacadas para que você veja facilmente quais emojis adicionou.

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

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

As reações com emoji contam para métricas de relatórios?

As reações com emoji não contam como participação em conversas nos relatórios. Reagir a uma nota é excluído das métricas de atribuição de colegas, portanto 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 esteja na barra lateral da conversa em "User notes" clicando no ícone de lixeira, como mostrado na captura de tela abaixo.

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

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

Quando seus clientes CC 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 'company addresses' para que saibamos ignorá‑los.

Em Settings > Channels > Email > Email settings, você pode adicionar quantos endereços da empresa quiser na seção "Ignored addresses". Depois de adicionados, eles não aparecerão em conversas em grupo.

Seção Ignored addresses em Settings > Channels > Email > Email settings, 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á "Automatically detected" ao lado do endereço quando isso acontecer.

Se alguém enviar e‑mail para seu endereço de suporte e ao mesmo tempo para um colega, e 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ê precisaria configurar branching em um Workflow que tenha como alvo esses endereços de e‑mail de colegas.

Por que estou recebendo e‑mails inesperados para 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.

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

Basta clicar ao lado de Reply no composer e então selecionar o contato atual para adicionar outro contato como participante digitando o nome ou o endereço de e‑mail dele.

Composer da Inbox mostrando a opção de adicionar outro cliente como participante de uma conversa existente digitando seu nome ou e‑mail

Como eu 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 então selecione Conversation.

  2. Defina o canal para Email.

  3. Adicione vários users no campo To.

    Campo To do composer 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.

Observações:

  • Ao adicionar pessoas a uma conversa, os endereços de suporte da sua empresa (por exemplo, support@exampleapp.io) costumam ser incluídos. Você precisará marcar esses endereços como ‘company addresses’ para que saibamos ignorá‑los.

  • O Intercom Messenger não suporta vários 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 é exibido.

É 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 corresponderem a determinados critérios.

Posso excluir conversas na Inbox?

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

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

  1. Archive or delete the user attached to the conversation. Archiving acts as a soft delete — if the person returns, all data including associated conversations will be restored.

  2. Permanently remove all data for a user or lead: go to Settings > Data > Delete data and enter their user ID or email address to delete them individually.

  3. Delete users in bulk using Intercom's REST API, which also deletes their associated conversations.

Settings > Data > Delete data page in Intercom, showing input fields to enter a user ID or email address for permanent deletion

Note: The bulk REST API method (option 3 above) deletes the user and all their associated data, not just a single conversation. You can however delete single conversations using the REST API here.

Why can't I view some conversations?

This could have multiple causes, but some common reasons include:

  • Archived/deleted user: when a lead/user is archived or deleted, this also archives or deletes the conversation associated with their user profile.
    If the missing conversations were associated with a user who was recently archived, you can restore their user profile by adding the user manually with a CSV import, or by using the Intercom REST API to Unarchive the User. If the User reaches out to you, this will also restore their profile. If the missing conversations are associated with a lead, a CSV import won't work, you can only use the Intercom REST API or wait for the lead to reach out. Once restored, the lead/user Intercom profile will be restored with all data and conversations details.
    If the missing conversations were associated with a lead/user who was permanently deleted, it is not possible to restore the lead/user and their conversations via the Intercom UI or REST API. If you delete a lead/user by mistake, contact us within 7 days and we can retrieve the information. After 7 days this data will be permanently destroyed.

  • Team/Teammate assignment: When the conversation is reassigned to another team or teammate, this will change what inboxes it appears in. If you're looking for a specific conversation in your Inbox or a View, it may have been reassigned to another teammate or teammate.

How do I view an archived conversation?

To archive or delete a conversation in the Intercom inbox, you need to archive or delete the user attached to the conversation. Archiving a user acts as a soft delete, meaning all data, including associated conversations, will be archived. So you'll need to restore the user to see their conversations in the inbox again. To restore an archived user, add them back via a CSV import or the Intercom REST API — or wait for the contact to reach out again, which automatically restores their profile and all associated conversations.

How do I mark an email as spam?

For workspaces with Fin AI Agent enabled, you can mark email conversations as spam directly from the conversation header in the All inbox. A dedicated Spam view under Fin AI Agent in the left nav shows all Fin-flagged conversations — teammates can review Fin's reasoning and mark messages as Not spam if they've been incorrectly flagged.

If you don't use Fin AI Agent, you can create a Workflow to identify spam and automatically close conversations:

  1. Set up a "Customer sends their first message" workflow and add audience rules to identify if the email came from a specific address you consider spam, once identified, the workflow can tag the message as spam and close the conversation.

    Customer sends their first message workflow configured with audience rules targeting a specific sender email address to identify and close spam conversations

  2. Or, set up a "Customer sends their first message" workflow and add conditional branches to identify keywords in the "Message Content" that you consider spam. Once identified, the workflow can tag the message as spam and close the conversation.

    Customer sends their first message workflow with conditional branches checking message content for spam keywords to tag and close matching conversations

  3. Additionally, you can block users who send spam, which archives their messages and prevents them from contacting you again. To block a user, select the dropdown from the top right corner of their user profile and choose "Block".

If genuine emails are being caught by the spam filter, you can check the Spam folder in the inbox and mark any legitimate messages as "Not Spam". The spam filter checks for hidden links, malware, phishing, and sender authentication, but it may occasionally flag genuine emails incorrectly.

When a conversation is marked as spam, here's what happens:

  • The conversation is closed immediately. It moves to a closed state as soon as it's marked as spam. If it was assigned to a team or teammate, it won't disappear — you can still find it in the closed section of that inbox.

  • The sender is not blocked. Marking a conversation as spam doesn't prevent the sender from emailing you again. Future emails from that address will still be delivered to your inbox as normal — they just won't appear in your Spam view. If you want to stop a sender from contacting you entirely, you'll need to block the user from their profile instead.

  • Fin AI Agent won't re-engage on the spam conversation. Once a conversation is marked as spam, Fin won't re-queue or send a new response to it. If the same customer starts a brand new conversation, Fin will treat it as a fresh conversation and respond as normal — the spam flag only applies to the specific conversation that was marked.

How can we prevent customers from receiving emails when a ticket is updated/resolved, while still ensuring they get replies to conversations?

You can manage email notifications in Settings > Channels > Email > Email settings under the “Email notifications” section:

  • To stop customers from receiving emails when a ticket is updated or resolved, disable "Ticket updates". This prevents automatic status update emails, such as "Your issue has been resolved."

  • To ensure customers still receive emails when you reply, keep "Conversation updates" enabled. This way, they will get an email when you respond before closing the conversation.

Why are conversations from our website form being assigned to the wrong inbox in Intercom?

Issue:
When a website form sends an email to Intercom, the conversations are being assigned to a technical email instead of the user’s email, even though the reply-to is set correctly.

Explanation:
Intercom determines the sender of an email based on the ‘From:’ field, not the ‘Reply-To’ field. In some cases—such as contact forms—the sender may be changed to the forwarding account rather than the original user who submitted the form.

How to fix this

For website contact forms:

  • Instead of sending the form data via email, use Intercom’s REST API to create conversations directly. This ensures the correct user is assigned.

For email forwarding from a Gmail account:

  • Use Google’s Routing options to forward emails properly to your Intercom inbox.

  • Alternatively, use a Gmail + Zapier integration to forward emails based on labels or tags.

Following these best practices should resolve the issue and ensure conversations are assigned to the correct inbox.

How do I forward emails from a Gmail account to Intercom?

If you're forwarding emails from a Gmail account, it's important to note that we strongly discourage the use of Google Groups for email forwarding due to issues with sender identification and email threading in Intercom. For a detailed explanation of why Google Groups are not recommended and step-by-step instructions for Google Workspace Routing, please refer to our article on Automatically forward emails to the Inbox.

What are the differences between conversation.user.created, conversation.admin.single.created, and conversation.deleted webhook events in Intercom, and when should I use them?

The differences between the webhook events are as follows:

  • conversation.user.created: This event is triggered when a customer initiates a conversation by sending the first message.

  • conversation.admin.single.created: This event is triggered when a teammate contacts a user first, thus creating a new conversation.

  • conversation.deleted: This event is triggered when a conversation is deleted.

To set up webhooks for creating and deleting conversations in Intercom, use the following events:

  • conversation.deleted for conversation deletion notifications.

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

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

Qual tópico de webhook devo usar para ser notificado quando uma conversa é fechada?

Inscreva-se no tópico conversation.admin.closed para receber notificações sempre que uma conversa for fechada — independentemente de quem ou o que tenha acionado o fechamento.

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

  • Um colega fecha a conversa manualmente a partir do Inbox

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

  • Um workflow fecha a conversa automaticamente

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

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

A Intercom API possui 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, é necessário configurar workflows ou automações simples em vez de usar a API.

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

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

Existem dois campos de avaliação separados na Intercom API, 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. Está nulo 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 é true (ou seja, o 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. 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 fica nulo mesmo que uma avaliação apareça na interface. Atualizar para API version 2.15 or later resolve isso, pois retorna a avaliação mais recentemente concluída.

  • CSAT do Fin em uma conversa sem participação. Se uma pesquisa de CSAT é atribuída ao Fin (porque a conversa foi fechada por uma ação de operador/bot), mas a flag fin_participated do Fin é false, a avaliação não aparecerá em ai_agent.rating via API — mesmo que possa ser visível nos relatórios da 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 API version 2.15 ou posterior 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 trata. 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á até a conversa que você 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 na lista ou começar a digitar seu nome para procurar 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. Contudo, para economizar seu tempo, se um cliente pertence a apenas uma empresa, essa empresa é automaticamente associada à nova conversa no momento da criação.

Se o cliente pertence a várias empresas (ou nenhuma), 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 só ocorre quando uma conversa é criada. Se a empresa de um cliente mudar posteriormente, a conversa não será atualizada automaticamente.

O que acontece se um user não estiver mais associado a uma empresa?

Se um user não estiver mais associado a uma empresa, essa empresa não será uma opção no menu suspenso para novas atribuições de conversa. No entanto, ela permanecerá vinculada a quaisquer conversas existentes às quais foi anteriormente atribuída.

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

Não existe um atributo específico no Conversation Object da REST API que diga explicitamente como uma conversa foi atribuída a um colega. Porém, explorando o atributo conversation_part do objeto, deve haver informação suficiente lá para descobrir.

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_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 de atribuição 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 Clique 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 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 por bot?

Não. Conversas criadas via API não são elegíveis para atribuição de inbox por bot. Esta 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 em mensagens?

Um erro com ponto de exclamação vermelho geralmente aparece em 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 email usado pelo remetente para especificar qual endereço de email deve receber as respostas. Este problema se deve a uma configuração no 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 faz o encaminhamento, em vez do remetente original.

No entanto, também funciona como uma espécie de notificação genérica de “erros e problemas” para alertá‑lo sobre potenciais agentes maliciosos. Por exemplo, se um email não estiver verificado, ou se ele foi encaminhado várias vezes antes de chegar ao seu Inbox.

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

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

Links em emails inbound mostrarão dicas de ferramenta ao passar o cursor:

  • Links confiáveis (ou seja, domínios owned da Intercom) serão exibidos em fundo branco.

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

Imagens linkadas em emails inbound mostrarão dicas de ferramenta e uma sobreposição laranja que desaparece ao passar o cursor:

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

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

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


Solução de problemas

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

Primeiro, tente limpar cache/cookies, usar uma janela anônima ou testar em outro dispositivo/rede. Se o problema persistir, pode estar relacionado à Content Security Policy (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 usuário final para testar o problema do lado deles.

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

Veja 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 existentes serão reutilizados automaticamente.

  • Se você precisa de dados que devam ser específicos para conversas individuais, deve usar conversation attributes em vez disso.

  • Para evitar persistência de dados indesejada, é recomendado 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 aos meus clientes?

As mensagens no Messenger são normalizadas para garantir a experiência mais consistente possível 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?