Principal Integrações com Helpdesks [Intercom] Guia passo a passo da integração

[Intercom] Guia passo a passo da integração

Última atualização em Aug 09, 2025

Este artigo explica como configurar a integração entre a Claudia e o Intercom, permitindo que as mensagens do cliente sejam atendidas corretamente.

1. Criar um grupo exclusivo no Intercom

Você precisará de um grupo criado apenas para Claudia. No Intercom, navegue Configurações > Inbox > Inboxes da equipe > Nova Inbox da equpe, crie um grupo com o nome "Cloud Humans" e adicione o usuário da Claudia. O método de atribuição pode ser manual.

2. Obter o token de acesso no Intercom

Acesse Integrações > Developer Hub > Novo App, crie um novo app e dê um nome a ele, pode ser "Cloud Humans". Em seguida, copie o token de acesso na seção de autenticação.

3. Configurar o token de acesso

No Hub, cole o token de acesso que você copiou da seção de autenticação do Intercom no campo "Token".

OBS: Serão carregadas informações nas tabelas "Claudia" e "Grupos", verifique se usuário que aparece é o mesmo que usaremos para a IA, se não for, crie o token no Intercom logado na conta dela.

4. Definir os grupos

Procure o grupo criado para a Claudia, na tabela "Grupos", copie seu ID e cole-o no campo "Grupo da Claudia".

Repita o mesmo procedimento para o campo "Identificador N2", para definir o grupo que serão enviados os atendiemntos quando transbordados.

Agora já pode apertar o botão "Salvar", mas ainda feche a tela.

5. Criar uma ações no Intercom

Acesse Integrações > Ações > Criar ação.

Em "Utilização", escolha "Fluxos de trabalho e helpdesk".

Dê um nome e uma descrição para sua nova ação. (Você pode conferir as configurações aqui)

Na seção "Conexão de API", configure o método como POST, cole o webhook que está no final da tela do Hub e adicione o corpo da solicitação.

Na seção "Resposta de teste", insira qualquer valor para teste e clique em "Solicitar teste".
Isso habilitará o botão "Salvar e ativar". Salve e ative a ação.

6. Criar um Workflow no Intercom

Agora, acesse AI e Automação > Fluxos de trabalho > Novo Fluxo de trabalho > Criar a partir do zero.

  • Fluxo para chamar as ações na conversa

    Durante a conversa > Quando o cliente envia alguma mensagem

    Selecione os canais de chat que ela irá atender

    Escolha Leads e/ou Usuários

    Time assinado é Cloud Humans

  • Para canais de chat:
    No próximo caminho, procure por Ação Personalizada > Cloud Humans Message Forwarding
    Em "SE A AÇÃO NÃO FOR REALIZADA", procure novamente por Ação Personalizada > Cloud Humans Message Forwarding (Fallback)

    Em "SE A AÇÃO NÃO FOR REALIZADA", procure por "Adicionar um comentário" e escreva "Cloud Humans Webhook Called Failed"

    Para canais de e-mail:
    No próximo caminho, procure por Ação Personalizada > Cloud Humans Message Forwarding (E-mail)
    Em "SE A AÇÃO NÃO FOR REALIZADA", procure novamente por Ação Personalizada > Cloud Humans Message Forwarding (E-mail)

    Em "SE A AÇÃO NÃO FOR REALIZADA", procure por "Adicionar um comentário" e escreva "Cloud Humans Webhook Called Failed"

  • Fluxo para atribuir tickets a Claudia

    Se já tiver um fluxo de trabalho que faz a atribuição dos atendimentos para os times do Intercom e só queira colocar a Claudia em algum ponto específico:

    Basta atribuir para o grupo Cloud Humans e chamar a Ação

    Para canais de chat:
    Adicionar a Ação Personalizada > Cloud Humans Message Forwarding
    Em "SE A AÇÃO NÃO FOR REALIZADA", procure novamente por Ação Personalizada > Cloud Humans Message Forwarding (Fallback)

    Em "SE A AÇÃO NÃO FOR REALIZADA", procure por "Adicionar um comentário" e escreva "Cloud Humans Webhook Called Failed"

    Para canais de e-mail:
    Adicionar a Ação Personalizada > Cloud Humans Message Forwarding (E-mail)
    Em "SE A AÇÃO NÃO FOR REALIZADA", procure novamente por Ação Personalizada > Cloud Humans Message Forwarding (E-mail Empty)

    Em "SE A AÇÃO NÃO FOR REALIZADA", procure por "Adicionar um comentário" e escreva "Cloud Humans Webhook Called Failed"

    Se ainda não tiver um fluxo de trabalho, pode ser criado um parecido com esse, de acordo com as necessidades da empresa:

    Quando o cliente envia a primeira mensagem
    Atribuir a Cloud Humans

    Ação Personalizada > Cloud Humans Message Forwarding
    SE A AÇÃO NÃO FOR REALIZADA> Ação Personalizada > Cloud Humans Message Forwarding (Fallback)

    SE A AÇÃO NÃO FOR REALIZADA > Adicionar um comentário > "Cloud Humans Webhook Called Failed"

Conclusão

Parabéns! Você concluiu a configuração da integração do Intercom através do Hub.

Lembre-se de testar tudo cuidadosamente e configurar qualquer outra opção necessária para atender às suas necessidades.