Principal Integrações com Helpdesks [Zendesk] Passo a passo integração e-mail

[Zendesk] Passo a passo integração e-mail

Última atualização em Jan 09, 2026

⭐ Resumo

Este artigo explica como configurar a integração de e-mail no Zendesk, incluindo autenticação via API, criação de grupos, definição de responsáveis e ajustes de gatilhos para funcionamento correto da ClaudIA e do transbordo para N2.

📝 Visão geral da integração

A integração de conversas conecta o Cloud Hub ao Zendesk para centralizar atendimentos de E-mail, Formulário Web e Serviços de API, possibilitando:

  • Atendimento automatizado pela ClaudIA

  • 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

Passo a passo da integração

📸 https://www.loom.com/share/59e58a8b6c5d4b529322247345f372aa

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. Confirme se está selecionada a opção E-mail

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 E-mail)

  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️⃣ Validar criação de gatilhos

Após salvar a integração:

  1. Acesse Configurações > Gatilhos no Zendesk.

  2. Verifique se os gatilhos foram criados:

    • Atribuição automática para a ClaudIA

    • Evento do Webhook