Principal Integrações com Helpdesks [Zendesk] Passo a Passo Integração de Chat e WhatsApp

[Zendesk] Passo a Passo Integração de Chat e WhatsApp

Última atualização em Jan 09, 2026

⭐ Resumo

Este artigo explica como realizar a integração de conversas (Chat e WhatsApp) entre a ClaudIA e o Zendesk, permitindo o envio e recebimento de mensagens por meio da integração de conversas (Sunshine), com suporte a automação, grupos e transbordo para N2.

📝 Visão geral da integração

A integração de conversas conecta o Cloud Hub ao Zendesk para centralizar atendimentos de WhatsApp, Chat e Web Widget, possibilitando:

  • Atendimento automatizado pela Cláudia

  • Transbordo para N2

  • Uso de webhooks e gatilhos

  • Organização por grupos no Zendesk

Pré-requisitos

  • Projeto criado no Cloud Hub

  • Conta ativa no Zendesk

  • Permissão de administrador no Zendesk

  • Plano do Zendesk com Integrações de Conversas (Sunshine)

⚠️ Caso o plano não inclua Sunshine, será necessário usar uma integração alternativa (adicionar o link da FAQ).

Passo a passo da integração

📸 https://www.loom.com/share/849e8d1fff464af5a8bb95352dcbf09d

1️⃣ Acessar o projeto no Cloud Hub

  1. Entre no Hub

  2. Acesse o projeto desejado

  3. No menu lateral, clique em Integrações

  4. Selecione Zendesk

  5. Escolha a opção Chat

2️⃣ Preencher dados básicos do Zendesk

  • Subdomínio: Copie o trecho antes de .zendesk.com da URL do Zendesk
    Exemplo: https://empresa.zendesk.com → empresa

  • Usuário: Utilize o login da conta que será usada pela ClaudIA:

    • Pode ser uma conta dedicada

    • Ou a conta de um agente específico, de preferência, sem uso frequente

    • Mas com plano pago ativo

3️⃣ Criar Token de API no Zendesk

  1. Acesse Central de Administração

  2. Vá em API → Tokens

  3. Clique em Adicionar novo token

  4. Nomeie o token (exemplo: Cloud Humans | Connector)

  5. Salve e copie o token gerado

  6. Cole o token no campo correspondente no Hub

4️⃣ Criar grupos no Zendesk

Crie os grupos antes de avançar na integração.

Grupo da ClaudIA

  • Nome sugerido: Cloud Humans

  • Adicione a conta da ClaudIA ao grupo

  • Copie o ID do grupo pela URL

  • Cole no campo ID do Grupo da ClaudIA no Hub

Grupo de Transbordo (N2)

  • Nome sugerido: N2

  • Inclua os agentes de atendimento humano

  • Copie o ID do grupo

  • Cole no campo ID do Grupo N2

💡 Se o campo do grupo da ClaudIA ficar vazio, o sistema cria um grupo automaticamente. A recomendação é criar manualmente para maior controle.

5️⃣ Criar Integração de Conversas no Zendesk

  1. No Zendesk, no campo de busca, digite API

  2. Acesse Integrações > Integrações da conversa

  3. Clique em Criar integração

  4. Defina um nome (exemplo: Cloud Humans | Connector)

  5. No Hub, gere o Webhook

  6. Copie o webhook e cole no campo Endpoint

  7. Marque apenas: ✅ Mensagem de conversa

  8. Método: POST

  9. Salve e avance

6️⃣ Criar chaves da API (Sunshine)

  1. Dentro da integração criada, acesse Chaves da API

  2. Crie uma nova chave

  3. Defina um nome (exemplo: Cloud Humans | Integration)

  4. Copie e cole no Hub, na seguinte ordem:

    • ID do aplicativo

    • ID da chave

    • Chave secreta

  5. Salve a integração no Hub

⚠️ Um erro visual pode aparecer após salvar. Isso é esperado quando os grupos são configurados manualmente e não afeta o funcionamento.

❗Observação final