Principal Integrações com Helpdesks [Freshchat] Guia passo a passo de integração

[Freshchat] Guia passo a passo de integração

Última atualização em Feb 04, 2026

⭐ Resumo

Este artigo explica como realizar a integração de conversas entre a ClaudIA e o Freshchat permitindo atendimento automatizado, uso de webhooks, automações avançadas e transbordo para grupos ou agentes específicos.

🎥 https://www.loom.com/share/fb11af49765f4476a972e4bb89f788b0

Pré-requisitos

✅ Conta ativa e paga no Freshchat
🔐 Permissão de administrador no Freshchat
🤖 Projeto criado no Hub da Cloud Humans

Passo a passo da integração

1️⃣ Criar ou validar o grupo da ClaudIA no FreshChat

  1. Acesse Admin Settings.

  2. Entre em Groups.

  3. Crie um novo grupo ou valide se já existe.

  4. Defina o nome do grupo (ex.: Cloud Humans).

  5. Adicione a conta da ClaudIA como membro.

  6. Salve.

⚠️ Defina também qual será o grupo de transbordo N2, responsável por receber os tickets que a ClaudIA não atender.

2️⃣ Gerar o token de API

  1. Em Admin Settings, acesse API Settings ou Tokens da API (duas interfaces possíveis)

  2. Gere o token.

  3. Copie o token gerado.

3️⃣ Configurar a integração no Cloud Blocks

  1. Acesse o Cloud Blocks.

  2. Clique em FreshChat.

  3. Selecione o projeto desejado.

  4. Cole o token de API.

  5. Informe o subdomínio do Freshchat:

    • Copie apenas o trecho antes de .freshchat.com.

    • Caso não apareça completo na URL, copie diretamente da tela de API.

  6. Informe o e-mail da ClaudIA.

  7. Copie o ID do grupo N2 e cole no campo indicado.

  8. Clique em Salvar. ✅

4️⃣ Configurar o webhook no Freshchat

  1. Copie o Webhook exibido na tela da integração.

  2. No Freshchat, acesse Admin Settings.

  3. Busque por:

    • Conversation Webhook (versão nova)

    • Webhook (versão antiga)

  4. Ative (Enable) o webhook.

  5. Cole a URL do webhook.

  6. Informe um e-mail (pode ser o da ClaudIA).

  7. Salve.

⚠️ O webhook da Cloud Humans deve ser o principal. O Freshchat não permite o uso simultâneo com extensões de webhook.

5️⃣ Instalar o Advanced Automation (caso não tenha instalado)

  1. Em Admin Settings, acesse: Conversation Automation (Advanced) ou Advanced Automation.

  2. Instale o aplicativo

  3. Clique em Install > Edit Settings

  4. Acesse Configurações

  5. Cole o token de API gerado anteriormente, e valide.

  6. Em Admin Settings acesse: Mobile SDK > Start Setup. E copie o APP ID.

  7. Retorne para Advanced Automation e cole o APP ID.

  8. Valide e salve.

6️⃣ Criar a automação principal da ClaudIA em Advanced Automation

Triggers (Gatilhos):

  • Group Assigns a Group

  • Bot Assigns a Group

  • Assignment Rule Assigns a Group

  • System Assigns a Group

Conditions (Condições):

  • Assign Group igual ao grupo da ClaudIA

Actions (Ações):

  • Assign to Agent → ClaudIA

Finalize em Summary > Finish.

7️⃣ Criar a automação de fallback em Advanced Automation

Triggers adicionais:

  • User Sends a Reply

  • User Starts a New Conversation

  • System Reopens a Conversation

Conditions:

  • Tipo: All of the Below

  • Assign Group igual ao grupo da ClaudIA

  • Assign To An Agent igual ao agente da ClaudIA

Actions:

  • Assign to Agent → ClaudIA

Finalize em Summary > Finish > Save.